influxd-ctl leave
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
If the InfluxDB data or meta processes are running on non-default ports, the leave operation cannot detect them.
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.
Usage
influxd-ctl leave [flags]
Flags
| Flag | Description |
|---|---|
-y | Assume yes to all prompts |
Also see influxd-ctl global flags.
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
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.