ZOOKEEPER-2865: Reconfig Causes Inconsistent Configuration file among…

… the nodes

Author: Alexander Shraer <ashraer@apple.com>

Reviewers: Michael Han <hanm@apache.org>

Closes #328 from shralex/ZOOKEEPER-2865

docs/zookeeperReconfig.html

@@ -855,6 +855,10 @@ zk.getConfig(watcher, callback, context);</pre>
         
 </div>
 </div>
+<p>If the configuration of existing servers changes or they become unavailable
+          before the joiner succeeds to connect and learn obout configuration changes, the
+          joiner may need to be restarted with an updated configuration file in order to be
+          able to connect.</p>
 <p>Finally, note that once connected to the leader, a joiner adopts
           the last committed configuration, in which it is absent (the initial
           config of the joiner is backed up before being rewritten). If the

src/docs/src/documentation/content/xdocs/zookeeperReconfig.xml

@@ -550,6 +550,10 @@ zk.getConfig(watcher, callback, context);</programlisting>
             independently from your main ensemble. It is OK to list multiple
             joiners as observers in an initial config.</para>
         </note>
+        <para>If the configuration of existing servers changes or they become unavailable
+          before the joiner succeeds to connect and learn obout configuration changes, the
+          joiner may need to be restarted with an updated configuration file in order to be
+          able to connect.</para>
         <para>Finally, note that once connected to the leader, a joiner adopts
           the last committed configuration, in which it is absent (the initial
           config of the joiner is backed up before being rewritten). If the