@@ -182,7 +182,7 @@ list using the following API:
182182[source,js]
183183--------------------------------------------------
184184# Add node to voting configuration exclusions list and wait for the system to
185- # auto-reconfigure the node from the voting configuration up to the default
185+ # auto-reconfigure the node out of the voting configuration up to the default
186186# timeout of 30 seconds
187187POST /_cluster/voting_config_exclusions/node_name
188188# Add node to voting configuration exclusions list and wait for
@@ -191,13 +191,13 @@ POST /_cluster/voting_config_exclusions/node_name?timeout=1m
191191--------------------------------------------------
192192// CONSOLE
193193
194- The node who should be excluded from the voting configuration is specified
195- using <<cluster-nodes,node filters>> in place of `node_name` here. If a call
196- to the voting config exclusions API fails then the call can safely be retried.
194+ The node who should be added to the exclusions list is specified using
195+ <<cluster-nodes,node filters>> in place of `node_name` here. If a call to the
196+ voting configuration exclusions API fails then the call can safely be retried.
197197A successful response guarantees that the node has been removed from the voting
198198configuration and will not be reinstated.
199199
200- Although the vote configuration exclusions API is most useful for down-scaling
200+ Although the voting configuration exclusions API is most useful for down-scaling
201201a two-node to a one-node cluster, it is also possible to use it to remove multiple
202202nodes from larger clusters all at the same time. Adding multiple nodes to the
203203exclusions list has the system try to auto-reconfigure all of these nodes from
@@ -206,8 +206,9 @@ cluster available. In the example described above, shrinking a seven-master-node
206206cluster down to only have three master nodes, you could add four nodes to the
207207exclusions list, wait for confirmation, and then shut them down simultaneously.
208208
209- Excluding a node from the voting configuration creates an entry for that node
210- in the voting configuration exclusions list, which prevents it from returning
209+ Adding an exclusion for a node creates an entry for that node in the voting
210+ configuration exclusions list, which has the system automatically try to reconfigure
211+ the voting configuration to remove that node and prevents it from returning
211212to the voting configuration once it has removed. The current set of exclusions
212213is stored in the cluster state and can be inspected as follows:
213214
@@ -221,8 +222,8 @@ This list is limited in size by the following setting:
221222
222223`cluster.max_voting_config_exclusions`::
223224
224- Sets a limits on the number of voting config exclusions at any one time. Defaults
225- to `10`.
225+ Sets a limits on the number of voting configuration exclusions at any one time.
226+ Defaults to `10`.
226227
227228Since voting configuration exclusions are persistent and limited in number, they
228229must be cleaned up. Normally an exclusion is added when performing some maintenance on
@@ -236,12 +237,12 @@ only required temporarily:
236237
237238[source,js]
238239--------------------------------------------------
239- # Wait for all the nodes with voting config exclusions to be removed from the cluster
240- # and then remove all the exclusions, allowing any node to return to the
241- # voting configuration in future.
240+ # Wait for all the nodes with voting configuration exclusions to be removed from the
241+ # cluster and then remove all the exclusions, allowing any node to return to the
242+ # voting configuration in the future.
242243DELETE /_cluster/voting_config_exclusions
243- # Immediately remove all the voting config exclusions, allowing any node to return to
244- # the voting configuration in future.
244+ # Immediately remove all the voting configuration exclusions, allowing any node to
245+ # return to the voting configuration in the future.
245246DELETE /_cluster/voting_config_exclusions?wait_for_removal=false
246247--------------------------------------------------
247248// CONSOLE
0 commit comments