mirror of https://github.com/hashicorp/consul
63 lines
2.3 KiB
Plaintext
63 lines
2.3 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: Force Leave"
|
|
sidebar_current: "docs-commands-forceleave"
|
|
description: |-
|
|
The `force-leave` command forces a member of a Consul cluster to enter the left state. If the member is still actually alive, it will eventually rejoin the cluster. The true purpose of this method is to force remove failed nodes.
|
|
---
|
|
|
|
# Consul Force Leave
|
|
|
|
Command: `consul force-leave`
|
|
|
|
The `force-leave` command forces a member of a Consul cluster to enter the
|
|
"left" state. The purpose of this method is to force-remove a node that has failed or
|
|
was shutdown without a [graceful leave](https://www.consul.io/docs/commands/leave.html).
|
|
|
|
Consul periodically tries to reconnect to "failed" nodes in case failure was due
|
|
to a network partition. After some configured amount of time (by default 72 hours),
|
|
Consul will reap "failed" nodes and stop trying to reconnect. The `force-leave`
|
|
command can be used to transition the "failed" nodes to a "left" state more
|
|
quickly, as reported by [`consul members`](https://www.consul.io/docs/commands/members.html).
|
|
|
|
This can be particularly useful for a node that was running as a server,
|
|
as it will eventually be removed from the Raft configuration by the leader.
|
|
|
|
~> Note that for `force-leave` to take full effect the target node's agent must have
|
|
shutdown permanently. If the agent is alive and reachable then it will not be removed
|
|
from the datacenter's member list nor from the raft configuration. Additionally,
|
|
if the agent returns after transitioning to the "left" state, but before it is reaped
|
|
from the member list, then it will rejoin the cluster.
|
|
|
|
## Usage
|
|
|
|
Usage: `consul force-leave [options] node`
|
|
|
|
#### API Options
|
|
|
|
<%= partial "docs/commands/http_api_options_client" %>
|
|
|
|
## Examples
|
|
|
|
Remove a node named `ec2-001-staging` from the local agent's datacenter:
|
|
|
|
```
|
|
consul force-leave ec2-001-staging
|
|
```
|
|
|
|
When run on a server that is part of a
|
|
[WAN gossip pool](https://learn.hashicorp.com/consul/security-networking/datacenters),
|
|
`force-leave` can remove failed servers in other datacenters from the WAN pool.
|
|
|
|
The identifying node-name in a WAN pool is `[node-name].[datacenter]`.
|
|
Therefore, to remove a failed server node named `server1` from
|
|
datacenter `us-east1`, run:
|
|
|
|
```
|
|
consul force-leave server1.us-east1
|
|
```
|
|
#### Command Options
|
|
|
|
* `-prune` - Removes failed or left agent from the list of
|
|
members entirely
|