content/enterprise_influxdb/v1/tools/influxd-ctl/remove-meta.md
The influxd-ctl remove-meta command removes a meta node from an InfluxDB
Enterprise cluster.
By default, the local meta node is used to remove the specified node.
If -bind is specified, the bound address will be used.
To force-remove a meta node, bind to an existing meta node and include the the
-tcpAddr and -force flags along with the meta node's HTTP bind address.
Force removing a meta node should only be used if the meta node is no longer
reachable and is unrecoverable.
If the node is restarted after being force removed, it may interfere with the cluster.
{{% warn %}}
influxd-ctl remove-meta erases all metadata in the specified meta node.
Only use this command if you want to permanently remove a meta node from your
InfluxDB Enterprise cluster.
{{% /warn %}}
This command doesn't delete metadata related to the removed meta node from other
nodes in the cluster. To remove all metadata about the removed meta node, use
influxd-ctl leave.
influxd-ctl remove-meta [flags] <meta-http-bind-addr>
| Flag | Description |
|---|---|
-force | Force the removal of a meta node (useful if the node is unresponsive) |
-tcpAddr | TCP bind address of the meta node to remove |
-y | Assume yes to all prompts |
{{% caption %}}
Also see influxd-ctl global flags.
{{% /caption %}}
influxd-ctl remove-meta localhost:8091
influxd-ctl remove-meta meta2:8091
In the following example, the influxd-ctl remove-data command forcefully
removes the meta node running at the TCP address meta2:8089 and HTTP address
meta2:8091 from the cluster.
influxd-ctl remove-meta -force -tcpAddr meta2:8089 meta2:8091
In the following example, the influxd-ctl remove-data command uses the meta
node at meta1:8091 to forcefully remove the meta node running at the TCP
address meta2:8089 and HTTP address meta2:8091 from the cluster.
influxd-ctl -bind meta1:8091 remove-meta -force -tcpAddr meta2:8089 meta2:8091