Browse Source

Highlight `cluster.initial_master_nodes` removal after cluster formation (#60631)

Explicitly ask users to remove `cluster.initial_master_nodes` once the cluster
has formed for the first time.
Pius 5 years ago
parent
commit
a9afad0f18

+ 5 - 2
docs/reference/setup/important-settings/discovery-settings.asciidoc

@@ -42,8 +42,11 @@ themselves. As this auto-bootstrapping is <<modules-discovery-quorums,inherently
 unsafe>>, when you start a brand new cluster in <<dev-vs-prod-mode,production
 mode>>, you must explicitly list the master-eligible nodes whose votes should be
 counted in the very first election. This list is set using the
-`cluster.initial_master_nodes` setting. You should not use this setting when
-restarting a cluster or adding a new node to an existing cluster.
+`cluster.initial_master_nodes` setting. 
+
+NOTE: You should remove `cluster.initial_master_nodes` setting from the nodes' configuration
+*once the cluster has successfully formed for the first time*. Do not use this setting when
+restarting a cluster or adding a new node to an existing cluster.  
 
 [source,yaml]
 --------------------------------------------------