You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@zookeeper.apache.org by ph...@apache.org on 2016/03/20 05:30:06 UTC
svn commit: r1735838 - in /zookeeper/branches/branch-3.4: ./ docs/
src/docs/src/documentation/content/xdocs/
Author: phunt
Date: Sun Mar 20 04:30:05 2016
New Revision: 1735838
URL: http://svn.apache.org/viewvc?rev=1735838&view=rev
Log:
ZOOKEEPER-2240 Make the three-node minimum more explicit in documentation and on website (Shawn Heisey and Arshad Mohammad via phunt)
Modified:
zookeeper/branches/branch-3.4/CHANGES.txt
zookeeper/branches/branch-3.4/docs/bookkeeperConfig.pdf
zookeeper/branches/branch-3.4/docs/bookkeeperOverview.pdf
zookeeper/branches/branch-3.4/docs/bookkeeperProgrammer.pdf
zookeeper/branches/branch-3.4/docs/bookkeeperStarted.pdf
zookeeper/branches/branch-3.4/docs/bookkeeperStream.pdf
zookeeper/branches/branch-3.4/docs/index.pdf
zookeeper/branches/branch-3.4/docs/javaExample.pdf
zookeeper/branches/branch-3.4/docs/linkmap.pdf
zookeeper/branches/branch-3.4/docs/recipes.pdf
zookeeper/branches/branch-3.4/docs/releasenotes.pdf
zookeeper/branches/branch-3.4/docs/zookeeperAdmin.html
zookeeper/branches/branch-3.4/docs/zookeeperAdmin.pdf
zookeeper/branches/branch-3.4/docs/zookeeperHierarchicalQuorums.pdf
zookeeper/branches/branch-3.4/docs/zookeeperInternals.pdf
zookeeper/branches/branch-3.4/docs/zookeeperJMX.pdf
zookeeper/branches/branch-3.4/docs/zookeeperObservers.pdf
zookeeper/branches/branch-3.4/docs/zookeeperOver.pdf
zookeeper/branches/branch-3.4/docs/zookeeperProgrammers.pdf
zookeeper/branches/branch-3.4/docs/zookeeperQuotas.pdf
zookeeper/branches/branch-3.4/docs/zookeeperStarted.html
zookeeper/branches/branch-3.4/docs/zookeeperStarted.pdf
zookeeper/branches/branch-3.4/docs/zookeeperTutorial.pdf
zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml
zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperStarted.xml
Modified: zookeeper/branches/branch-3.4/CHANGES.txt
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/CHANGES.txt?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
--- zookeeper/branches/branch-3.4/CHANGES.txt (original)
+++ zookeeper/branches/branch-3.4/CHANGES.txt Sun Mar 20 04:30:05 2016
@@ -24,6 +24,12 @@ BUGFIXES:
ZOOKEEPER-2385 Zookeeper trunk build is failing on windows
(Arshad Mohammad via phunt)
+IMPROVEMENTS:
+
+ ZOOKEEPER-2240 Make the three-node minimum more explicit in
+ documentation and on website (Shawn Heisey and Arshad Mohammad via phunt)
+
+
Release 3.4.8 - 2016-02-05
Backward compatible changes:
Modified: zookeeper/branches/branch-3.4/docs/bookkeeperConfig.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/bookkeeperConfig.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/bookkeeperConfig.pdf (original) and zookeeper/branches/branch-3.4/docs/bookkeeperConfig.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/bookkeeperOverview.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/bookkeeperOverview.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/bookkeeperOverview.pdf (original) and zookeeper/branches/branch-3.4/docs/bookkeeperOverview.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/bookkeeperProgrammer.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/bookkeeperProgrammer.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/bookkeeperProgrammer.pdf (original) and zookeeper/branches/branch-3.4/docs/bookkeeperProgrammer.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/bookkeeperStarted.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/bookkeeperStarted.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/bookkeeperStarted.pdf (original) and zookeeper/branches/branch-3.4/docs/bookkeeperStarted.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/bookkeeperStream.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/bookkeeperStream.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/bookkeeperStream.pdf (original) and zookeeper/branches/branch-3.4/docs/bookkeeperStream.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/index.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/index.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/javaExample.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/javaExample.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/linkmap.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/linkmap.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/recipes.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/recipes.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/releasenotes.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/releasenotes.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/zookeeperAdmin.html
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperAdmin.html?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
--- zookeeper/branches/branch-3.4/docs/zookeeperAdmin.html (original)
+++ zookeeper/branches/branch-3.4/docs/zookeeperAdmin.html Sun Mar 20 04:30:05 2016
@@ -513,6 +513,35 @@ document.write("Last Published: " + docu
only handle the failure of a single machine; if two machines fail, the
remaining two machines do not constitute a majority. However, with five
machines ZooKeeper can handle the failure of two machines. </p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+
+<p>
+ As mentioned in the
+ <a href="zookeeperStarted.html">ZooKeeper Getting Started Guide</a>
+ , a minimum of three servers are required for a fault tolerant
+ clustered setup, and it is strongly recommended that you have an
+ odd number of servers.
+ </p>
+
+<p>Usually three servers is more than enough for a production
+ install, but for maximum reliability during maintenance, you may
+ wish to install five servers. With three servers, if you perform
+ maintenance on one of them, you are vulnerable to a failure on one
+ of the other two servers during that maintenance. If you have five
+ of them running, you can take one down for maintenance, and know
+ that you're still OK if one of the other four suddenly fails.
+ </p>
+
+<p>Your redundancy considerations should include all aspects of
+ your environment. If you have three ZooKeeper servers, but their
+ network cables are all plugged into the same network switch, then
+ the failure of that switch will take down your entire ensemble.
+ </p>
+
+</div>
+</div>
<p>Here are the steps to setting a server that will be part of an
ensemble. These steps should be performed on every host in the
ensemble:</p>
Modified: zookeeper/branches/branch-3.4/docs/zookeeperAdmin.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperAdmin.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/zookeeperHierarchicalQuorums.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperHierarchicalQuorums.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/zookeeperHierarchicalQuorums.pdf (original) and zookeeper/branches/branch-3.4/docs/zookeeperHierarchicalQuorums.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/zookeeperInternals.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperInternals.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/zookeeperJMX.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperJMX.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/zookeeperJMX.pdf (original) and zookeeper/branches/branch-3.4/docs/zookeeperJMX.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/zookeeperObservers.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperObservers.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/zookeeperObservers.pdf (original) and zookeeper/branches/branch-3.4/docs/zookeeperObservers.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/zookeeperOver.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperOver.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/zookeeperProgrammers.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperProgrammers.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/zookeeperQuotas.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperQuotas.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files zookeeper/branches/branch-3.4/docs/zookeeperQuotas.pdf (original) and zookeeper/branches/branch-3.4/docs/zookeeperQuotas.pdf Sun Mar 20 04:30:05 2016 differ
Modified: zookeeper/branches/branch-3.4/docs/zookeeperStarted.html
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperStarted.html?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
--- zookeeper/branches/branch-3.4/docs/zookeeperStarted.html (original)
+++ zookeeper/branches/branch-3.4/docs/zookeeperStarted.html Sun Mar 20 04:30:05 2016
@@ -533,8 +533,30 @@ numChildren = 0
ZooKeeper in replicated mode. A replicated group of servers in the same
application is called a <em>quorum</em>, and in replicated
mode, all servers in the quorum have copies of the same configuration
- file. The file is similar to the one used in standalone mode, but with a
- few differences. Here is an example:</p>
+ file.</p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">
+
+<p>
+ For replicated mode, a minimum of three servers are required,
+ and it is strongly recommended that you have an odd number of
+ servers. If you only have two servers, then you are in a
+ situation where if one of them fails, there are not enough
+ machines to form a majority quorum. Two servers is inherently
+ <strong>less</strong>
+ stable than a single server, because there are two single
+ points of failure.
+ </p>
+
+</div>
+</div>
+<p>
+ The required
+ <strong>conf/zoo.cfg</strong>
+ file for replicated mode is similar to the one used in standalone
+ mode, but with a few differences. Here is an example:
+ </p>
<pre class="code">
tickTime=2000
dataDir=/var/lib/zookeeper
@@ -583,6 +605,14 @@ server.3=zoo3:2888:3888
(in the above replicated example, running on a
single <em>localhost</em>, you would still have
three config files).</p>
+
+<p>Please be aware that setting up multiple servers on a single
+ machine will not create any redundancy. If something were to
+ happen which caused the machine to die, all of the zookeeper
+ servers would be offline. Full redundancy requires that each
+ server have its own machine. It must be a completely separate
+ physical server. Multiple virtual machines on the same physical
+ host are still vulnerable to the complete failure of that host.</p>
</div>
</div>
Modified: zookeeper/branches/branch-3.4/docs/zookeeperStarted.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperStarted.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/docs/zookeeperTutorial.pdf
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/docs/zookeeperTutorial.pdf?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
--- zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml (original)
+++ zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml Sun Mar 20 04:30:05 2016
@@ -185,7 +185,28 @@
only handle the failure of a single machine; if two machines fail, the
remaining two machines do not constitute a majority. However, with five
machines ZooKeeper can handle the failure of two machines. </para>
-
+ <note>
+ <para>
+ As mentioned in the
+ <ulink url="zookeeperStarted.html">ZooKeeper Getting Started Guide</ulink>
+ , a minimum of three servers are required for a fault tolerant
+ clustered setup, and it is strongly recommended that you have an
+ odd number of servers.
+ </para>
+ <para>Usually three servers is more than enough for a production
+ install, but for maximum reliability during maintenance, you may
+ wish to install five servers. With three servers, if you perform
+ maintenance on one of them, you are vulnerable to a failure on one
+ of the other two servers during that maintenance. If you have five
+ of them running, you can take one down for maintenance, and know
+ that you're still OK if one of the other four suddenly fails.
+ </para>
+ <para>Your redundancy considerations should include all aspects of
+ your environment. If you have three ZooKeeper servers, but their
+ network cables are all plugged into the same network switch, then
+ the failure of that switch will take down your entire ensemble.
+ </para>
+ </note>
<para>Here are the steps to setting a server that will be part of an
ensemble. These steps should be performed on every host in the
ensemble:</para>
Modified: zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperStarted.xml
URL: http://svn.apache.org/viewvc/zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperStarted.xml?rev=1735838&r1=1735837&r2=1735838&view=diff
==============================================================================
--- zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperStarted.xml (original)
+++ zookeeper/branches/branch-3.4/src/docs/src/documentation/content/xdocs/zookeeperStarted.xml Sun Mar 20 04:30:05 2016
@@ -341,8 +341,25 @@ numChildren = 0
ZooKeeper in replicated mode. A replicated group of servers in the same
application is called a <emphasis>quorum</emphasis>, and in replicated
mode, all servers in the quorum have copies of the same configuration
- file. The file is similar to the one used in standalone mode, but with a
- few differences. Here is an example:</para>
+ file.</para>
+ <note>
+ <para>
+ For replicated mode, a minimum of three servers are required,
+ and it is strongly recommended that you have an odd number of
+ servers. If you only have two servers, then you are in a
+ situation where if one of them fails, there are not enough
+ machines to form a majority quorum. Two servers is inherently
+ <emphasis role="bold">less</emphasis>
+ stable than a single server, because there are two single
+ points of failure.
+ </para>
+ </note>
+ <para>
+ The required
+ <emphasis role="bold">conf/zoo.cfg</emphasis>
+ file for replicated mode is similar to the one used in standalone
+ mode, but with a few differences. Here is an example:
+ </para>
<programlisting>
tickTime=2000
@@ -395,6 +412,13 @@ server.3=zoo3:2888:3888
(in the above replicated example, running on a
single <emphasis>localhost</emphasis>, you would still have
three config files).</para>
+ <para>Please be aware that setting up multiple servers on a single
+ machine will not create any redundancy. If something were to
+ happen which caused the machine to die, all of the zookeeper
+ servers would be offline. Full redundancy requires that each
+ server have its own machine. It must be a completely separate
+ physical server. Multiple virtual machines on the same physical
+ host are still vulnerable to the complete failure of that host.</para>
</note>
</section>