Skip to content

Commit

Permalink
Backport of update doc into release/1.16.x (#17976)
Browse files Browse the repository at this point in the history
* backport of commit 91c82db

* backport of commit 4be71ab

---------

Co-authored-by: Xinyi Wang <xinyi.wang@hashicorp.com>
  • Loading branch information
hc-github-team-consul-core and wangxinyi7 authored Jun 30, 2023
1 parent 90ff41f commit b910303
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions website/content/commands/leave.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,13 @@ For nodes in server mode, the node is removed from the Raft peer set
in a graceful manner. This is critical, as in certain situations a
non-graceful leave can affect cluster availability.

Running `consul leave` on a server explicitly will reduce the quorum size. Even if the cluster used `bootstrap_expect` to set a quorum size initially, issuing `consul leave` on a server will reconfigure the cluster to have fewer servers.
This means you could end up with just one server that is still able to commit writes because quorum is only 1, but those writes might be lost if that server fails before more are added.
Depending on how many Consul servers are running, running `consul leave` on a server explicitly can reduce the quorum
size (which is derived from the number of Consul servers, see
[deployment_table](/consul/docs/architecture/consensus#deployment_table)).
Even if the cluster used `bootstrap_expect` to set a number of servers and thus quorum size initially,
issuing `consul leave` on a server will reconfigure the cluster to have fewer servers.
This means you could end up with just one server that is still able to commit writes because the quorum size for
1-server setup is only 1, but those writes might be lost if that server fails before more are added.

The table below shows this command's [required ACLs](/consul/api-docs/api-structure#authentication). Configuration of
[blocking queries](/consul/api-docs/features/blocking) and [agent caching](/consul/api-docs/features/caching)
Expand Down

0 comments on commit b910303

Please sign in to comment.