svn commit: r808812 - in /websites/staging/zookeeper/trunk/content: ./ bookkeeper/docs/trunk/bookkeeperConfig.html releases.html

[bu...@apache.org]

Author: buildbot
Date: Fri Mar 16 05:46:23 2012
New Revision: 808812

Log:
Staging update by buildbot for zookeeper

Modified:
    websites/staging/zookeeper/trunk/content/   (props changed)
    websites/staging/zookeeper/trunk/content/bookkeeper/docs/trunk/bookkeeperConfig.html
    websites/staging/zookeeper/trunk/content/releases.html

Propchange: websites/staging/zookeeper/trunk/content/
------------------------------------------------------------------------------
    cms:source-revision = 1301344

Modified: websites/staging/zookeeper/trunk/content/bookkeeper/docs/trunk/bookkeeperConfig.html
==============================================================================
--- websites/staging/zookeeper/trunk/content/bookkeeper/docs/trunk/bookkeeperConfig.html (original)
+++ websites/staging/zookeeper/trunk/content/bookkeeper/docs/trunk/bookkeeperConfig.html Fri Mar 16 05:46:23 2012
@@ -55,7 +55,7 @@
           <div class="wiki-content">
  <h1>Abstract</h1>
 
-<p>This document contains information about deploying, administering and mantaining BookKeeper. It also discusses best practices and common problems. </p>
+<p>This document contains information about deploying, administering and maintaining BookKeeper. It also discusses best practices and common problems. </p>
 
 <h1>Running a BookKeeper instance</h1>
 
@@ -75,14 +75,34 @@
 
 <p>The configuration parameters can be set in bookkeeper-server/conf/bk_server.conf. </p>
 
-<p>The important parameters are:<br />
- * <code>bookiePort</code>, Port number that the bookie listens on; <br />
- * <code>zkServers</code>, Comma separated list of ZooKeeper servers with a hostname:port format; <br />
- * <code>journalDir</code>, Path for Log Device (stores bookie write-ahead log); <br />
- * <code>ledgerDir</code>, Path for Ledger Device (stores ledger entries); </p>
+<p>The important parameters are:</p>
+
+<ul>
+<li><code>bookiePort</code>, Port number that the bookie listens on; </li>
+<li><code>zkServers</code>, Comma separated list of ZooKeeper servers with a hostname:port format; </li>
+<li><code>journalDir</code>, Path for Log Device (stores bookie write-ahead log); </li>
+<li><code>ledgerDir</code>, Path for Ledger Device (stores ledger entries); </li>
+</ul>
 
 <p>Ideally, <code>journalDir</code> and <code>ledgerDir</code> are each in a different device. See <a href="./bookkeeperConfigParams.html">BookKeeper Configuration Parameters</a> for a full list of configuration parameters.</p>
 
+<h3>Upgrading</h3>
+
+<p>From time to time, we may make changes to the filesystem layout of the bookie, which are incompatible with previous versions of bookkeeper and require that directories used with previous versions are upgraded. If you upgrade your bookkeeper software, and an upgrade is required, then the bookie will fail to start and print an error to the effect that an upgrade is required.</p>
+
+<p>BookKeeper provides a utility for doing the upgrade.<br />
+<code>bookkeeper-server/bin/bookkeeper upgrade</code></p>
+
+<p>The upgrade application takes 3 possible switches, <code>--upgrade</code>, <code>--rollback</code> or <code>--finalize</code>. A normal upgrade process looks like.</p>
+
+<ol>
+<li><code>bookkeeper-server/bin/bookkeeper upgrade --upgrade</code></li>
+<li><code>bookkeeper-server/bin/bookkeeper bookie</code></li>
+<li>Check everything is working. Kill bookie, ^C</li>
+<li>If everything is ok, <code>bookkeeper-server/bin/bookkeeper upgrade --finalize</code></li>
+<li>Start bookie again <code>bookkeeper-server/bin/bookkeeper bookie</code></li>
+<li>If something is amiss, you can roll back the upgrade <code>bookkeeper-server/bin/bookkeeper upgrade --rollback</code></li>
+</ol>
 
 <h3>Logging</h3>
 

Modified: websites/staging/zookeeper/trunk/content/releases.html
==============================================================================
--- websites/staging/zookeeper/trunk/content/releases.html (original)
+++ websites/staging/zookeeper/trunk/content/releases.html Fri Mar 16 05:46:23 2012
@@ -73,7 +73,7 @@
 
 <h2 id="news">News</h2>
 
-<h3>13 Feb, 2011: release 3.4.3 available</h3>
+<h3>13 Feb, 2012: release 3.4.3 available</h3>
 
 <p>This release fixes  critical bugs in 3.4.2. See<br />
 <a href="http://zookeeper.apache.org/doc/r3.4.3/releasenotes.html">ZooKeeper 3.4.3 Release Notes</a> for details.</p>