From 48e7fb1bfe7a5ddc31dc418528c9a428482e04c6 Mon Sep 17 00:00:00 2001 From: hc-github-team-consul-core Date: Fri, 30 Jun 2023 10:28:58 -0500 Subject: [PATCH] Backport of update doc into release/1.16.x (#17976) * backport of commit 91c82db42b95f66f7edc75a668a3ebd44338e74f * backport of commit 4be71ab9413232c1ccd537c66011bb529af65d34 --------- Co-authored-by: Xinyi Wang --- website/content/commands/leave.mdx | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/website/content/commands/leave.mdx b/website/content/commands/leave.mdx index 3dccedc7c..8c3744cc2 100644 --- a/website/content/commands/leave.mdx +++ b/website/content/commands/leave.mdx @@ -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)