Apache
/
hbase
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add a bit of doc on the cleaning zk migration step 

git-svn-id: https://svn.apache.org/repos/asf/hbase/trunk@1487935 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Michael Stack 2013-05-30 17:12:14 +00:00
parent 6ff1dc821d
commit 11c861cb91
1 changed files with 27 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
src/main/docbkx/upgrading.xml
View File

@ -90,7 +90,33 @@
</para>
<para>The API has changed in a few areas; in particular how you use coprocessors (TODO: MapReduce too?)
</para>
<para>TODO: Write about 3.4 zk ensemble and multi support</para>
<section xml:id="096.zk.cleaning">
<title>Cleaning zookeeper of old data</title>
<para>Clean zookeeper of all its content before you start 0.96.x (or 0.95.x). Here is how:
<programlisting>$ ./bin/hbase clean</programlisting>
This will printout usage. Run the following to clean zookeeper in particular
<programlisting>$ ./bin/hbase clean --cleanZk</programlisting>
</para>
<para>This is what you will see if zookeeper has old data in it: the Master won't start with
an exception like the following
<programlisting>2013-05-30 09:46:29,767 FATAL [master-sss-1,60000,1369932387523] org.apache.hadoop.hbase.master.HMaster: Unhandled exception. Starting shutdown.
org.apache.zookeeper.KeeperException$DataInconsistencyException: KeeperErrorCode = DataInconsistency
at org.apache.hadoop.hbase.zookeeper.ZKUtil.convert(ZKUtil.java:1789)
at org.apache.hadoop.hbase.zookeeper.ZKTableReadOnly.getTableState(ZKTableReadOnly.java:156)
at org.apache.hadoop.hbase.zookeeper.ZKTable.populateTableStates(ZKTable.java:81)
at org.apache.hadoop.hbase.zookeeper.ZKTable.&lt;init>(ZKTable.java:68)
at org.apache.hadoop.hbase.master.AssignmentManager.&lt;init>(AssignmentManager.java:246)
at org.apache.hadoop.hbase.master.HMaster.initializeZKBasedSystemTrackers(HMaster.java:626)
at org.apache.hadoop.hbase.master.HMaster.finishInitialization(HMaster.java:757)
at org.apache.hadoop.hbase.master.HMaster.run(HMaster.java:552)
at java.lang.Thread.run(Thread.java:662)
Caused by: org.apache.hadoop.hbase.exceptions.DeserializationException: Missing pb magic PBUF prefix
at org.apache.hadoop.hbase.protobuf.ProtobufUtil.expectPBMagicPrefix(ProtobufUtil.java:205)
at org.apache.hadoop.hbase.zookeeper.ZKTableReadOnly.getTableState(ZKTableReadOnly.java:146)
... 7 more</programlisting>
</para>
</section>
</section>
<section xml:id="upgrade0.94">
<title>Upgrading from 0.92.x to 0.94.x</title>