3.0 KiB
| title | description | menu | weight | related | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| influxd-ctl leave | The `influxd-ctl leave` command removes a meta or data node from an InfluxDB Enterprise cluster. |
|
201 |
|
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
influxd-ctl leave [flags]
Flags
| Flag | Description |
|---|---|
-y |
Assume yes to all prompts |
{{% caption %}}
Also see influxd-ctl global flags.
{{% /caption %}}
Examples
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.
influxd-ctl leave
Command output and interactive prompts
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:
influxd-ctl leave -y
Command output
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