Author: phunt
Date: Tue Oct 21 18:26:36 2008
New Revision: 706839

URL: http://svn.apache.org/viewvc?rev=706839&view=rev
Log:
ZOOKEEPER-145. write detailed release notes for users migrating from 2.x to 3.0

Modified:
    hadoop/zookeeper/trunk/CHANGES.txt
    hadoop/zookeeper/trunk/docs/releasenotes.html
    hadoop/zookeeper/trunk/docs/releasenotes.pdf
    
hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/releasenotes.xml

Modified: hadoop/zookeeper/trunk/CHANGES.txt
URL: 
http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/CHANGES.txt?rev=706839&r1=706838&r2=706839&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/CHANGES.txt (original)
+++ hadoop/zookeeper/trunk/CHANGES.txt Tue Oct 21 18:26:36 2008
@@ -37,6 +37,9 @@
 
   BUGFIXES: 
 
+  ZOOKEEPER-145. write detailed release notes for users migrating from 2.x
+  to 3.0 (phunt)
+
   ZOOKEEPER-23. Auto reset of watches on reconnect (breed via phunt)
 
   ZOOKEEPER-191. forrest docs for upgrade. (mahadev via phunt)

Modified: hadoop/zookeeper/trunk/docs/releasenotes.html
URL: 
http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/releasenotes.html?rev=706839&r1=706838&r2=706839&view=diff
==============================================================================
--- hadoop/zookeeper/trunk/docs/releasenotes.html (original)
+++ hadoop/zookeeper/trunk/docs/releasenotes.html Tue Oct 21 18:26:36 2008
@@ -204,6 +204,9 @@
 <li>
 <a href="#migration_data">Migrating Server Data</a>
 </li>
+<li>
+<a href="#migration_config">Migrating Server Configuration</a>
+</li>
 </ul>
 </li>
 <li>
@@ -265,11 +268,24 @@
 <a href="#migration_data">Migrating Server Data</a>
 </p>
 </li>
+  
+<li>
+<p>
+<a href="#migration_config">Migrating Server Configuration</a>
+</p>
+</li>
 
 </ul>
-<a name="N1003F"></a><a name="migration_code"></a>
+<a name="N10045"></a><a name="migration_code"></a>
 <h3 class="h4">Migrating Client Code</h3>
-<a name="N10045"></a><a name="Watch+Management"></a>
+<p>
+  The underlying client-server protocol has changed in version 3.0.0
+  of ZooKeeper. As a result clients must be upgraded along with
+  serving clusters to ensure proper operation of the system (old
+  pre-3.0.0 clients are not guaranteed to operate against upgraded
+  3.0.0 servers and vice-versa).
+</p>
+<a name="N1004E"></a><a name="Watch+Management"></a>
 <h4>Watch Management</h4>
 <p>
 In previous releases of ZooKeeper any watches registered by clients were lost 
if the client lost a connection to a ZooKeeper server.
@@ -285,7 +301,7 @@
 This gives the developer the ability to modularize logic in different watch 
functions rather than cramming everything in the watch function attached to the 
ZooKeeper handle.
 Call specific watch functions receive all session events for as long as they 
are active, but will only receive the watch callbacks for which they are 
registered.
 </p>
-<a name="N10052"></a><a name="Java+API"></a>
+<a name="N1005B"></a><a name="Java+API"></a>
 <h4>Java API</h4>
 <ol>
   
@@ -307,7 +323,7 @@
 Also see <a 
href="http://hadoop.apache.org/zookeeper/docs/current/api/index.html";>the 
current java API</a>
 
 </p>
-<a name="N10084"></a><a name="C+API"></a>
+<a name="N1008D"></a><a name="C+API"></a>
 <h4>C API</h4>
 <ol>
   
@@ -316,7 +332,7 @@
 </li>
 
 </ol>
-<a name="N10097"></a><a name="migration_data"></a>
+<a name="N100A0"></a><a name="migration_data"></a>
 <h3 class="h4">Migrating Server Data</h3>
 <p>
 The following issues resulted in changes to the on-disk data format (the 
snapshot and transaction log files contained within the ZK data directory) and 
require a migration utility to be run. 
@@ -462,10 +478,31 @@
 </li> 
  
 </ol>
+<a name="N10135"></a><a name="migration_config"></a>
+<h3 class="h4">Migrating Server Configuration</h3>
+<p>
+There is a significant change to the ZooKeeper server configuration file.
+</p>
+<p>The default election algorithm, specified by
+  the <em>electionAlg</em> configuration attribute, has
+  changed from a default of <em>0</em> to a default
+  of <em>3</em>. See
+  <a href="zookeeperAdmin.html#sc_clusterOptions">Cluster
+  Options</a> section of the administrators guide, specifically
+  the <em>electionAlg</em>
+  and <em>server.X</em> properties.
+</p>
+<p>
+  You will either need to explicitly
+  set <em>electionAlg</em> to it's previous default value
+  of <em>0</em> or change
+  your <em>server.X</em> options to include the leader
+  election port.
+</p>
 </div>
 
 
-<a name="N1012D"></a><a name="changes"></a>
+<a name="N10162"></a><a name="changes"></a>
 <h2 class="h3">Changes Since ZooKeeper 2.2.1</h2>
 <div class="section">
 <p>

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

Modified: 
hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/releasenotes.xml
URL: 
http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/releasenotes.xml?rev=706839&r1=706838&r2=706839&view=diff
==============================================================================
--- 
hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/releasenotes.xml
 (original)
+++ 
hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/releasenotes.xml
 Tue Oct 21 18:26:36 2008
@@ -62,11 +62,20 @@
 <itemizedlist>
   <listitem><para><ulink url="#migration_code">Migrating Client 
Code</ulink></para></listitem>
   <listitem><para><ulink url="#migration_data">Migrating Server 
Data</ulink></para></listitem>
+  <listitem><para><ulink url="#migration_config">Migrating Server 
Configuration</ulink></para></listitem>
 </itemizedlist>
 
 <section id="migration_code">
 <title>Migrating Client Code</title>
 
+<para>
+  The underlying client-server protocol has changed in version 3.0.0
+  of ZooKeeper. As a result clients must be upgraded along with
+  serving clusters to ensure proper operation of the system (old
+  pre-3.0.0 clients are not guaranteed to operate against upgraded
+  3.0.0 servers and vice-versa).
+</para>
+
 <section>
 <title>Watch Management</title>
 
@@ -186,6 +195,34 @@
  </orderedlist>
  
 </section>
+
+<section id="migration_config">
+<title>Migrating Server Configuration</title>
+
+<para>
+There is a significant change to the ZooKeeper server configuration file.
+</para>
+
+<para>The default election algorithm, specified by
+  the <emphasis>electionAlg</emphasis> configuration attribute, has
+  changed from a default of <emphasis>0</emphasis> to a default
+  of <emphasis>3</emphasis>. See
+  <ulink url="zookeeperAdmin.html#sc_clusterOptions">Cluster
+  Options</ulink> section of the administrators guide, specifically
+  the <emphasis>electionAlg</emphasis>
+  and <emphasis>server.X</emphasis> properties.
+</para>
+
+<para>
+  You will either need to explicitly
+  set <emphasis>electionAlg</emphasis> to it's previous default value
+  of <emphasis>0</emphasis> or change
+  your <emphasis>server.X</emphasis> options to include the leader
+  election port.
+</para>
+
+</section>
+
 </section>
 
 <section id="changes">


Reply via email to