hadoop-zookeeper-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From maha...@apache.org
Subject svn commit: r738323 - in /hadoop/zookeeper/trunk: ./ bin/ docs/ src/docs/src/documentation/content/xdocs/
Date Wed, 28 Jan 2009 00:42:17 GMT
Author: mahadev
Date: Wed Jan 28 00:42:16 2009
New Revision: 738323

URL: http://svn.apache.org/viewvc?rev=738323&view=rev
Log:
ZOOKEEPER-177.  needed: docs for JMX (phunt via mahadev)

Added:
    hadoop/zookeeper/trunk/docs/zookeeperJMX.html
    hadoop/zookeeper/trunk/docs/zookeeperJMX.pdf
    hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperJMX.xml
Modified:
    hadoop/zookeeper/trunk/CHANGES.txt
    hadoop/zookeeper/trunk/bin/zkServer.sh
    hadoop/zookeeper/trunk/docs/index.html
    hadoop/zookeeper/trunk/docs/index.pdf
    hadoop/zookeeper/trunk/docs/javaExample.html
    hadoop/zookeeper/trunk/docs/linkmap.html
    hadoop/zookeeper/trunk/docs/linkmap.pdf
    hadoop/zookeeper/trunk/docs/recipes.html
    hadoop/zookeeper/trunk/docs/releasenotes.html
    hadoop/zookeeper/trunk/docs/zookeeperAdmin.html
    hadoop/zookeeper/trunk/docs/zookeeperAdmin.pdf
    hadoop/zookeeper/trunk/docs/zookeeperInternals.html
    hadoop/zookeeper/trunk/docs/zookeeperOver.html
    hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html
    hadoop/zookeeper/trunk/docs/zookeeperStarted.html
    hadoop/zookeeper/trunk/docs/zookeeperTutorial.html
    hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/index.xml
    hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/site.xml
    hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml

Modified: hadoop/zookeeper/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/CHANGES.txt?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/CHANGES.txt (original)
+++ hadoop/zookeeper/trunk/CHANGES.txt Wed Jan 28 00:42:16 2009
@@ -118,6 +118,8 @@
    and messages generated. (phunt via breed)
 
    ZOOKEEPER-210. Require Java 6. (phunt via breed)
+    
+   ZOOKEEPER-177.  needed: docs for JMX (phunt via mahadev)
 
 Release 3.0.0 - 2008-10-21
 

Modified: hadoop/zookeeper/trunk/bin/zkServer.sh
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/bin/zkServer.sh?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/bin/zkServer.sh (original)
+++ hadoop/zookeeper/trunk/bin/zkServer.sh Wed Jan 28 00:42:16 2009
@@ -21,13 +21,27 @@
 # relative to the canonical path of this script.
 #
 
-# by default we allow non-local JMX connection
-# set this to true if you wish to allow only local connections
+# See the following page for extensive details on setting
+# up the JVM to accept JMX remote management:
+# http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html
+# by default we allow local JMX connections
 if [ "x$JMXLOCALONLY" = "x" ]
 then 
     JMXLOCALONLY=false
 fi
 
+if [ "x$JMXDISABLE" = "x" ]
+then
+    echo "JMX enabled by default"
+    # for some reason these two options are necessary on jdk6 on Ubuntu
+    #   accord to the docs they are not necessary, but otw jconsole cannot
+    #   do a local attach
+    ZOOMAIN="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.local.only=$JMXLOCALONLY org.apache.zookeeper.server.quorum.QuorumPeerMain"
+else
+    echo "JMX disabled by user request"
+    ZOOMAIN="org.apache.zookeeper.server.quorum.QuorumPeerMain"
+fi
+
 ZOOBIN=`readlink -f "$0"`
 ZOOBINDIR=`dirname "$ZOOBIN"`
 
@@ -37,7 +51,7 @@
 start) 
     echo -n "Starting zookeeper ... "
     java  "-Dzookeeper.log.dir=${ZOO_LOG_DIR}" "-Dzookeeper.root.logger=${ZOO_LOG4J_PROP}" \
-    -cp $CLASSPATH -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.local.only=$JMXLOCALONLY $JVMFLAGS org.apache.zookeeper.server.quorum.ManagedQuorumPeerMain $ZOOCFG &
+    -cp $CLASSPATH $JVMFLAGS $ZOOMAIN $ZOOCFG &
     echo STARTED
     ;;
 stop) 

Modified: hadoop/zookeeper/trunk/docs/index.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/index.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/index.html (original)
+++ hadoop/zookeeper/trunk/docs/index.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">
@@ -183,18 +186,22 @@
 </div>
 <h1>ZooKeeper: Because Coordinating Distributed Systems is a Zoo</h1>
     
-<p>
-ZooKeeper is a high-performance coordination service for distributed applications. 
-It exposes common services - such as naming, configuration management, synchronization, 
-and group services - in a simple interface so you don't have to write them from scratch. 
-You can use it off-the-shelf to implement consensus, group management, leader election, 
-and presence protocols. And you can build on it for your own, specific needs.
-</p>
-
+<p>ZooKeeper is a high-performance coordination service for
+      distributed applications.  It exposes common services - such as
+      naming, configuration management, synchronization, and group
+      services - in a simple interface so you don't have to write them
+      from scratch.  You can use it off-the-shelf to implement
+      consensus, group management, leader election, and presence
+      protocols. And you can build on it for your own, specific needs.
+    </p>
 
+    
 <p>
-The following documents describe concepts and procedures to get you started using ZooKeeper. If you have more questions, please ask the <a href="http://hadoop.apache.org/zookeeper/mailing_lists.html">mailing list</a> or browse the archives.
-</p>
+      The following documents describe concepts and procedures to get
+      you started using ZooKeeper. If you have more questions, please
+      ask the <a href="http://hadoop.apache.org/zookeeper/mailing_lists.html">mailing list</a> or browse the
+      archives.
+    </p>
     
 <ul>
 
@@ -251,7 +258,10 @@
 <ul>
       
 <li>
-<a href="zookeeperAdmin.html">Administrator's Guide</a> - a guide for system administrators and anyone else who might deploy Zookeeer</li>
+<a href="zookeeperAdmin.html">Administrator's Guide</a> - a guide for system administrators and anyone else who might deploy ZooKeeper</li>
+      
+<li>
+<a href="zookeeperJMX.html">JMX</a> - how to enable JMX in ZooKeeper</li>
       
 </ul>
       

Modified: hadoop/zookeeper/trunk/docs/index.pdf
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/index.pdf?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/zookeeper/trunk/docs/javaExample.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/javaExample.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/javaExample.html (original)
+++ hadoop/zookeeper/trunk/docs/javaExample.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">

Modified: hadoop/zookeeper/trunk/docs/linkmap.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/linkmap.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/linkmap.html (original)
+++ hadoop/zookeeper/trunk/docs/linkmap.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">
@@ -274,6 +277,12 @@
 <a href="zookeeperAdmin.html">Administrator's Guide</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>admin</em>
 </li>
 </ul>
+      
+<ul>
+<li>
+<a href="zookeeperJMX.html">JMX</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>jmx</em>
+</li>
+</ul>
   
 </ul>
 </ul>

Modified: hadoop/zookeeper/trunk/docs/linkmap.pdf
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/linkmap.pdf?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/zookeeper/trunk/docs/recipes.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/recipes.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/recipes.html (original)
+++ hadoop/zookeeper/trunk/docs/recipes.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">

Modified: hadoop/zookeeper/trunk/docs/releasenotes.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/releasenotes.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/releasenotes.html (original)
+++ hadoop/zookeeper/trunk/docs/releasenotes.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">

Modified: hadoop/zookeeper/trunk/docs/zookeeperAdmin.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperAdmin.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperAdmin.html (original)
+++ hadoop/zookeeper/trunk/docs/zookeeperAdmin.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menupage">
 <div class="menupagetitle">Administrator's Guide</div>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">
@@ -476,14 +479,30 @@
         
 <li>
           
-<p>If your configuration file is set up, you can start
-          ZooKeeper:</p>
+<p>If your configuration file is set up, you can start a
+          ZooKeeper server:</p>
 
           
 <p>
-<span class="codefrag computeroutput">$ java -cp zookeeper.jar:src/java/lib/log4j-1.2.15.jar:conf \
-        org.apache.zookeeper.server.quorum.ManagedQuorumPeerMain zoo.cfg</span>
+<span class="codefrag computeroutput">$ java -cp zookeeper.jar:lib/log4j-1.2.15.jar:conf \
+              org.apache.zookeeper.server.quorum.QuorumPeerMain zoo.cfg
+          </span>
 </p>
+          
+          
+<p>QuorumPeerMain starts a ZooKeeper server,
+            <a href="http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/">JMX</a>
+            management beans are also registered which allows
+            management through a JMX management console. 
+            The <a href="zookeeperJMX.html">ZooKeeper JMX
+            document</a> contains details on managing ZooKeeper with JMX.
+          </p>
+
+          
+<p>See the script <em>bin/zkServer.sh</em>,
+            which is included in the release, for an example
+            of starting server instances.</p>
+
         
 </li>
 
@@ -546,7 +565,7 @@
 </li>
       
 </ol>
-<a name="N10108"></a><a name="sc_singleAndDevSetup"></a>
+<a name="N10119"></a><a name="sc_singleAndDevSetup"></a>
 <h3 class="h4">Single Server and Developer Setup</h3>
 <p>If you want to setup ZooKeeper for development purposes, you will
       probably want to setup a single server instance of ZooKeeper, and then
@@ -564,7 +583,7 @@
 </div>
 
   
-<a name="N10129"></a><a name="ch_administration"></a>
+<a name="N1013A"></a><a name="ch_administration"></a>
 <h2 class="h3">Administration</h2>
 <div class="section">
 <p>This section contains information about running and maintaining
@@ -679,7 +698,7 @@
 </li>
       
 </ul>
-<a name="N10195"></a><a name="sc_designing"></a>
+<a name="N101A6"></a><a name="sc_designing"></a>
 <h3 class="h4">Designing a ZooKeeper Deployment</h3>
 <p>The reliablity of ZooKeeper rests on two basic assumptions.</p>
 <ol>
@@ -706,7 +725,7 @@
       to hold true. Some of these are cross-machines considerations,
       and others are things you should consider for each and every
       machine in your deployment.</p>
-<a name="N101B1"></a><a name="sc_CrossMachineRequirements"></a>
+<a name="N101C2"></a><a name="sc_CrossMachineRequirements"></a>
 <h4>Cross Machine Requirements</h4>
 <p>For the ZooKeeper service to be active, there must be a
         majority of non-failing machines that can communicate with
@@ -724,7 +743,7 @@
         failure of that switch could cause a correlated failure and
         bring down the service. The same holds true of shared power
         circuits, cooling systems, etc.</p>
-<a name="N101BE"></a><a name="Single+Machine+Requirements"></a>
+<a name="N101CF"></a><a name="Single+Machine+Requirements"></a>
 <h4>Single Machine Requirements</h4>
 <p>If ZooKeeper has to contend with other applications for
         access to resourses like storage media, CPU, network, or
@@ -765,19 +784,19 @@
 </li>
       
 </ul>
-<a name="N101DC"></a><a name="sc_provisioning"></a>
+<a name="N101ED"></a><a name="sc_provisioning"></a>
 <h3 class="h4">Provisioning</h3>
 <p></p>
-<a name="N101E5"></a><a name="sc_strengthsAndLimitations"></a>
+<a name="N101F6"></a><a name="sc_strengthsAndLimitations"></a>
 <h3 class="h4">Things to Consider: ZooKeeper Strengths and Limitations</h3>
 <p></p>
-<a name="N101EE"></a><a name="sc_administering"></a>
+<a name="N101FF"></a><a name="sc_administering"></a>
 <h3 class="h4">Administering</h3>
 <p></p>
-<a name="N101F7"></a><a name="sc_monitoring"></a>
+<a name="N10208"></a><a name="sc_monitoring"></a>
 <h3 class="h4">Monitoring</h3>
 <p></p>
-<a name="N10200"></a><a name="sc_logging"></a>
+<a name="N10211"></a><a name="sc_logging"></a>
 <h3 class="h4">Logging</h3>
 <p>ZooKeeper uses <strong>log4j</strong> version 1.2 as 
       its logging infrastructure. The  ZooKeeper default <span class="codefrag filename">log4j.properties</span> 
@@ -787,10 +806,10 @@
 <p>For more information, see 
       <a href="http://logging.apache.org/log4j/1.2/manual.html#defaultInit">Log4j Default Initialization Procedure</a> 
       of the log4j manual.</p>
-<a name="N10220"></a><a name="sc_troubleshooting"></a>
+<a name="N10231"></a><a name="sc_troubleshooting"></a>
 <h3 class="h4">Troubleshooting</h3>
 <p></p>
-<a name="N10229"></a><a name="sc_configuration"></a>
+<a name="N1023A"></a><a name="sc_configuration"></a>
 <h3 class="h4">Configuration Parameters</h3>
 <p>ZooKeeper's behavior is governed by the ZooKeeper configuration
       file. This file is designed so that the exact same file can be used by
@@ -798,7 +817,7 @@
       layouts are the same. If servers use different configuration files, care
       must be taken to ensure that the list of servers in all of the different
       configuration files match.</p>
-<a name="N10232"></a><a name="sc_minimumConfiguration"></a>
+<a name="N10243"></a><a name="sc_minimumConfiguration"></a>
 <h4>Minimum Configuration</h4>
 <p>Here are the minimum configuration keywords that must be defined
         in the configuration file:</p>
@@ -845,7 +864,7 @@
 </dd>
         
 </dl>
-<a name="N10259"></a><a name="sc_advancedConfiguration"></a>
+<a name="N1026A"></a><a name="sc_advancedConfiguration"></a>
 <h4>Advanced Configuration</h4>
 <p>The configuration settings in the section are optional. You can
         use them to further fine tune the behaviour of your ZooKeeper servers.
@@ -936,7 +955,7 @@
 </dd>
         
 </dl>
-<a name="N102B9"></a><a name="sc_clusterOptions"></a>
+<a name="N102CA"></a><a name="sc_clusterOptions"></a>
 <h4>Cluster Options</h4>
 <p>The options in this section are designed for use with an ensemble
         of servers -- that is, when deploying clusters of servers.</p>
@@ -1026,7 +1045,7 @@
         
 </dl>
 <p></p>
-<a name="N10316"></a><a name="Unsafe+Options"></a>
+<a name="N10327"></a><a name="Unsafe+Options"></a>
 <h4>Unsafe Options</h4>
 <p>The following options can be useful, but be careful when you use
         them. The risk of each is explained along with the explanation of what
@@ -1071,7 +1090,7 @@
 </dd>
         
 </dl>
-<a name="N10348"></a><a name="sc_zkCommands"></a>
+<a name="N10359"></a><a name="sc_zkCommands"></a>
 <h3 class="h4">ZooKeeper Commands: The Four Letter Words</h3>
 <p>ZooKeeper responds to a small set of commands. Each command is
       composed of four letters. You issue the commands to ZooKeeper via telnet
@@ -1144,7 +1163,7 @@
 <pre class="code">$ echo ruok | nc 127.0.0.1 5111
 imok
 </pre>
-<a name="N1038F"></a><a name="sc_dataFileManagement"></a>
+<a name="N103A0"></a><a name="sc_dataFileManagement"></a>
 <h3 class="h4">Data File Management</h3>
 <p>ZooKeeper stores its data in a data directory and its transaction
       log in a transaction log directory. By default these two directories are
@@ -1152,7 +1171,7 @@
       transaction log files in a separate directory than the data files.
       Throughput increases and latency decreases when transaction logs reside
       on a dedicated log devices.</p>
-<a name="N10398"></a><a name="The+Data+Directory"></a>
+<a name="N103A9"></a><a name="The+Data+Directory"></a>
 <h4>The Data Directory</h4>
 <p>This directory has two files in it:</p>
 <ul>
@@ -1198,14 +1217,14 @@
         idempotent nature of its updates. By replaying the transaction log
         against fuzzy snapshots ZooKeeper gets the state of the system at the
         end of the log.</p>
-<a name="N103D4"></a><a name="The+Log+Directory"></a>
+<a name="N103E5"></a><a name="The+Log+Directory"></a>
 <h4>The Log Directory</h4>
 <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 each time a snapshot is begun. The log file's
         suffix is the first zxid written to that log.</p>
-<a name="N103DE"></a><a name="File+Management"></a>
+<a name="N103EF"></a><a name="File+Management"></a>
 <h4>File Management</h4>
 <p>The format of snapshot and log files does not change between
         standalone ZooKeeper servers and different configurations of
@@ -1222,7 +1241,7 @@
         needs the latest complete fuzzy snapshot and the log files from the
         start of that snapshot. The PurgeTxnLog utility implements a simple
         retention policy that administrators can use.</p>
-<a name="N103EF"></a><a name="sc_commonProblems"></a>
+<a name="N10400"></a><a name="sc_commonProblems"></a>
 <h3 class="h4">Things to Avoid</h3>
 <p>Here are some common problems you can avoid by configuring
       ZooKeeper correctly:</p>
@@ -1276,7 +1295,7 @@
 </dd>
       
 </dl>
-<a name="N10413"></a><a name="sc_bestPractices"></a>
+<a name="N10424"></a><a name="sc_bestPractices"></a>
 <h3 class="h4">Best Practices</h3>
 <p>For best results, take note of the following list of good
       Zookeeper practices. <em>[tbd...]</em>

Modified: hadoop/zookeeper/trunk/docs/zookeeperAdmin.pdf
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperAdmin.pdf?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/zookeeper/trunk/docs/zookeeperInternals.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperInternals.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperInternals.html (original)
+++ hadoop/zookeeper/trunk/docs/zookeeperInternals.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_selected_1.4', 'skin/')" id="menu_selected_1.4Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Contributor</div>
 <div id="menu_selected_1.4" class="selectedmenuitemgroup" style="display: block;">

Added: hadoop/zookeeper/trunk/docs/zookeeperJMX.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperJMX.html?rev=738323&view=auto
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperJMX.html (added)
+++ hadoop/zookeeper/trunk/docs/zookeeperJMX.html Wed Jan 28 00:42:16 2009
@@ -0,0 +1,456 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8">
+<meta name="Forrest-skin-name" content="pelt">
+<title>ZooKeeper JMX</title>
+<link type="text/css" href="skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
+<link type="text/css" href="skin/profile.css" rel="stylesheet">
+<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="images/favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://hadoop.apache.org/">Hadoop</a> &gt; <a href="http://hadoop.apache.org/zookeeper/">ZooKeeper</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://hadoop.apache.org/"><img class="logoImage" alt="Hadoop" src="images/hadoop-logo.jpg" title="Apache Hadoop"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://hadoop.apache.org/zookeeper/"><img class="logoImage" alt="ZooKeeper" src="images/zookeeper_small.gif" title="The Hadoop database"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="hadoop.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp; 
+                    <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li>
+<a class="unselected" href="http://hadoop.apache.org/zookeeper/">Project</a>
+</li>
+<li>
+<a class="unselected" href="http://wiki.apache.org/hadoop/ZooKeeper">Wiki</a>
+</li>
+<li class="current">
+<a class="selected" href="index.html">ZooKeeper 3.1 Documentation</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', 'skin/')" id="menu_1.1Title" class="menutitle">Overview</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="index.html">Welcome</a>
+</div>
+<div class="menuitem">
+<a href="zookeeperOver.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="zookeeperStarted.html">Getting Started</a>
+</div>
+<div class="menuitem">
+<a href="releasenotes.html">Release Notes</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Developer</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="api/index.html">API Docs</a>
+</div>
+<div class="menuitem">
+<a href="zookeeperProgrammers.html">Programmer's Guide</a>
+</div>
+<div class="menuitem">
+<a href="javaExample.html">Java Example</a>
+</div>
+<div class="menuitem">
+<a href="zookeeperTutorial.html">Barrier and Queue Tutorial</a>
+</div>
+<div class="menuitem">
+<a href="recipes.html">Recipes</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.3', 'skin/')" id="menu_selected_1.3Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Admin &amp; Ops</div>
+<div id="menu_selected_1.3" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="zookeeperAdmin.html">Administrator's Guide</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">JMX</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
+<div id="menu_1.4" class="menuitemgroup">
+<div class="menuitem">
+<a href="zookeeperInternals.html">ZooKeeper Internals</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.5', 'skin/')" id="menu_1.5Title" class="menutitle">Miscellaneous</div>
+<div id="menu_1.5" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://wiki.apache.org/hadoop/ZooKeeper">Wiki</a>
+</div>
+<div class="menuitem">
+<a href="http://wiki.apache.org/hadoop/ZooKeeper/FAQ">FAQ</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/zookeeper/mailing_lists.html">Mailing Lists</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+<div id="credit2"></div>
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="zookeeperJMX.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<h1>ZooKeeper JMX</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#ch_jmx">JMX</a>
+</li>
+<li>
+<a href="#ch_starting">Starting ZooKeeper with JMX enabled</a>
+</li>
+<li>
+<a href="#ch_console">Run a JMX console</a>
+</li>
+<li>
+<a href="#ch_reference">ZooKeeper MBean Reference</a>
+</li>
+</ul>
+</div>
+  
+
+  
+
+  
+<a name="N10009"></a><a name="ch_jmx"></a>
+<h2 class="h3">JMX</h2>
+<div class="section">
+<p>Apache ZooKeeper has extensive support for JMX, allowing you
+    to view and manage a ZooKeeper serving ensemble.</p>
+<p>This document assumes that you have basic knowledge of
+    JMX. See <a href="http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/">
+    Sun JMX Technology</a> page to get started with JMX.
+    </p>
+<p>See the <a href="http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html">
+    JMX Management Guide</a> for details on setting up local and
+    remote management of VM instances. By default the included
+    <em>zkServer.sh</em> supports only local management -
+    review the linked document to enable support for remote management
+    (beyond the scope of this document).
+    </p>
+</div>
+
+  
+<a name="N10024"></a><a name="ch_starting"></a>
+<h2 class="h3">Starting ZooKeeper with JMX enabled</h2>
+<div class="section">
+<p>The class
+      <em>org.apache.zookeeper.server.quorum.QuorumPeerMain</em>
+      will start a JMX manageable ZooKeeper server. This class
+      registers the proper MBeans during initalization to support JMX
+      monitoring and management of the
+      instance. See <em>bin/zkServer.sh</em> for one
+      example of starting ZooKeeper using QuorumPeerMain.</p>
+</div>
+
+  
+<a name="N10034"></a><a name="ch_console"></a>
+<h2 class="h3">Run a JMX console</h2>
+<div class="section">
+<p>There are a number of JMX consoles available which can connect
+      to the running server. For this example we will use Sun's
+      <em>jconsole</em>.</p>
+<p>The Java JDK ships with a simple JMX console
+      named <a href="http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html">jconsole</a>
+      which can be used to connect to ZooKeeper and inspect a running
+      server. Once you've started ZooKeeper using QuorumPeerMain
+      start <em>jconsole</em>, which typically resides in
+      <em>JDK_HOME/bin/jconsole</em>
+</p>
+<p>When the "new connection" window is displayed either connect
+      to local process (if jconsole started on same host as Server) or
+      use the remote process connection.</p>
+<p>By default the "overview" tab for the VM is displayed (this
+      is a great way to get insight into the VM btw). Select
+      the "MBeans" tab.</p>
+<p>You should now see <em>org.apache.ZooKeeperService</em>
+      on the left hand side. Expand this item and depending on how you've
+      started the server you will be able to monitor and manage various
+      service related features.</p>
+<p>Also note that ZooKeeper will register log4j MBeans as
+    well. In the same section along the left hand side you will see
+    "log4j". Expand that to manage log4j through JMX. Of particular
+    interest is the ability to dynamically change the logging levels
+    used by editing the appender and root thresholds. Log4j MBean
+    registration can be disabled by passing
+    <em>-Dzookeeper.jmx.log4j.disable=true</em> to the JVM
+    when starting ZooKeeper.
+    </p>
+</div>
+
+  
+<a name="N1005F"></a><a name="ch_reference"></a>
+<h2 class="h3">ZooKeeper MBean Reference</h2>
+<div class="section">
+<p>This table details JMX for a server participating in a
+    replicated ZooKeeper ensemble (ie not standalone). This is the
+    typical case for a production environment.</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<caption>MBeans, their names and description</caption>
+      
+<title>MBeans, their names and description</title>
+
+      
+          
+<tr>
+            
+<th>MBean</th>
+            <th>MBean Object Name</th>
+            <th>Description</th>
+          
+</tr>
+        
+          
+<tr>
+            
+<td>Quorum</td>
+            <td>ReplicatedServer_id&lt;#&gt;</td>
+            <td>Represents the Quorum, or Ensemble - parent of all
+            cluster members. Note that the object name includes the
+            "myid" of the server (name suffix) that your JMX agent has
+            connected to.</td>
+          
+</tr>
+          
+<tr>
+            
+<td>LocalPeer|RemotePeer</td>
+            <td>replica.&lt;#&gt;</td>
+            <td>Represents a local or remote peer (ie server
+            participating in the ensemble). Note that the object name
+            includes the "myid" of the server (name suffix).</td>
+          
+</tr>
+          
+<tr>
+            
+<td>LeaderElection</td>
+            <td>LeaderElection</td>
+            <td>Represents a ZooKeeper cluster leader election which is
+            in progress. Provides information about the election, such as
+            when it started.</td>
+          
+</tr>
+          
+<tr>
+            
+<td>Leader</td>
+            <td>Leader</td>
+            <td>Indicates that the parent replica is the leader and
+            provides attributes/operations for that server. Note that
+            Leader is a subclass of ZooKeeperServer, so it provides
+            all of the information normally associated with a
+            ZooKeeperServer node.</td>
+          
+</tr>
+          
+<tr>
+            
+<td>Follower</td>
+            <td>Follower</td>
+            <td>Indicates that the parent replica is a follower and
+            provides attributes/operations for that server. Note that
+            Follower is a subclass of ZooKeeperServer, so it provides
+            all of the information normally associated with a
+            ZooKeeperServer node.</td>
+          
+</tr>
+          
+<tr>
+            
+<td>DataTree</td>
+            <td>InMemoryDataTree</td>
+            <td>Statistics on the in memory znode database, also
+            operations to access finer (and more computationally
+            intensive) statistics on the data (such as ephemeral
+            count). InMemoryDataTrees are children of ZooKeeperServer
+            nodes.</td>
+          
+</tr>
+          
+<tr>
+            
+<td>ServerCnxn</td>
+            <td>&lt;session_id&gt;</td>
+            <td>Statistics on each client connection, also
+            operations on those connections (such as
+            termination). Note the object name is the session id of
+            the connection in hex form.</td>
+          
+</tr>
+    
+</table>
+<p>This table details JMX for a standalone server. Typically
+    standalone is only used in development situations.</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<caption>MBeans, their names and description</caption>
+      
+<title>MBeans, their names and description</title>
+
+      
+          
+<tr>
+            
+<th>MBean</th>
+            <th>MBean Object Name</th>
+            <th>Description</th>
+          
+</tr>
+        
+          
+<tr>
+            
+<td>ZooKeeperServer</td>
+            <td>StandaloneServer_port&lt;#&gt;</td>
+            <td>Statistics on the running server, also operations
+            to reset these attributes. Note that the object name
+            includes the client port of the server (name
+            suffix).</td>
+          
+</tr>
+          
+<tr>
+            
+<td>DataTree</td>
+            <td>InMemoryDataTree</td>
+            <td>Statistics on the in memory znode database, also
+            operations to access finer (and more computationally
+            intensive) statistics on the data (such as ephemeral
+            count).</td>
+          
+</tr>
+          
+<tr>
+            
+<td>ServerCnxn</td>
+            <td>&lt;session_id&gt;</td>
+            <td>Statistics on each client connection, also
+            operations on those connections (such as
+            termination). Note the object name is the session id of
+            the connection in hex form.</td>
+          
+</tr>
+    
+</table>
+</div>
+
+
+<p align="right">
+<font size="-2"></font>
+</p>
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+        Copyright &copy;
+         2008 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: hadoop/zookeeper/trunk/docs/zookeeperJMX.pdf
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperJMX.pdf?rev=738323&view=auto
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperJMX.pdf (added)
+++ hadoop/zookeeper/trunk/docs/zookeeperJMX.pdf Wed Jan 28 00:42:16 2009
@@ -0,0 +1,322 @@
+%PDF-1.3
+%ª«¬­
+4 0 obj
+<< /Type /Info
+/Producer (FOP 0.20.5) >>
+endobj
+5 0 obj
+<< /Length 523 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+Gb!#X]5GJN&FB?1>=+Is4oHcr'FH%A&/S1bKn2$^,!KI0&:YeZ3Tf[a#b%F=Kg"V0=jPl<#I/J9jM1m2Lf9A%a35d4n0jC`V@].Q?P):I#k:!hoU`J)=)+jp5$Y?8X?QAJj/5)R5s2Gf;(^?rO?Q1,Ik+4e#Bg)H*2<muK[Q;1-e">9`ME=Ze#@\dl+Bu@\N/kFTVSVY#r@0l+r@O#Uhr0i6+?_QFR.5<_gcXYe<-4n5`_IZ:,p\A$9RXf9n+^XU<N1^$bUQUp!PHCQO_]Q)PD+lFS!7<cP3A4f&gpH$mHB&288k-(cq<22KtaU?bBFA\C%0L0A\/.5>Xu<./^EWn9k]`F5h9WD>KA!(_9To$>?/3<N(:gM(#C(SCPn&*00\Ep-.gSZa5=J!!<PErZ+9OThphs&)P)15Bb,(@*":$2uBP<)#4dgN\[R#hs0mKa;2tI%DPskWC)W+d%P]`*4T-!ZSm9^Bt6lof#gg-o6F5G3lfg[e]InsHdfiHUP_i)7q_c.r/`j7~>
+endstream
+endobj
+6 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 5 0 R
+/Annots 7 0 R
+>>
+endobj
+7 0 obj
+[
+8 0 R
+10 0 R
+12 0 R
+14 0 R
+]
+endobj
+8 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 102.0 529.541 134.0 517.541 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 9 0 R
+/H /I
+>>
+endobj
+10 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 102.0 511.341 296.636 499.341 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 11 0 R
+/H /I
+>>
+endobj
+12 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 102.0 493.141 204.992 481.141 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 13 0 R
+/H /I
+>>
+endobj
+14 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 102.0 474.941 253.94 462.941 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A 15 0 R
+/H /I
+>>
+endobj
+16 0 obj
+<< /Length 2468 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+Gat%%=``=e%"?g3i:nVl9LG#eje9`)NROcba^It@G<.6g,r2@-$kFl2Y:k,Q^dD-M1C9BkJ-GYa#@M]GYdhF?%@`iQnZZ;$`bo3((AtFsV$6<Mm[1HC)%V)Smn;EJ10ucGH@PbimZ/mY+62>YipFYC.gT.,mhUnE_p-!g$snG[g1F",1GW[G(7u@$PsO$+=_!O3A%'MX`n$VYX@&uSrMA#I;Pl4uY<nB;L&=um,`eOZ87&0mapS)VX"r\M%sfP]=<4,HVr&IoW>C9:cd._9+MhT`(OM:#*SQ'X6U\Vp!gC#u:3`&Im$VYmglhP7/BoVTDW%!bX6_!g:d?pR?1)9Ug_Y5GDpTk#.#Jmt6\-Jm&p^k8bGR`K@_'=HW\'&Y!m83@(b!YcNR.'P"c),E\fUY)RXoDD%F-QS@mTi52CpY'IH+_j2o'-=Z^oJK60lm;\1a%+Mpt"'d5bo\XM>]%nGJIWqL/'hHCog(_If`I0]SdcbXd:LE7AG_`/21?cX%1A9!6'"`G0U5[l\%*f68^Hp"(Y7!1Z#1M9qP)+tFq]SO6A06OZ]Ih.<J8S[67h_E"":Q0V(^h6#@ADqOQ0?CV*RX[ASM5JD]"as'&aENF[h"j@09E'C=qhe+U@pN]i(;F:VOgDq[ICWnhRD5;]2%gr*[>l+'kG2(Q!HFrXgBHnmT`o*=UVuDtnqF25EM@mP$"LDi?&6:A]r>_lGLhA,!PC$<N+iRAhXiPD^Wm7oRB#!0dYG26)T<)Ua8Fko!rRcu_/dB\Rdd+Eu</FOX]Y=&.[?ULSH(kaqJ%CEH+u;"cHc^7BFr\!5IO*TI;%hLU3#fN0pq4W*Cs(p/\<tm77H/;,,u9mV`e=kcN(aB(b&a&&F&)K"E[?bR@tJMM?`S:G&/KCSSoE5'H?/DcH+Yp0K@0W7&`WmJ\]#IIL.c@%V$,TfIDq"LLG@Q-p2f$PcigYWTCX1pcY;Q%I->dfirb=p3egu%"G1IqkV`^
 F#*nRL;0R`VGGUmGpWU99p"*)Qjkfo7s79+1lqTsj$(u@o2OVUbJO:+r+P-dSZuY3XQb(@ge*V675b_)FC%bs3q??9Fg,NfRm\7@U=Zur,1fHg>h2N*TD@+LFTHm.(6H%8q;+-d%X)seL&"7gBF)R:C"Aa@JMA<NVd3juHFGB<(^7=O=VpOHT*Rg_Z>t)m.Gne?5A_g/qEP`SCOd#<d::-XXj>X>>iu)%AcUl_D-XT\\^IT(Lr6;pJfo1P-pUNu[1#9`B-+Sop/0?i:7.rD"pjhlaL1_'Lirs&A&Ju'GL.A(6:2VU3pF@5M_4WO:1kN>aL44ZMi$"'1L]uBS+USjmSgc/mO]e(tjE*k*Hs6V`N"O*aqUu+G+K7OkbQ0pAAh%lo?SLiZ3^okR7NNN<9MBr0-TlNZ/?%VHQ()U3*QSqT:)0<1S,cakoIGf$(o969&/Q]>PXdP[dl?a2,5/C&TdJ<0rORK#*62Toh*!"i]R_?mhOHA-BJ%<i5r`l9at9[%J\F@&_NcAO]qKD8Ld'/qlP,tEn-$iE;?i^eM6Qb>M#RG`:$rX#OfOl.Zo?<U'/!I>Blu$<9DkGfcf]i_7D\\rZ?,Se=)s8BTo5\^=Vf%7JpnOqaI17\U<.DJ:DGP?L#PP&6/qh>o7sref2WPIA'9#A=Q!nrrB6CT^>g3H8FUIs$Qs*f/oYhX)hgI"[nKYj`o;f8<^JG!F$0iP_=R^J$k,Trs5R[D#_1bpFkCmp;2t'7AjKf2]a@b7m`9@6;.9Cm$>CZ&*Ss!(%2C+cFHe-Z[@22aXuLnd]MQr)eY,*uUFX8tB(@+>A3<#'\rVKTKqArclnXFd((]CaIK&;&#T+uDL#g30kqSQ$RBE;@Sudf:4]Ub<N%#6.oU9B[`btWtCm:E=i_.`_<+V"tQ/Jac:\LkJW:llX'BNoel1qUdA[FXdrXK(O@sjqa0)oFl73Mt/7AtG=`UE3'<7!@e!25MOa`(Bf'+pAaJ3V
 /1PSLjU&4c3.JjO,@3cg/M>Vh*"/aX9-9\YD9VK-k3raY-YV6*>R=_*XEF1TV09pd.@`2bJ#;45s972*gl9Cp)k3*-rB"^rdKMj&>e3$d=IM-5/F^ZacuY/I,]OE$45o?/-A-jf&G*?pcR_RRt%]/0T9NV,F'&sCRm6]UW"05A6T:8WQ/.;ZnoJd*AL_G$6,d=lf%9qe;J<n$'>N5ajK@<8TX*;C/$.U:;o\[qpJMW1S%@HG`G3pC&pZ\FS0k%YsI[j.:\b@cYb@qdU.6@.`?U=1gPB3LFNb^.-97UU6lZ272Xcs4Jt*ReWDM'(=HWb;(YkXWgr;/_&"q53Vho;lLY\!gp<h)&mX/QVUi:>cs^?oGbWpp!!LhA/I?[]P:Y@D6,5GL:eG_g&T]>U/12GIp`FUIpSM<s\btY.DibonlmQTNCO%eL^@=VTnsDD2UbC>;pJ<<LIYkgO/X&9b'"<g3/M-ZKBVqWFPZEar_Op~>
+endstream
+endobj
+17 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 16 0 R
+/Annots 18 0 R
+>>
+endobj
+18 0 obj
+[
+19 0 R
+20 0 R
+21 0 R
+]
+endobj
+19 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 421.956 595.266 527.952 583.266 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/)
+/S /URI >>
+/H /I
+>>
+endobj
+20 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 127.992 560.866 249.972 548.866 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html)
+/S /URI >>
+/H /I
+>>
+endobj
+21 0 obj
+<< /Type /Annot
+/Subtype /Link
+/Rect [ 357.972 342.598 397.968 330.598 ]
+/C [ 0 0 0 ]
+/Border [ 0 0 0 ]
+/A << /URI (http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html)
+/S /URI >>
+/H /I
+>>
+endobj
+22 0 obj
+<< /Length 2172 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+GauHNCN%rc'`IH,+`(L(TOpTSe-">-ZthJ!9=I*D@G!=DZ:*I4AC6V%VA]*f7m0GsPUP,9=sT1LP5!gScTRVZr-Yns\Q\p=JC^%dI('At?sBf"o&#g6f1Ubt[W6,b(N1,9=,ZA`@R5eL@C97jod$%,LK63n35Dr,[G"j"4UJIib$$k!.Sk*)8o[r#Ea%g3)AbYdGg!PjK=H@.S;*H=!8StjR>5@jUe`4\aI8"P3%;^e8gP#!&*!Es(.FC'YH6W`eLM](gP7To#6b*Oi@J@6c.JYQ*bZ$Ilp$'.EYl*+^+T"%m?]&1b;l`G=7V+sQ:sb9ErOV8YJncbN_2#AAXJglleNr'1A4)q<H$d$+BF2+qnPR:@iPTi&u4[*UDoZN/F$\DE5o<eG2809fX!jt6CWO)`:nfL2*S-c8KgAt!@q`GQ=5qKIt..f(NHciP4PB#(X51eE?-P(U>ujq5tj&qm$o-F,RR247gcJ6<m^f\ft/VgFI-"_YAkM9mNLMtU%>p/EL=%jhH`^@)'Uh$7j^q*E8YW2Ea9AY&'c>2nM(q_'[8fg3Qq+Q.tO4,)u)>ka&Ci#eVPXhE=!aMnIPq*iaDg,+sm5!Z=41%5CEAu3Sk:HnX':Zh0Pk!g\'+W*Fq.'EMsh[E9R-&>0u]).g3$obGPo'!:nm=C9(qb2$]VgVOB;tRkYDo(hp'=:5GMQ83iD9/KN0@B_U!P"-#oms'rR:3Zug_n4toS&kHM;Lb\I($?e[D^3"<$j9o-ZH#dSu==MOnM_@47]rjaNgej=bjuN.iGWcRN.s1dcg7<]&_O\Lq"BW;^"CTjEhB#gKgoHN6&Qf-pT(<a&MbLt*3ct3B`+RH0latpK\kE$b`*[rgN=%-M75[p+=aa`B`"ZB,OZKGf3K#jrI)jBV@Nd"smD-t@6aN]MK<"#C>(4(5(B_E&h3ZR(Tp`;&Q[G^Jm7@\'`-%HEi[.9Y77g"nn]p6>60u-:RQ"I=<b5E*jab3
 g,WsZ#ZbchT![1$9/_f*_,icVXF:>K/p('amKf[(sTZW_lMl_`Z>r1a5`-u^]Cm%S<=(<C;YbN*pm("<5m67jFIQL*C/sLsG=I*rkRa#;WO+C/**`@!<-r5t,--@WTqBe$hPin+2h<B\je5?ArE<Q_g);hF-Teuf4*Skf9<L;b:C]oo-%5/,/RDOjEimc'@!3#V\!@B\W#Tp__?5P=M`H*qucoI4fRN.4.PdMk_TuYu3?5$+?q,P>t.fVbhlB96BEhY^0#KojDeRf@.1,]]_mO[$4")$o+b(Sd\%:^d?lWH9N=qj;c!3L^2@FaVLb(+=:r&aiuf?b[`Q7g`15,[&1'N)mQ[bJ%>F_;[X%43nAFlRU"ML8Wik*C`Vc!R>))Vb(g`(,TE?Ec$k)&\'akCV2sW$+b_$.>NCQ`Wo5-H<:8V@krQP"&$>-XM[f79)G6.^n5mp*s;p5a&T?(#:83]-Q*%>#_H&&5NR-,#(;_Cs/B9GI;@0p+`Q.9XPFTKtnteL?8;OkYSd$a0C&3kPeEQg5&:he"[nK]MImckdCLb[d'd&1nN(+6%YGShkYKhmNs?UOup_SHd4q3f%7XPK\E,K]N4GC(<!e$Gr.!l-G\gkjjH\^0p[&:2Qb-H"%OXF)K>=@EbVVn(sUaP60HJf5)\`^*6$tCC@'I+DSjrcDBh`:`_O(B$J<'.ld]cUWgp**FCBi6R4%;FO5l[K.BYO$1:`PA[nV7M'n(=QHCh[j]KM)q)7Bm;/N454.$!UA%1?m5]NOS?9_05r/ZoTR"kj,Y$`Lj>q5@iL'*\\gRKemS+/S4SXR67MP3+oiC.[Inf^G#E2o';6"kd3Ua'6Eb/EX<mWBsLj"R#u#/\tg]m8-#Rf+K&o"K-->R^2giVI0Od?@abh'cEd'kG$E^L"Yso"EdaL0S%2'>%3HRD"=6?pAB,O_6L8V/VLE7GKDRX$SXi,g_QROHtHTm3K$8^(nbM+C1Dc>pg4pA`;X
 7*#)Kq4C(/]QNo^@jpAG=/,/?jI0erIkK'.^#F.N#_'[j&57[C+Go70?bDfjXLj(J$c>\/qNja4,;2rU&4$mEaEmZfirK&^8`^K;id">6s,bT2J`;W"dt6_8+<;F^*p!l^^?gV11%agM$4&4Z6hHaYBlGs0>%5%\f*98WAgA:E%:-1Y$UAY';*V"QI[b#*o~>
+endstream
+endobj
+23 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 22 0 R
+>>
+endobj
+24 0 obj
+<< /Length 1910 /Filter [ /ASCII85Decode /FlateDecode ]
+ >>
+stream
+Gau0F>Ap9+'Roe[5jCud,qO,t;QVEcG.Ub`8hZ&DW]&Cb^c84.K*sY5qWg3F$k-_V1NJZ"(;sitcM9H_4.#_S^&!2kqI]u%8,i?n'mZtFpqG)30bN$h3:pLK3$i\g<kkbSVXfD`'E/J\,ijLm\Srb]\Y7&npo;FC^gC>mUQl<6/k60Z>7*Xr5e"@3*[8c2NB0sDUX-Qu^]=Lmok*;C7XP%L3"Zp<&EG&!XEVs^(SB\J?C-m_3e'0U04U4h[YAM-A/6P.]9+tVGQB7M%)g35r5`d?XsdZ>+@>dn1gMjEOgW0H)Ug!FOq==DpY=;=SQ0fu<0tlf$pq\pU0tl]]qrV@VL5U`OR3TBg)i]6$ekRZ@n!EaORadh&6JL=pf!\aKmjuZ/aUt<p9`n<(/.T3/sK(nKN?6.RuGa8\@oY5=fO[hE3)-,\Nu+Q8[7"llK6GQcX0WcC<ERCM;DV)\+INYhT?%/!KO1$F\&ruM3[ck&d:GNFMFY6%TKT7EFAJ<V5mrBOriTB=A]cm9<)>?i#]L@S)n?U("8&bE;`:(r'Vu`L3L"P&e@I@Rm2.oE14r"L$R7;Y6,Alo<^^q)EQ`q>jJ$l]c_81=l3>od7$[RKP?>L7f@sV@Je-;fkHb]!G.Blca+9fU507uBc14\k'b4dSk&"r/H+un]A#TWaJJ(Q8h?)]FW!%/R0DlLZ-"[jSl&PS!u$6W-'Ej7RKuZY0R/)%L8kWYh\g`'J^iGK)R6J.W3W<hT"cS8e?n"BXO3qS6+QXNU8B;O\9Re<T<-id7q%H3Mg&oNXA8-53N+-il8c.QV)smm_,L.%8U3t$PoNnj43=2b4sL<J[[NH8K+PXKnf@'e/k3?6@3%SnMY>u_iVN8&`iQ`iBq-VD<WJk+%Ajubkr^E$IB.Xk&Xd=^1]`t/(D3Xl[KX*R#qftl>^Msg3mMd-o.RSf%l`;Ai?fTuGtM[_S/4lPWG;4Y*WE9lfk6.8qkr&Faq[U85#a@
 =jGs2R[?P_5OHud9M<;d+f0j%sAl^#-=;iL'JKNrQQPctUR>*cRTHP5U0Z]3c-1Mp7B[RD/Mmp:)dL4;2:mrON$b-Fod.P#TCqOirX=iPcTVYe#Oto`45aLp!H,098l%^mJL^kRGR_Nrdf/$pSC\.<EHZ.@a1!-JnJ.PA`(E?30-UKXN_XGs,bGH#S](<=j%H?lQ._7<%QuJ(%"F]/M%aF)SAYch*S&m&[nW\jAoV=/3279Fn4A2i+VSU=h:qV>*\6)bi\a)%BMpL"';:b3NR42BXE*@;H1[QNt\1W'T\B6hKah2=?%ub)d;(]9\[TD0d$AF$=\hIHn>1EX@8Lmu*<2fHN)WL-Qe/8nNFdYB4lDBn2<I)UW$-QrG:rIduf@Q]IaU]g`<K5-V?eu/$*1*G3dg562bu&?4LA=Z<O-Q[SRn`T=9HU,o3V!]E:4C3VF@7SK?YJ<<)iHYd8ElsG*[0$[h=@r(#*MD13mUE/M'4cFV5$K`(@t,"%6TOgFIp1a&ku<&5ngGIM^^7;-'BOR1T%NM,b3ePVmJ.8H3S\l.4ktG*o=Aud_`fg_-W_]:3gm@2'tFGj(:?D";-lDh1R/8`>`*YoFaqdiqKTd1@_^PAW`J-ZP-K9L^e?<R8O4.CuT.2bp"g3B.L5TdaVjTe7W*'iX'nM^i)!uKF%=Ro842W#[pL^Y<29-!1^&Ghe_9Y4\l1[.o&2mLg9De`"TlD`"P2Ea\`ei60'4TS,i%`&#5mP]%JWRUVMZ@Cf?bE[,f@gnH/6qJbD_MhRFjFA$_pD#sS`M8.]YUF9hd`5LRq^=OFYY%Y>Y:!#'MM7X1ik'8M2I+DA7\=R9D;luB'_(&*di"^]L_LV'tZ2]q`U5*c#W@T3:GX3(>s:QoMQfns-daH]0IS?4mddC/R5Ot)mmIiSWmV>~>
+endstream
+endobj
+25 0 obj
+<< /Type /Page
+/Parent 1 0 R
+/MediaBox [ 0 0 612 792 ]
+/Resources 3 0 R
+/Contents 24 0 R
+>>
+endobj
+27 0 obj
+<<
+ /Title (\376\377\0\61\0\40\0\112\0\115\0\130)
+ /Parent 26 0 R
+ /Next 28 0 R
+ /A 9 0 R
+>> endobj
+28 0 obj
+<<
+ /Title (\376\377\0\62\0\40\0\123\0\164\0\141\0\162\0\164\0\151\0\156\0\147\0\40\0\132\0\157\0\157\0\113\0\145\0\145\0\160\0\145\0\162\0\40\0\167\0\151\0\164\0\150\0\40\0\112\0\115\0\130\0\40\0\145\0\156\0\141\0\142\0\154\0\145\0\144)
+ /Parent 26 0 R
+ /Prev 27 0 R
+ /Next 29 0 R
+ /A 11 0 R
+>> endobj
+29 0 obj
+<<
+ /Title (\376\377\0\63\0\40\0\122\0\165\0\156\0\40\0\141\0\40\0\112\0\115\0\130\0\40\0\143\0\157\0\156\0\163\0\157\0\154\0\145)
+ /Parent 26 0 R
+ /Prev 28 0 R
+ /Next 30 0 R
+ /A 13 0 R
+>> endobj
+30 0 obj
+<<
+ /Title (\376\377\0\64\0\40\0\132\0\157\0\157\0\113\0\145\0\145\0\160\0\145\0\162\0\40\0\115\0\102\0\145\0\141\0\156\0\40\0\122\0\145\0\146\0\145\0\162\0\145\0\156\0\143\0\145)
+ /Parent 26 0 R
+ /Prev 29 0 R
+ /A 15 0 R
+>> endobj
+31 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F3
+/BaseFont /Helvetica-Bold
+/Encoding /WinAnsiEncoding >>
+endobj
+32 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F5
+/BaseFont /Times-Roman
+/Encoding /WinAnsiEncoding >>
+endobj
+33 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F6
+/BaseFont /Times-Italic
+/Encoding /WinAnsiEncoding >>
+endobj
+34 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F1
+/BaseFont /Helvetica
+/Encoding /WinAnsiEncoding >>
+endobj
+35 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F2
+/BaseFont /Helvetica-Oblique
+/Encoding /WinAnsiEncoding >>
+endobj
+36 0 obj
+<< /Type /Font
+/Subtype /Type1
+/Name /F7
+/BaseFont /Times-Bold
+/Encoding /WinAnsiEncoding >>
+endobj
+1 0 obj
+<< /Type /Pages
+/Count 4
+/Kids [6 0 R 17 0 R 23 0 R 25 0 R ] >>
+endobj
+2 0 obj
+<< /Type /Catalog
+/Pages 1 0 R
+ /Outlines 26 0 R
+ /PageMode /UseOutlines
+ >>
+endobj
+3 0 obj
+<< 
+/Font << /F3 31 0 R /F5 32 0 R /F1 34 0 R /F6 33 0 R /F2 35 0 R /F7 36 0 R >> 
+/ProcSet [ /PDF /ImageC /Text ] >> 
+endobj
+9 0 obj
+<<
+/S /GoTo
+/D [17 0 R /XYZ 85.0 659.0 null]
+>>
+endobj
+11 0 obj
+<<
+/S /GoTo
+/D [17 0 R /XYZ 85.0 498.266 null]
+>>
+endobj
+13 0 obj
+<<
+/S /GoTo
+/D [17 0 R /XYZ 85.0 406.332 null]
+>>
+endobj
+15 0 obj
+<<
+/S /GoTo
+/D [23 0 R /XYZ 85.0 624.6 null]
+>>
+endobj
+26 0 obj
+<<
+ /First 27 0 R
+ /Last 30 0 R
+>> endobj
+xref
+0 37
+0000000000 65535 f 
+0000010806 00000 n 
+0000010885 00000 n 
+0000010977 00000 n 
+0000000015 00000 n 
+0000000071 00000 n 
+0000000685 00000 n 
+0000000805 00000 n 
+0000000851 00000 n 
+0000011111 00000 n 
+0000000984 00000 n 
+0000011174 00000 n 
+0000001121 00000 n 
+0000011240 00000 n 
+0000001258 00000 n 
+0000011306 00000 n 
+0000001394 00000 n 
+0000003955 00000 n 
+0000004078 00000 n 
+0000004119 00000 n 
+0000004343 00000 n 
+0000004569 00000 n 
+0000004789 00000 n 
+0000007054 00000 n 
+0000007162 00000 n 
+0000009165 00000 n 
+0000011370 00000 n 
+0000009273 00000 n 
+0000009382 00000 n 
+0000009694 00000 n 
+0000009899 00000 n 
+0000010139 00000 n 
+0000010252 00000 n 
+0000010362 00000 n 
+0000010473 00000 n 
+0000010581 00000 n 
+0000010697 00000 n 
+trailer
+<<
+/Size 37
+/Root 2 0 R
+/Info 4 0 R
+>>
+startxref
+11421
+%%EOF

Modified: hadoop/zookeeper/trunk/docs/zookeeperOver.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperOver.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperOver.html (original)
+++ hadoop/zookeeper/trunk/docs/zookeeperOver.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">

Modified: hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html (original)
+++ hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">

Modified: hadoop/zookeeper/trunk/docs/zookeeperStarted.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperStarted.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperStarted.html (original)
+++ hadoop/zookeeper/trunk/docs/zookeeperStarted.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">

Modified: hadoop/zookeeper/trunk/docs/zookeeperTutorial.html
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperTutorial.html?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/zookeeperTutorial.html (original)
+++ hadoop/zookeeper/trunk/docs/zookeeperTutorial.html Wed Jan 28 00:42:16 2009
@@ -140,6 +140,9 @@
 <div class="menuitem">
 <a href="zookeeperAdmin.html">Administrator's Guide</a>
 </div>
+<div class="menuitem">
+<a href="zookeeperJMX.html">JMX</a>
+</div>
 </div>
 <div onclick="SwitchMenu('menu_1.4', 'skin/')" id="menu_1.4Title" class="menutitle">Contributor</div>
 <div id="menu_1.4" class="menuitemgroup">

Modified: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/index.xml
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/index.xml?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/index.xml (original)
+++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/index.xml Wed Jan 28 00:42:16 2009
@@ -24,17 +24,21 @@
   </header>
   
   <body>
-    <p>
-ZooKeeper is a high-performance coordination service for distributed applications. 
-It exposes common services - such as naming, configuration management, synchronization, 
-and group services - in a simple interface so you don't have to write them from scratch. 
-You can use it off-the-shelf to implement consensus, group management, leader election, 
-and presence protocols. And you can build on it for your own, specific needs.
-</p>
+    <p>ZooKeeper is a high-performance coordination service for
+      distributed applications.  It exposes common services - such as
+      naming, configuration management, synchronization, and group
+      services - in a simple interface so you don't have to write them
+      from scratch.  You can use it off-the-shelf to implement
+      consensus, group management, leader election, and presence
+      protocols. And you can build on it for your own, specific needs.
+    </p>
 
-<p>
-The following documents describe concepts and procedures to get you started using ZooKeeper. If you have more questions, please ask the <a href="ext:lists">mailing list</a> or browse the archives.
-</p>
+    <p>
+      The following documents describe concepts and procedures to get
+      you started using ZooKeeper. If you have more questions, please
+      ask the <a href="ext:lists">mailing list</a> or browse the
+      archives.
+    </p>
     <ul>
 
       <li><strong>ZooKeeper Overview</strong><p>Technical Overview Documents for Client Developers, Adminstrators, and Contributors</p>
@@ -56,7 +60,8 @@
       
       <li><strong>Administrators &amp; Operators</strong> <p> Documents for Administrators and Operations Engineers of ZooKeeper Deployments</p>
       <ul>
-      <li><a href="zookeeperAdmin.html">Administrator's Guide</a> - a guide for system administrators and anyone else who might deploy Zookeeer</li>
+      <li><a href="zookeeperAdmin.html">Administrator's Guide</a> - a guide for system administrators and anyone else who might deploy ZooKeeper</li>
+      <li><a href="zookeeperJMX.html">JMX</a> - how to enable JMX in ZooKeeper</li>
       </ul>
       </li>
       

Modified: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/site.xml?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/site.xml (original)
+++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/site.xml Wed Jan 28 00:42:16 2009
@@ -47,7 +47,8 @@
   </docs>
   
   <docs label="Admin &amp; Ops">
-      <admin     label="Administrator's Guide"  href="zookeeperAdmin.html" />
+      <admin label="Administrator's Guide"  href="zookeeperAdmin.html" />
+      <jmx   label="JMX"                    href="zookeeperJMX.html" />
   </docs>
   
   <docs label="Contributor">

Modified: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml?rev=738323&r1=738322&r2=738323&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml (original)
+++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml Wed Jan 28 00:42:16 2009
@@ -193,11 +193,25 @@
         </listitem>
 
         <listitem>
-          <para>If your configuration file is set up, you can start
-          ZooKeeper:</para>
+          <para>If your configuration file is set up, you can start a
+          ZooKeeper server:</para>
+
+          <para><computeroutput>$ java -cp zookeeper.jar:lib/log4j-1.2.15.jar:conf \
+              org.apache.zookeeper.server.quorum.QuorumPeerMain zoo.cfg
+          </computeroutput></para>
+          
+          <para>QuorumPeerMain starts a ZooKeeper server,
+            <ulink url="http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/">JMX</ulink>
+            management beans are also registered which allows
+            management through a JMX management console. 
+            The <ulink url="zookeeperJMX.html">ZooKeeper JMX
+            document</ulink> contains details on managing ZooKeeper with JMX.
+          </para>
+
+          <para>See the script <emphasis>bin/zkServer.sh</emphasis>,
+            which is included in the release, for an example
+            of starting server instances.</para>
 
-          <para><computeroutput>$ java -cp zookeeper.jar:src/java/lib/log4j-1.2.15.jar:conf \
-        org.apache.zookeeper.server.quorum.ManagedQuorumPeerMain zoo.cfg</computeroutput></para>
         </listitem>
 
         <listitem>

Added: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperJMX.xml
URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperJMX.xml?rev=738323&view=auto
==============================================================================
--- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperJMX.xml (added)
+++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperJMX.xml Wed Jan 28 00:42:16 2009
@@ -0,0 +1,236 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 2002-2004 The Apache Software Foundation
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+
+<!DOCTYPE article PUBLIC "-//OASIS//DTD Simplified DocBook XML V1.0//EN"
+"http://www.oasis-open.org/docbook/xml/simple/1.0/sdocbook.dtd">
+<article id="bk_zookeeperjmx">
+  <title>ZooKeeper JMX</title>
+
+  <articleinfo>
+    <legalnotice>
+      <para>Licensed under the Apache License, Version 2.0 (the "License");
+      you may not use this file except in compliance with the License. You may
+      obtain a copy of the License at <ulink
+      url="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</ulink>.</para>
+
+      <para>Unless required by applicable law or agreed to in writing,
+      software distributed under the License is distributed on an "AS IS"
+      BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied. See the License for the specific language governing permissions
+      and limitations under the License.</para>
+    </legalnotice>
+
+    <abstract>
+      <para>ZooKeeper support for JMX</para>
+    </abstract>
+  </articleinfo>
+
+  <section id="ch_jmx">
+    <title>JMX</title>
+    <para>Apache ZooKeeper has extensive support for JMX, allowing you
+    to view and manage a ZooKeeper serving ensemble.</para>
+
+    <para>This document assumes that you have basic knowledge of
+    JMX. See <ulink
+    url="http://java.sun.com/javase/technologies/core/mntr-mgmt/javamanagement/">
+    Sun JMX Technology</ulink> page to get started with JMX.
+    </para>
+
+    <para>See the <ulink
+    url="http://java.sun.com/javase/6/docs/technotes/guides/management/agent.html">
+    JMX Management Guide</ulink> for details on setting up local and
+    remote management of VM instances. By default the included
+    <emphasis>zkServer.sh</emphasis> supports only local management -
+    review the linked document to enable support for remote management
+    (beyond the scope of this document).
+    </para>
+
+  </section>
+
+  <section id="ch_starting">
+    <title>Starting ZooKeeper with JMX enabled</title>
+
+    <para>The class
+      <emphasis>org.apache.zookeeper.server.quorum.QuorumPeerMain</emphasis>
+      will start a JMX manageable ZooKeeper server. This class
+      registers the proper MBeans during initalization to support JMX
+      monitoring and management of the
+      instance. See <emphasis>bin/zkServer.sh</emphasis> for one
+      example of starting ZooKeeper using QuorumPeerMain.</para>
+  </section>
+
+  <section id="ch_console">
+    <title>Run a JMX console</title>
+
+    <para>There are a number of JMX consoles available which can connect
+      to the running server. For this example we will use Sun's
+      <emphasis>jconsole</emphasis>.</para>
+
+    <para>The Java JDK ships with a simple JMX console
+      named <ulink url="http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html">jconsole</ulink>
+      which can be used to connect to ZooKeeper and inspect a running
+      server. Once you've started ZooKeeper using QuorumPeerMain
+      start <emphasis>jconsole</emphasis>, which typically resides in
+      <emphasis>JDK_HOME/bin/jconsole</emphasis></para>
+
+    <para>When the "new connection" window is displayed either connect
+      to local process (if jconsole started on same host as Server) or
+      use the remote process connection.</para>
+
+    <para>By default the "overview" tab for the VM is displayed (this
+      is a great way to get insight into the VM btw). Select
+      the "MBeans" tab.</para>
+
+    <para>You should now see <emphasis>org.apache.ZooKeeperService</emphasis>
+      on the left hand side. Expand this item and depending on how you've
+      started the server you will be able to monitor and manage various
+      service related features.</para>
+
+    <para>Also note that ZooKeeper will register log4j MBeans as
+    well. In the same section along the left hand side you will see
+    "log4j". Expand that to manage log4j through JMX. Of particular
+    interest is the ability to dynamically change the logging levels
+    used by editing the appender and root thresholds. Log4j MBean
+    registration can be disabled by passing
+    <emphasis>-Dzookeeper.jmx.log4j.disable=true</emphasis> to the JVM
+    when starting ZooKeeper.
+    </para>
+
+  </section>
+
+  <section id="ch_reference">
+    <title>ZooKeeper MBean Reference</title>
+
+    <para>This table details JMX for a server participating in a
+    replicated ZooKeeper ensemble (ie not standalone). This is the
+    typical case for a production environment.</para>
+
+    <table>
+      <title>MBeans, their names and description</title>
+
+      <tgroup cols='4'>
+        <thead>
+          <row>
+            <entry>MBean</entry>
+            <entry>MBean Object Name</entry>
+            <entry>Description</entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>Quorum</entry>
+            <entry>ReplicatedServer_id&lt;#&gt;</entry>
+            <entry>Represents the Quorum, or Ensemble - parent of all
+            cluster members. Note that the object name includes the
+            "myid" of the server (name suffix) that your JMX agent has
+            connected to.</entry>
+          </row>
+          <row>
+            <entry>LocalPeer|RemotePeer</entry>
+            <entry>replica.&lt;#&gt;</entry>
+            <entry>Represents a local or remote peer (ie server
+            participating in the ensemble). Note that the object name
+            includes the "myid" of the server (name suffix).</entry>
+          </row>
+          <row>
+            <entry>LeaderElection</entry>
+            <entry>LeaderElection</entry>
+            <entry>Represents a ZooKeeper cluster leader election which is
+            in progress. Provides information about the election, such as
+            when it started.</entry>
+          </row>
+          <row>
+            <entry>Leader</entry>
+            <entry>Leader</entry>
+            <entry>Indicates that the parent replica is the leader and
+            provides attributes/operations for that server. Note that
+            Leader is a subclass of ZooKeeperServer, so it provides
+            all of the information normally associated with a
+            ZooKeeperServer node.</entry>
+          </row>
+          <row>
+            <entry>Follower</entry>
+            <entry>Follower</entry>
+            <entry>Indicates that the parent replica is a follower and
+            provides attributes/operations for that server. Note that
+            Follower is a subclass of ZooKeeperServer, so it provides
+            all of the information normally associated with a
+            ZooKeeperServer node.</entry>
+          </row>
+          <row>
+            <entry>DataTree</entry>
+            <entry>InMemoryDataTree</entry>
+            <entry>Statistics on the in memory znode database, also
+            operations to access finer (and more computationally
+            intensive) statistics on the data (such as ephemeral
+            count). InMemoryDataTrees are children of ZooKeeperServer
+            nodes.</entry>
+          </row>
+          <row>
+            <entry>ServerCnxn</entry>
+            <entry>&lt;session_id&gt;</entry>
+            <entry>Statistics on each client connection, also
+            operations on those connections (such as
+            termination). Note the object name is the session id of
+            the connection in hex form.</entry>
+          </row>
+    </tbody></tgroup></table>
+
+    <para>This table details JMX for a standalone server. Typically
+    standalone is only used in development situations.</para>
+
+    <table>
+      <title>MBeans, their names and description</title>
+
+      <tgroup cols='4'>
+        <thead>
+          <row>
+            <entry>MBean</entry>
+            <entry>MBean Object Name</entry>
+            <entry>Description</entry>
+          </row>
+        </thead>
+        <tbody>
+          <row>
+            <entry>ZooKeeperServer</entry>
+            <entry>StandaloneServer_port&lt;#&gt;</entry>
+            <entry>Statistics on the running server, also operations
+            to reset these attributes. Note that the object name
+            includes the client port of the server (name
+            suffix).</entry>
+          </row>
+          <row>
+            <entry>DataTree</entry>
+            <entry>InMemoryDataTree</entry>
+            <entry>Statistics on the in memory znode database, also
+            operations to access finer (and more computationally
+            intensive) statistics on the data (such as ephemeral
+            count).</entry>
+          </row>
+          <row>
+            <entry>ServerCnxn</entry>
+            <entry>&lt;session_id&gt;</entry>
+            <entry>Statistics on each client connection, also
+            operations on those connections (such as
+            termination). Note the object name is the session id of
+            the connection in hex form.</entry>
+          </row>
+    </tbody></tgroup></table>
+
+  </section>
+
+</article>



Mime
View raw message