Browse Source

doc: add note for reconfiguration

Xiang Li 11 years ago
parent
commit
bc6f062008
1 changed files with 4 additions and 0 deletions
  1. 4 0
      Documentation/2.0/runtime-configuration.md

+ 4 - 0
Documentation/2.0/runtime-configuration.md

@@ -2,6 +2,10 @@
 
 
 etcd comes with support for incremental runtime reconfiguration, which allows users to update the membership of the cluster at run time.
 etcd comes with support for incremental runtime reconfiguration, which allows users to update the membership of the cluster at run time.
 
 
+Reconfiguration requests can only be processed when the the majority of the cluster members are functioning. It is **highly recommended** to always have a cluster size greater than two in production. It is unsafe to remove a member from a two member cluster. The majority of a two member cluster is also two. If there is a failure during the removal process, the cluster might not able to make progress and need to [restart from majority failure][majority failure].
+
+[majority failure]: #restart-cluster-from-majority-failure
+
 ## Reconfiguration Use Cases
 ## Reconfiguration Use Cases
 
 
 Let us walk through the four use cases for re-configuring a cluster: replacing a member, increasing or decreasing cluster size, and restarting a cluster from a majority failure.
 Let us walk through the four use cases for re-configuring a cluster: replacing a member, increasing or decreasing cluster size, and restarting a cluster from a majority failure.