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

{{% 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 {#command-flags}

{{% caption %}} Also see influxd-ctl global flags. {{% /caption %}}

Examples

• Remove nodes from a cluster
• 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.

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