97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
---
|
|
title: influxd-ctl remove-meta
|
|
description: >
|
|
The `influxd-ctl remove-meta` command removes a meta node from an InfluxDB
|
|
Enterprise cluster.
|
|
menu:
|
|
enterprise_influxdb_v1:
|
|
parent: influxd-ctl
|
|
weight: 201
|
|
related:
|
|
- /enterprise_influxdb/v1/tools/influxd-ctl/leave/
|
|
---
|
|
|
|
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 %}}
|
|
#### This command is destructive
|
|
|
|
`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`](/enterprise_influxdb/v1/tools/influxd-ctl/leave/)._
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
influxd-ctl remove-meta [flags] <meta-http-bind-addr>
|
|
```
|
|
|
|
## Arguments
|
|
|
|
- **meta-http-bind-addr**: HTTP bind address of the meta node to remove
|
|
|
|
## Flags {#command-flags}
|
|
|
|
| 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](/enterprise_influxdb/v1/tools/influxd-ctl/#influxd-ctl-global-flags)._
|
|
{{% /caption %}}
|
|
|
|
## Examples
|
|
|
|
- [Remove the local meta node running on :8091](#remove-the-local-meta-node-running-on-8091)
|
|
- [Remove the meta node running on meta2:8091](#remove-the-meta-node-running-on-meta28091)
|
|
- [Forcefully remove an unresponsive meta node from the local meta node](#forcefully-remove-an-unresponsive-meta-node-from-the-local-meta-node)
|
|
- [Forcefully remove an unresponsive meta node through a remote meta node](#forcefully-remove-an-unresponsive-meta-node-through-a-remote-meta-node)
|
|
|
|
### Remove the local meta node running on :8091
|
|
|
|
```sh
|
|
influxd-ctl remove-meta localhost:8091
|
|
```
|
|
|
|
### Remove the meta node running on meta2:8091
|
|
|
|
```sh
|
|
influxd-ctl remove-meta meta2:8091
|
|
```
|
|
|
|
### Forcefully remove an unresponsive meta node from the local meta node
|
|
|
|
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.
|
|
|
|
```sh
|
|
influxd-ctl remove-meta -force -tcpAddr meta2:8089 meta2:8091
|
|
```
|
|
|
|
### Forcefully remove an unresponsive meta node through a remote meta node
|
|
|
|
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.
|
|
|
|
```sh
|
|
influxd-ctl -bind meta1:8091 remove-meta -force -tcpAddr meta2:8089 meta2:8091
|
|
```
|