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 2014/07/03 05:57:20 UTC
svn commit: r1607524 - in /zookeeper/trunk: ./ docs/
src/docs/src/documentation/content/xdocs/
Author: phunt
Date: Thu Jul 3 03:57:19 2014
New Revision: 1607524
URL: http://svn.apache.org/r1607524
Log:
ZOOKEEPER-1918. Add 64 bit Windows as a supported development platform (Michi Mutsuzaki via phunt)
Modified:
zookeeper/trunk/CHANGES.txt
zookeeper/trunk/docs/index.pdf
zookeeper/trunk/docs/javaExample.pdf
zookeeper/trunk/docs/linkmap.pdf
zookeeper/trunk/docs/recipes.html
zookeeper/trunk/docs/recipes.pdf
zookeeper/trunk/docs/releasenotes.pdf
zookeeper/trunk/docs/zookeeperAdmin.html
zookeeper/trunk/docs/zookeeperAdmin.pdf
zookeeper/trunk/docs/zookeeperHierarchicalQuorums.pdf
zookeeper/trunk/docs/zookeeperInternals.pdf
zookeeper/trunk/docs/zookeeperJMX.pdf
zookeeper/trunk/docs/zookeeperObservers.pdf
zookeeper/trunk/docs/zookeeperOver.pdf
zookeeper/trunk/docs/zookeeperProgrammers.html
zookeeper/trunk/docs/zookeeperProgrammers.pdf
zookeeper/trunk/docs/zookeeperQuotas.pdf
zookeeper/trunk/docs/zookeeperStarted.html
zookeeper/trunk/docs/zookeeperStarted.pdf
zookeeper/trunk/docs/zookeeperTutorial.pdf
zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml
Modified: zookeeper/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/zookeeper/trunk/CHANGES.txt?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
--- zookeeper/trunk/CHANGES.txt (original)
+++ zookeeper/trunk/CHANGES.txt Thu Jul 3 03:57:19 2014
@@ -950,6 +950,9 @@ IMPROVEMENTS:
ZOOKEEPER-1576. Zookeeper cluster - failed to connect to cluster if one of the
provided IPs causes java.net.UnknownHostException (Edward Ribeiro via camille)
+ ZOOKEEPER-1918. Add 64 bit Windows as a supported development
+ platform (Michi Mutsuzaki via phunt)
+
headers
Release 3.4.0 -
Modified: zookeeper/trunk/docs/index.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/index.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/javaExample.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/javaExample.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/linkmap.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/linkmap.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/recipes.html
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/recipes.html?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
--- zookeeper/trunk/docs/recipes.html (original)
+++ zookeeper/trunk/docs/recipes.html Thu Jul 3 03:57:19 2014
@@ -227,7 +227,7 @@ document.write("Last Published: " + docu
<a href="#Shared+Locks">Shared Locks</a>
</li>
<li>
-<a href="#sc_recoverableSharedLocks">Recoverable Shared Locks</a>
+<a href="#sc_revocableSharedLocks">Revocable Shared Locks</a>
</li>
</ul>
</li>
@@ -830,8 +830,8 @@ document.write("Last Published: " + docu
</li>
</ul>
-<a name="sc_recoverableSharedLocks"></a>
-<h4>Recoverable Shared Locks</h4>
+<a name="sc_revocableSharedLocks"></a>
+<h4>Revocable Shared Locks</h4>
<p>With minor modifications to the Shared Lock protocol, you make
shared locks revocable by modifying the shared lock protocol:</p>
<p>In step <strong>1</strong>, of both obtain reader
@@ -891,7 +891,7 @@ document.write("Last Published: " + docu
znodes that represent "proposals" of clients. The idea is to have a znode,
say "/election", such that each znode creates a child znode "/election/guid-n_"
with both flags SEQUENCE|EPHEMERAL. With the sequence flag, ZooKeeper
- automatically appends a sequence number that is greater that any one
+ automatically appends a sequence number that is greater than any one
previously appended to a child of "/election". The process that created
the znode with the smallest appended sequence number is the leader.
</p>
Modified: zookeeper/trunk/docs/recipes.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/recipes.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/releasenotes.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/releasenotes.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/zookeeperAdmin.html
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperAdmin.html?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
--- zookeeper/trunk/docs/zookeeperAdmin.html (original)
+++ zookeeper/trunk/docs/zookeeperAdmin.html Thu Jul 3 03:57:19 2014
@@ -402,6 +402,13 @@ document.write("Last Published: " + docu
<li>
+<p>Win64 is supported as a <em>development
+ platform</em> only for both server and client.</p>
+
+</li>
+
+<li>
+
<p>MacOSX is supported as a <em>development
platform</em> only for both server and client.</p>
@@ -1358,6 +1365,24 @@ server.3=zoo3:2888:3888</pre>
</div>
</div>
</dd>
+
+
+<dt>
+<term>standaloneEnabled</term>
+</dt>
+<dd>
+<p>(No Java system property)</p>
+<p>
+<strong>New in 3.5.0:</strong>
+ When set to false, a single server can be started in replicated
+ mode, a lone participant can run with observers, and a cluster
+ can reconfigure down to one node, and up from one node. The
+ default is true for backwards compatibility. It can be set
+ using QuorumPeerConfig's setStandaloneEnabled method or by
+ adding "standaloneEnabled=false" or "standaloneEnabled=true"
+ to a server's config file.
+ </p>
+</dd>
</dl>
<p></p>
Modified: zookeeper/trunk/docs/zookeeperAdmin.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperAdmin.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/zookeeperHierarchicalQuorums.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperHierarchicalQuorums.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Files zookeeper/trunk/docs/zookeeperHierarchicalQuorums.pdf (original) and zookeeper/trunk/docs/zookeeperHierarchicalQuorums.pdf Thu Jul 3 03:57:19 2014 differ
Modified: zookeeper/trunk/docs/zookeeperInternals.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperInternals.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/zookeeperJMX.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperJMX.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Files zookeeper/trunk/docs/zookeeperJMX.pdf (original) and zookeeper/trunk/docs/zookeeperJMX.pdf Thu Jul 3 03:57:19 2014 differ
Modified: zookeeper/trunk/docs/zookeeperObservers.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperObservers.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Files zookeeper/trunk/docs/zookeeperObservers.pdf (original) and zookeeper/trunk/docs/zookeeperObservers.pdf Thu Jul 3 03:57:19 2014 differ
Modified: zookeeper/trunk/docs/zookeeperOver.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperOver.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/zookeeperProgrammers.html
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperProgrammers.html?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
--- zookeeper/trunk/docs/zookeeperProgrammers.html (original)
+++ zookeeper/trunk/docs/zookeeperProgrammers.html Thu Jul 3 03:57:19 2014
@@ -230,6 +230,12 @@ document.write("Last Published: " + docu
<a href="#ch_zkWatches">ZooKeeper Watches</a>
<ul class="minitoc">
<li>
+<a href="#sc_WatchSemantics">Semantics of Watches</a>
+</li>
+<li>
+<a href="#sc_WatchRemoval">Remove Watches</a>
+</li>
+<li>
<a href="#sc_WatchGuarantees">What ZooKeeper Guarantees about Watches</a>
</li>
<li>
@@ -452,8 +458,7 @@ document.write("Last Published: " + docu
<li>
<p>The following characters are not allowed: \ud800 - uF8FF,
- \uFFF0 - uFFFF, \uXFFFE - \uXFFFF (where X is a digit 1 - E), \uF0000 -
- \uFFFFF.</p>
+ \uFFF0 - uFFFF.</p>
</li>
@@ -1055,6 +1060,90 @@ document.write("Last Published: " + docu
general this all occurs transparently. There is one case where a watch
may be missed: a watch for the existence of a znode not yet created will
be missed if the znode is created and deleted while disconnected.</p>
+<a name="sc_WatchSemantics"></a>
+<h3 class="h4">Semantics of Watches</h3>
+<p> We can set watches with the three calls that read the state of
+ ZooKeeper: exists, getData, and getChildren. The following list details
+ the events that a watch can trigger and the calls that enable them:
+ </p>
+<ul>
+
+<li>
+
+<p>
+<strong>Created event:</strong>
+</p>
+
+<p>Enabled with a call to exists.</p>
+
+</li>
+
+
+<li>
+
+<p>
+<strong>Deleted event:</strong>
+</p>
+
+<p>Enabled with a call to exists, getData, and getChildren.</p>
+
+</li>
+
+
+<li>
+
+<p>
+<strong>Changed event:</strong>
+</p>
+
+<p>Enabled with a call to exists and getData.</p>
+
+</li>
+
+
+<li>
+
+<p>
+<strong>Child event:</strong>
+</p>
+
+<p>Enabled with a call to getChildren.</p>
+
+</li>
+
+</ul>
+<a name="sc_WatchRemoval"></a>
+<h3 class="h4">Remove Watches</h3>
+<p>We can remove the watches registered on a znode with a call to
+ removeWatches. Also, a ZooKeeper client can remove watches locally even
+ if there is no server connection by setting the local flag to true. The
+ following list details the events which will be triggered after the
+ successful watch removal.
+ </p>
+<ul>
+
+<li>
+
+<p>
+<strong>Child Remove event:</strong>
+</p>
+
+<p>Watcher which was added with a call to getChildren.</p>
+
+</li>
+
+
+<li>
+
+<p>
+<strong>Data Remove event:</strong>
+</p>
+
+<p>Watcher which was added with a call to exists or getData.</p>
+
+</li>
+
+</ul>
<a name="sc_WatchGuarantees"></a>
<h3 class="h4">What ZooKeeper Guarantees about Watches</h3>
<p>With regard to watches, ZooKeeper maintains these
Modified: zookeeper/trunk/docs/zookeeperProgrammers.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperProgrammers.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/zookeeperQuotas.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperQuotas.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Files zookeeper/trunk/docs/zookeeperQuotas.pdf (original) and zookeeper/trunk/docs/zookeeperQuotas.pdf Thu Jul 3 03:57:19 2014 differ
Modified: zookeeper/trunk/docs/zookeeperStarted.html
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperStarted.html?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
--- zookeeper/trunk/docs/zookeeperStarted.html (original)
+++ zookeeper/trunk/docs/zookeeperStarted.html Thu Jul 3 03:57:19 2014
@@ -404,7 +404,7 @@ ZooKeeper host:port cmd args
delquota [-n|-b] path
quit
printwatches on|off
- createpath data acl
+ create path data acl
stat path [watch]
listquota path
history
Modified: zookeeper/trunk/docs/zookeeperStarted.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperStarted.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/docs/zookeeperTutorial.pdf
URL: http://svn.apache.org/viewvc/zookeeper/trunk/docs/zookeeperTutorial.pdf?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
Binary files - no diff available.
Modified: zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml
URL: http://svn.apache.org/viewvc/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml?rev=1607524&r1=1607523&r2=1607524&view=diff
==============================================================================
--- zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml (original)
+++ zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml Thu Jul 3 03:57:19 2014
@@ -92,6 +92,10 @@
platform</emphasis> only for both server and client.</para>
</listitem>
<listitem>
+ <para>Win64 is supported as a <emphasis>development
+ platform</emphasis> only for both server and client.</para>
+ </listitem>
+ <listitem>
<para>MacOSX is supported as a <emphasis>development
platform</emphasis> only for both server and client.</para>
</listitem>