You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@zookeeper.apache.org by ha...@apache.org on 2017/03/21 19:09:58 UTC
zookeeper git commit: ZOOKEEPER-2635: regenerate document for master
/ 3.6 branch.
Repository: zookeeper
Updated Branches:
refs/heads/master 63577ba52 -> 9a6aff269
ZOOKEEPER-2635: regenerate document for master / 3.6 branch.
Author: Michael Han <ha...@apache.org>
Reviewers: Michael Han <ha...@apache.org>
Closes #203 from hanm/ZOOKEEPER-2635-master
Project: http://git-wip-us.apache.org/repos/asf/zookeeper/repo
Commit: http://git-wip-us.apache.org/repos/asf/zookeeper/commit/9a6aff26
Tree: http://git-wip-us.apache.org/repos/asf/zookeeper/tree/9a6aff26
Diff: http://git-wip-us.apache.org/repos/asf/zookeeper/diff/9a6aff26
Branch: refs/heads/master
Commit: 9a6aff269e5c1ac25e1aca1877b06f725799bfee
Parents: 63577ba
Author: Michael Han <ha...@apache.org>
Authored: Tue Mar 21 12:09:55 2017 -0700
Committer: Michael Han <ha...@apache.org>
Committed: Tue Mar 21 12:09:55 2017 -0700
----------------------------------------------------------------------
docs/index.html | 2 +-
docs/index.pdf | Bin 12643 -> 12657 bytes
docs/javaExample.html | 2 +-
docs/javaExample.pdf | Bin 33876 -> 33818 bytes
docs/linkmap.html | 2 +-
docs/linkmap.pdf | Bin 10808 -> 10826 bytes
docs/recipes.html | 2 +-
docs/recipes.pdf | Bin 33882 -> 33856 bytes
docs/zookeeperAdmin.html | 140 ++++++++++++++++++++++------
docs/zookeeperAdmin.pdf | Bin 93578 -> 97099 bytes
docs/zookeeperHierarchicalQuorums.html | 2 +-
docs/zookeeperHierarchicalQuorums.pdf | Bin 6635 -> 6654 bytes
docs/zookeeperInternals.html | 2 +-
docs/zookeeperInternals.pdf | Bin 48848 -> 48811 bytes
docs/zookeeperJMX.html | 2 +-
docs/zookeeperJMX.pdf | Bin 16473 -> 16475 bytes
docs/zookeeperObservers.html | 2 +-
docs/zookeeperObservers.pdf | Bin 12860 -> 12868 bytes
docs/zookeeperOver.html | 2 +-
docs/zookeeperOver.pdf | Bin 302506 -> 302467 bytes
docs/zookeeperProgrammers.html | 30 ++++--
docs/zookeeperProgrammers.pdf | Bin 143721 -> 144412 bytes
docs/zookeeperQuotas.html | 2 +-
docs/zookeeperQuotas.pdf | Bin 11170 -> 11184 bytes
docs/zookeeperReconfig.html | 2 +-
docs/zookeeperReconfig.pdf | Bin 62104 -> 62032 bytes
docs/zookeeperStarted.html | 2 +-
docs/zookeeperStarted.pdf | Bin 28099 -> 28078 bytes
docs/zookeeperTutorial.html | 2 +-
docs/zookeeperTutorial.pdf | Bin 30533 -> 30478 bytes
30 files changed, 147 insertions(+), 49 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/index.html
----------------------------------------------------------------------
diff --git a/docs/index.html b/docs/index.html
index a203986..5fac4e9 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -341,7 +341,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<div id="logos"></div>
<!--+
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/index.pdf
----------------------------------------------------------------------
diff --git a/docs/index.pdf b/docs/index.pdf
index 4349c24..cd2ab49 100644
Binary files a/docs/index.pdf and b/docs/index.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/javaExample.html
----------------------------------------------------------------------
diff --git a/docs/javaExample.html b/docs/javaExample.html
index e9284c2..d78ee2c 100644
--- a/docs/javaExample.html
+++ b/docs/javaExample.html
@@ -890,7 +890,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/javaExample.pdf
----------------------------------------------------------------------
diff --git a/docs/javaExample.pdf b/docs/javaExample.pdf
index bbc64ec..b025ac4 100644
Binary files a/docs/javaExample.pdf and b/docs/javaExample.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/linkmap.html
----------------------------------------------------------------------
diff --git a/docs/linkmap.html b/docs/linkmap.html
index d62b4be..6208fc7 100644
--- a/docs/linkmap.html
+++ b/docs/linkmap.html
@@ -384,7 +384,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/linkmap.pdf
----------------------------------------------------------------------
diff --git a/docs/linkmap.pdf b/docs/linkmap.pdf
index 38a70e4..cf94bfe 100644
Binary files a/docs/linkmap.pdf and b/docs/linkmap.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/recipes.html
----------------------------------------------------------------------
diff --git a/docs/recipes.html b/docs/recipes.html
index f270806..df494e7 100644
--- a/docs/recipes.html
+++ b/docs/recipes.html
@@ -1014,7 +1014,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/recipes.pdf
----------------------------------------------------------------------
diff --git a/docs/recipes.pdf b/docs/recipes.pdf
index 1d19f58..d11586b 100644
Binary files a/docs/recipes.pdf and b/docs/recipes.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperAdmin.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperAdmin.html b/docs/zookeeperAdmin.html
index 4034c1d..9647b03 100644
--- a/docs/zookeeperAdmin.html
+++ b/docs/zookeeperAdmin.html
@@ -288,6 +288,9 @@ document.write("Last Published: " + document.lastModified);
<a href="#Disabling+data+directory+autocreation">Disabling data directory autocreation</a>
</li>
<li>
+<a href="#sc_db_existence_validation">Enabling db existence validation</a>
+</li>
+<li>
<a href="#sc_performance_options">Performance Tuning Options</a>
</li>
<li>
@@ -302,7 +305,7 @@ document.write("Last Published: " + document.lastModified);
<a href="#sc_zkCommands">ZooKeeper Commands</a>
<ul class="minitoc">
<li>
-<a href="#The+Four+Letter+Words">The Four Letter Words</a>
+<a href="#sc_4lw">The Four Letter Words</a>
</li>
<li>
<a href="#sc_adminserver">The AdminServer</a>
@@ -639,6 +642,19 @@ server.3=zoo3:2888:3888</pre>
<li>
+<p>Create an initialization marker file <span class="codefrag filename">initialize</span>
+ in the same directory as <span class="codefrag filename">myid</span>. This file indicates
+ that an empty data directory is expected. When present, an empty data base
+ is created and the marker file deleted. When not present, an empty data
+ directory will mean this peer will not have voting rights and it will not
+ populate the data directory until it communicates with an active leader.
+ Intended use is to only create this file when bringing up a new
+ ensemble. </p>
+
+</li>
+
+<li>
+
<p>If your configuration file is set up, you can start a
ZooKeeper server:</p>
@@ -940,14 +956,10 @@ server.3=zoo3:2888:3888</pre>
of the znodes stored by a particular serving ensemble. These
are the snapshot and transactional log files. As changes are
made to the znodes these changes are appended to a
- transaction log. Occasionally, when a log grows large, a
+ transaction log, occasionally, when a log grows large, a
snapshot of the current state of all znodes will be written
- to the filesystem and a new transaction log file is created
- for future transactions. During snapshotting, ZooKeeper may
- continue appending incoming transactions to the old log file.
- Therefore, some transactions which are newer than a snapshot
- may be found in the last transaction log preceding the
- snapshot.
+ to the filesystem. This snapshot supercedes all previous
+ logs.
</p>
<p>A ZooKeeper server <strong>will not remove
old snapshots and log files</strong> when using the default
@@ -1205,10 +1217,8 @@ server.3=zoo3:2888:3888</pre>
<p>(Java system property: <strong>zookeeper.snapCount</strong>)</p>
<p>ZooKeeper logs transactions to a transaction
log. After snapCount transactions are written to a log
- file a snapshot is started. It also influences rollover
- of the current transaction log to a new file. However,
- the creation of a new snapshot and rollover of transaction
- log proceed independently. The default snapCount is
+ file a snapshot is started and a new transaction log
+ file is created. The default snapCount is
100,000.</p>
</dd>
@@ -1531,6 +1541,36 @@ server.3=zoo3:2888:3888</pre>
</p>
</dd>
+
+<dt>
+<term>4lw.commands.whitelist</term>
+</dt>
+<dd>
+<p>(Java system property: <strong>zookeeper.4lw.commands.whitelist</strong>)</p>
+<p>
+<strong>New in 3.5.3:</strong>
+ A list of comma separated <a href="#sc_4lw">Four Letter Words</a>
+ commands that user wants to use. A valid Four Letter Words
+ command must be put in this list else ZooKeeper server will
+ not enable the command.
+ By default the whitelist only contains "srvr" command
+ which zkServer.sh uses. The rest of four letter word commands are disabled
+ by default.
+ </p>
+<p>Here's an example of the configuration that enables stat, ruok, conf, and isro
+ command while disabling the rest of Four Letter Words command:</p>
+<pre class="code">
+ 4lw.commands.whitelist=stat, ruok, conf, isro
+ </pre>
+<p>If you really need enable all four letter word commands by default, you can use
+ the asterisk option so you don't have to include every command one by one in the list.
+ As an example, this will enable all four letter word commands:
+ </p>
+<pre class="code">
+ 4lw.commands.whitelist=*
+ </pre>
+</dd>
+
</dl>
<p></p>
@@ -1760,6 +1800,32 @@ server.3=zoo3:2888:3888</pre>
it does not create a config file, but rather requires a config
file to be available in order to execute.
</p>
+<a name="sc_db_existence_validation"></a>
+<h4>Enabling db existence validation</h4>
+<p>
+<strong>New in 3.6.0:</strong> The default
+ behavior of a ZooKeeper server on startup when no data tree
+ is found is to set zxid to zero and join the quorum as a
+ voting member. This can be dangerous if some event (e.g. a
+ rogue 'rm -rf') has removed the data directory while the
+ server was down since this server may help elect a leader
+ that is missing transactions. Enabling db existence validation
+ will change the behavior on startup when no data tree is
+ found: the server joins the ensemble as a non-voting participant
+ until it is able to sync with the leader and acquire an up-to-date
+ version of the ensemble data. To indicate an empty data tree is
+ expected (ensemble creation), the user should place a file
+ 'initialize' in the same directory as 'myid'. This file will
+ be detected and deleted by the server on startup.
+ </p>
+<p> Initialization validation can be enabled when running
+ ZooKeeper servers directly from class files by setting
+ <strong>zookeeper.db.autocreate=false</strong>
+ on the java command line, i.e.
+ <strong>-Dzookeeper.db.autocreate=false</strong>.
+ Running <strong>zkServer-initialize.sh</strong>
+ will create the required initialization file.
+ </p>
<a name="sc_performance_options"></a>
<h4>Performance Tuning Options</h4>
<p>
@@ -1933,7 +1999,7 @@ server.3=zoo3:2888:3888</pre>
</dl>
<a name="sc_zkCommands"></a>
<h3 class="h4">ZooKeeper Commands</h3>
-<a name="The+Four+Letter+Words"></a>
+<a name="sc_4lw"></a>
<h4>The Four Letter Words</h4>
<p>ZooKeeper responds to a small set of commands. Each command is
composed of four letters. You issue the commands to ZooKeeper via telnet
@@ -1942,6 +2008,15 @@ server.3=zoo3:2888:3888</pre>
general information about the server and connected clients,
while "srvr" and "cons" give extended details on server and
connections respectively.</p>
+<p>
+<strong>New in 3.5.3:</strong>
+ Four Letter Words need to be explicitly white listed before using.
+ Please refer <strong>4lw.commands.whitelist</strong>
+ described in <a href="#sc_clusterOptions">
+ cluster configuration section</a> for details.
+ Moving forward, Four Letter Words will be deprecated, please use
+ <a href="#sc_adminserver">AdminServer</a> instead.
+ </p>
<dl>
<dt>
@@ -2301,7 +2376,7 @@ server.3=zoo3:2888:3888</pre>
on a dedicated log devices.</p>
<a name="The+Data+Directory"></a>
<h4>The Data Directory</h4>
-<p>This directory has two files in it:</p>
+<p>This directory has two or three files in it:</p>
<ul>
<li>
@@ -2316,6 +2391,15 @@ server.3=zoo3:2888:3888</pre>
<li>
<p>
+<span class="codefrag filename">initialize</span> - presence indicates lack of
+ data tree is expected. Cleaned up once data tree is created.</p>
+
+</li>
+
+
+<li>
+
+<p>
<span class="codefrag filename">snapshot.<zxid></span> - holds the fuzzy
snapshot of a data tree.</p>
@@ -2350,11 +2434,8 @@ server.3=zoo3:2888:3888</pre>
<p>The Log Directory contains the ZooKeeper transaction logs.
Before any update takes place, ZooKeeper ensures that the transaction
that represents the update is written to non-volatile storage. A new
- log file is started when the number of transactions written to the
- current log file reaches a (variable) threshold. The threshold is
- computed using the same parameter which influences the frequency of
- snapshotting (see snapCount above). The log file's suffix is the first
- zxid written to that log.</p>
+ log file is started each time a snapshot is begun. The log file's
+ suffix is the first zxid written to that log.</p>
<a name="sc_filemanagement"></a>
<h4>File Management</h4>
<p>The format of snapshot and log files does not change between
@@ -2369,12 +2450,8 @@ server.3=zoo3:2888:3888</pre>
<p>The ZooKeeper server creates snapshot and log files, but
never deletes them. The retention policy of the data and log
files is implemented outside of the ZooKeeper server. The
- server itself only needs the latest complete fuzzy snapshot, all log
- files following it, and the last log file preceding it. The latter
- requirement is necessary to include updates which happened after this
- snapshot was started but went into the existing log file at that time.
- This is possible because snapshotting and rolling over of logs
- proceed somewhat independently in Zookeeper. See the
+ server itself only needs the latest complete fuzzy snapshot
+ and the log files from the start of that snapshot. See the
<a href="#sc_maintenance">maintenance</a> section in
this document for more details on setting a retention policy
and maintenance of ZooKeeper storage.
@@ -2443,6 +2520,17 @@ server.3=zoo3:2888:3888</pre>
is to run load tests, and then make sure you are well below the
usage limit that would cause the system to swap.</p>
</dd>
+
+
+<dt>
+<term>Publicly accessible deployment</term>
+</dt>
+<dd>
+<p>
+ A ZooKeeper ensemble is expected to operate in a trusted computing environment.
+ It is thus recommended to deploy ZooKeeper behind a firewall.
+ </p>
+</dd>
</dl>
<a name="sc_bestPractices"></a>
@@ -2475,7 +2563,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperAdmin.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperAdmin.pdf b/docs/zookeeperAdmin.pdf
index 3f8f2d9..7de61f4 100644
Binary files a/docs/zookeeperAdmin.pdf and b/docs/zookeeperAdmin.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperHierarchicalQuorums.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperHierarchicalQuorums.html b/docs/zookeeperHierarchicalQuorums.html
index 72f6c06..0b5dd70 100644
--- a/docs/zookeeperHierarchicalQuorums.html
+++ b/docs/zookeeperHierarchicalQuorums.html
@@ -254,7 +254,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperHierarchicalQuorums.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperHierarchicalQuorums.pdf b/docs/zookeeperHierarchicalQuorums.pdf
index d27aa22..44d35de 100644
Binary files a/docs/zookeeperHierarchicalQuorums.pdf and b/docs/zookeeperHierarchicalQuorums.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperInternals.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperInternals.html b/docs/zookeeperInternals.html
index de5c821..9920800 100644
--- a/docs/zookeeperInternals.html
+++ b/docs/zookeeperInternals.html
@@ -783,7 +783,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperInternals.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperInternals.pdf b/docs/zookeeperInternals.pdf
index 445d8ef..1276ae4 100644
Binary files a/docs/zookeeperInternals.pdf and b/docs/zookeeperInternals.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperJMX.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperJMX.html b/docs/zookeeperJMX.html
index 4a627f1..258010d 100644
--- a/docs/zookeeperJMX.html
+++ b/docs/zookeeperJMX.html
@@ -457,7 +457,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperJMX.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperJMX.pdf b/docs/zookeeperJMX.pdf
index 5cfe345..31fea2b 100644
Binary files a/docs/zookeeperJMX.pdf and b/docs/zookeeperJMX.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperObservers.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperObservers.html b/docs/zookeeperObservers.html
index 4f83ebb..1dd77fc 100644
--- a/docs/zookeeperObservers.html
+++ b/docs/zookeeperObservers.html
@@ -344,7 +344,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperObservers.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperObservers.pdf b/docs/zookeeperObservers.pdf
index f1f83dc..19abf32 100644
Binary files a/docs/zookeeperObservers.pdf and b/docs/zookeeperObservers.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperOver.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperOver.html b/docs/zookeeperOver.html
index 7a68713..043858b 100644
--- a/docs/zookeeperOver.html
+++ b/docs/zookeeperOver.html
@@ -682,7 +682,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperOver.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperOver.pdf b/docs/zookeeperOver.pdf
index 7075e79..0f4c696 100644
Binary files a/docs/zookeeperOver.pdf and b/docs/zookeeperOver.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperProgrammers.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperProgrammers.html b/docs/zookeeperProgrammers.html
index a0ddd1c..cb8e7f7 100644
--- a/docs/zookeeperProgrammers.html
+++ b/docs/zookeeperProgrammers.html
@@ -1307,11 +1307,14 @@ document.write("Last Published: " + document.lastModified);
be able to read <em>/app/status</em>; ACLs are not
recursive.</p>
<p>ZooKeeper supports pluggable authentication schemes. Ids are
- specified using the form <em>scheme:id</em>,
- where <em>scheme</em> is a the authentication scheme
- that the id corresponds to. For
- example, <em>ip:172.16.16.1</em> is an id for a
- host with the address <em>172.16.16.1</em>.</p>
+ specified using the form <em>scheme:expression</em>,
+ where <em>scheme</em> is the authentication scheme
+ that the id corresponds to. The set of valid expressions are defined
+ by the scheme. For example, <em>ip:172.16.16.1</em> is
+ an id for a host with the address <em>172.16.16.1</em>
+ using the <em>ip</em> scheme, whereas <em>digest:bob:password</em>
+ is an id for the user with the name of <em>bob</em> using
+ the <em>digest</em> scheme.</p>
<p>When a client connects to ZooKeeper and authenticates
itself, ZooKeeper associates all the ids that correspond to a
client with the clients connection. These ids are checked against
@@ -1393,9 +1396,16 @@ document.write("Last Published: " + document.lastModified);
<li>
<p>
-<strong>auth</strong> doesn't
- use any id, represents any authenticated
- user.</p>
+<strong>auth</strong> is a special
+ scheme which ignores any provided expression and instead uses the current user,
+ credentials, and scheme. Any expression (whether <em>user</em> like with SASL
+ authentication or <em>user:password</em> like with DIGEST authentication) provided is ignored
+ by the ZooKeeper server when persisting the ACL. However, the expression must still be
+ provided in the ACL because the ACL must match the form <em>scheme:expression:perms</em>.
+ This scheme is provided as a convenience as it is a common use-case for
+ a user to create a znode and then restrict access to that znode to only that user.
+ If there is no authenticated user, setting an ACL with the auth scheme will fail.
+ </p>
</li>
@@ -2386,7 +2396,7 @@ public abstract class ServerAuthenticationProvider implements AuthenticationProv
<p>If you are using watches, you must look for the connected watch
event. When a ZooKeeper client disconnects from a server, you will
not receive notification of changes until reconnected. If you are
- watching for a znode to come into existance, you will miss the event
+ watching for a znode to come into existence, you will miss the event
if the znode is created and deleted while you are disconnected.</p>
</li>
@@ -2569,7 +2579,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperProgrammers.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperProgrammers.pdf b/docs/zookeeperProgrammers.pdf
index 0899f86..a5d72c0 100644
Binary files a/docs/zookeeperProgrammers.pdf and b/docs/zookeeperProgrammers.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperQuotas.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperQuotas.html b/docs/zookeeperQuotas.html
index ca5c02d..72e4652 100644
--- a/docs/zookeeperQuotas.html
+++ b/docs/zookeeperQuotas.html
@@ -268,7 +268,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperQuotas.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperQuotas.pdf b/docs/zookeeperQuotas.pdf
index a1d48f6..6db6351 100644
Binary files a/docs/zookeeperQuotas.pdf and b/docs/zookeeperQuotas.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperReconfig.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperReconfig.html b/docs/zookeeperReconfig.html
index 32fd0cb..e03f2fa 100644
--- a/docs/zookeeperReconfig.html
+++ b/docs/zookeeperReconfig.html
@@ -1232,7 +1232,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperReconfig.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperReconfig.pdf b/docs/zookeeperReconfig.pdf
index 50a50e2..12cd2f3 100644
Binary files a/docs/zookeeperReconfig.pdf and b/docs/zookeeperReconfig.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperStarted.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperStarted.html b/docs/zookeeperStarted.html
index 63c2b1a..89d9129 100644
--- a/docs/zookeeperStarted.html
+++ b/docs/zookeeperStarted.html
@@ -608,7 +608,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperStarted.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperStarted.pdf b/docs/zookeeperStarted.pdf
index 0e2f63f..4675060 100644
Binary files a/docs/zookeeperStarted.pdf and b/docs/zookeeperStarted.pdf differ
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperTutorial.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperTutorial.html b/docs/zookeeperTutorial.html
index 5c19de3..3f3def1 100644
--- a/docs/zookeeperTutorial.html
+++ b/docs/zookeeperTutorial.html
@@ -872,7 +872,7 @@ document.write("Last Published: " + document.lastModified);
</div>
<div class="copyright">
Copyright ©
- 2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+ <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperTutorial.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperTutorial.pdf b/docs/zookeeperTutorial.pdf
index 3cdd8b1..97ad79b 100644
Binary files a/docs/zookeeperTutorial.pdf and b/docs/zookeeperTutorial.pdf differ