107 lines
3.0 KiB
Markdown
107 lines
3.0 KiB
Markdown
|
---
|
||
|
|
title: influxd-ctl leave
|
||
|
|
description: >
|
||
|
|
The `influxd-ctl leave` command removes a meta or data node from an InfluxDB
|
||
|
|
Enterprise cluster.
|
||
|
|
menu:
|
||
|
|
enterprise_influxdb_v1:
|
||
|
|
parent: influxd-ctl
|
||
|
|
weight: 201
|
||
|
|
related:
|
||
|
|
- /enterprise_influxdb/v1/tools/influxd-ctl/join/
|
||
|
|
- /enterprise_influxdb/v1/tools/influxd-ctl/remove-data/
|
||
|
|
- /enterprise_influxdb/v1/tools/influxd-ctl/remove-meta/
|
||
|
|
---
|
||
|
|
|
||
|
|
The `influxd-ctl leave` command removes a meta or data node from an InfluxDB
|
||
|
|
Enterprise cluster.
|
||
|
|
The command searches for `influxd` and `influxd-meta` processes running on the
|
||
|
|
local machine bound to specific ports and determines if that process is an
|
||
|
|
InfluxDB meta or data node.
|
||
|
|
|
||
|
|
- **8088**: Data node
|
||
|
|
- **8091**: Meta node
|
||
|
|
|
||
|
|
{{% note %}}
|
||
|
|
If the InfluxDB data or meta processes are running on non-default ports, the
|
||
|
|
leave operation cannot detect them.
|
||
|
|
{{% /note %}}
|
||
|
|
|
||
|
|
{{% warn %}}
|
||
|
|
#### This command is destructive
|
||
|
|
|
||
|
|
`influxd-ctl leave` erases all metastore information from meta nodes and all
|
||
|
|
data from data nodes.
|
||
|
|
Only use this command if you want to _permanently_ remove a node from your
|
||
|
|
InfluxDB Enterprise cluster.
|
||
|
|
{{% /warn %}}
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```sh
|
||
|
|
influxd-ctl leave [flags]
|
||
|
|
```
|
||
|
|
|
||
|
|
## Flags {#command-flags}
|
||
|
|
|
||
|
|
| Flag | Description |
|
||
|
|
| :--- | :-------------------------- |
|
||
|
|
| `-y` | Assume `yes` to all prompts |
|
||
|
|
|
||
|
|
{{% caption %}}
|
||
|
|
_Also see [`influxd-ctl` global flags](/enterprise_influxdb/v1/tools/influxd-ctl/#influxd-ctl-global-flags)._
|
||
|
|
{{% /caption %}}
|
||
|
|
|
||
|
|
## Examples
|
||
|
|
|
||
|
|
- [Remove nodes from a cluster](#remove-nodes-from-a-cluster)
|
||
|
|
- [Remove nodes from a cluster and assume yes to all prompts](#remove-nodes-from-a-cluster-and-assume-yes-to-all-prompts)
|
||
|
|
|
||
|
|
### Remove nodes from a cluster
|
||
|
|
|
||
|
|
In the following example, `influxd-ctl leave` detects the meta node running at
|
||
|
|
`cluster-node-03:8091` and the data node running at `cluster-node-03:8088` in
|
||
|
|
an existing InfluxDB Enterprise cluster and prompts the user to remove them.
|
||
|
|
|
||
|
|
```bash
|
||
|
|
influxd-ctl leave
|
||
|
|
```
|
||
|
|
|
||
|
|
###### Command output and interactive prompts
|
||
|
|
|
||
|
|
```txt
|
||
|
|
Searching for data node on cluster-node-03:8088...
|
||
|
|
Remove data node cluster-node-03:8088 from the cluster [y/N]: y
|
||
|
|
Removed cluster-node-03:8088 from the cluster
|
||
|
|
Searching for meta node on cluster-node-03:8091...
|
||
|
|
Remove meta node cluster-node-03:8091 from the cluster [y/N]: y
|
||
|
|
|
||
|
|
Successfully left cluster
|
||
|
|
|
||
|
|
* Removed data node cluster-node-03:8088 from cluster
|
||
|
|
* Removed meta node cluster-node-03:8091 from cluster
|
||
|
|
```
|
||
|
|
|
||
|
|
### Remove nodes from a cluster and assume yes to all prompts
|
||
|
|
|
||
|
|
In the following example, `influxd-ctl leave` detects the meta node running at
|
||
|
|
`cluster-node-03:8091` and the data node running at `cluster-node-03:8088` in an
|
||
|
|
existing InfluxDB Enterprise cluster and then, without prompting for input, removes them from the cluster:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
influxd-ctl leave -y
|
||
|
|
```
|
||
|
|
|
||
|
|
###### Command output
|
||
|
|
|
||
|
|
```txt
|
||
|
|
Searching for data node on cluster-node-03:8088...
|
||
|
|
Removed cluster-node-03:8088 from the cluster
|
||
|
|
Searching for meta node on cluster-node-03:8091...
|
||
|
|
|
||
|
|
Successfully left cluster
|
||
|
|
|
||
|
|
* Removed data node cluster-node-03:8088 from cluster
|
||
|
|
* Removed meta node cluster-node-03:8091 from cluster
|
||
|
|
```
|