diff --git a/src/main/docbkx/configuration.xml b/src/main/docbkx/configuration.xml index 6907bb7..ddb860a 100644 --- a/src/main/docbkx/configuration.xml +++ b/src/main/docbkx/configuration.xml @@ -671,6 +671,14 @@ Index: pom.xml +
+ ZooKeeper Requirements + ZooKeeper 3.4.x is required as of HBase 1.0.0. HBase makes use of the + multi functionality that is only available since 3.4.0 + (The useMulti is defaulted true in HBase 1.0.0). + See HBASE-12241 The crash of regionServer when taking deadserver's replication queue breaks replication + and Use ZK.multi when available for HBASE-6710 0.92/0.94 compatibility fix for background. +
-
+
Upgrading from 0.98.x to 1.0.x - A rolling upgrade from 0.98.x to 1.0.x works (TODO: Verify!!!!). The two versions are not binary - compatible. + In this section we first note the significant changes that come in with 1.0.0 HBase and then + we go over the upgrade process. Be sure to read the significant changes section with care + so you avoid surprises. +
Changes of Note! In here we list important changes that are in 1.0.0 since 0.98.x., changes you should be aware that will go into effect once you upgrade. +
ZooKeeper 3.4 is required in HBase 1.0.0 + See . +
hbase.bucketcache.percentage.in.combinedcache configuration has been REMOVED You may have made use of this configuration if you are using BucketCache. @@ -114,6 +118,19 @@
+
+ Rolling upgrade from 0.98.x to HBase 1.0.0 + TODO +
+
+ Upgrading to 1.0 from 0.94 + You cannot rolling upgrade from 0.94.x to 1.x.x. You must stop your cluster, + install the 1.x.x software, run the migration described at + (substituting 1.x.x. wherever we make mention of 0.96.x in the section below), + and then restart. Be sure to upgrade your zookeeper if it is a version less than the required 3.4.x. + + +
Upgrading from 0.94.x to 0.96.x - The Singularity + The "Singularity" HBase 0.96.x was EOL'd, September 1st, 2014 Do not deploy 0.96.x Deploy a 0.98.x at least. See EOL 0.96. + You will have to stop your old 0.94.x cluster completely to upgrade. If you are replicating between clusters, both clusters will have to go down to upgrade. Make sure it is a clean shutdown. The less WAL files around, the faster the upgrade will run (the @@ -154,9 +172,10 @@ process). All clients must be upgraded to 0.96 too. The API has changed. You will need to recompile your code against 0.96 and you may need to adjust applications to go against new APIs (TODO: List of changes). -
+
Executing the 0.96 Upgrade + HDFS and ZooKeeper must be up! HDFS and ZooKeeper should be up and running during the upgrade process. hbase-0.96.0 comes with an upgrade script. Run