Chapter 3. Upgrading

Table of Contents

3.1. Upgrading from 0.94.x to 0.96.x
3.2. Upgrading from 0.92.x to 0.94.x
3.3. Upgrading from 0.90.x to 0.92.x
3.3.1. You can’t go back!
3.3.2. MSLAB is ON by default
3.3.3. Distributed splitting is on by default
3.3.4. Memory accounting is different now
3.3.5. On the Hadoop version to use
3.3.6. HBase 0.92.0 ships with ZooKeeper 3.4.2
3.3.7. Online alter is off by default
3.3.8. WebUI
3.3.9. Security tarball
3.3.10. Experimental off-heap cache
3.3.11. Changes in HBase replication
3.3.12. RegionServer now aborts if OOME
3.3.13. HFile V2 and the “Bigger, Fewer” Tendency
3.4. Upgrading to HBase 0.90.x from 0.20.x or 0.89.x

You cannot skip major verisons upgrading. If you are upgrading from version 0.20.x to 0.92.x, you must first go from 0.20.x to 0.90.x and then go from 0.90.x to 0.92.x.

Review Chapter 2, Apache HBase (TM) Configuration, in particular the section on Hadoop version.

3.1. Upgrading from 0.94.x to 0.96.x

The Singularity

You will have to stop your old 0.94 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 so there are no WAL files laying around (TODO: Can 0.96 read 0.94 WAL files?). Make sure zookeeper is cleared of state. All clients must be upgraded to 0.96 too.

The API has changed in a few areas; in particular how you use coprocessors (TODO: MapReduce too?)

TODO: Write about 3.4 zk ensemble and multi support

comments powered by Disqus