MapR 5.0 Documentation : Upgrade from HBase 0.98.x to 0.98.x (latest)

This page contains the following steps to upgrade an existing HBase 0.98.x to the latest version of HBase 0.98.x in the MapR distribution for Apache Hadoop:

1. Update Repositories or Download Packages

MapR's rpm and deb repositories always contain the HBase version recommended for the latest release of the MapR core.  You can connect to an internet repository or prepare a local repository with any version of HBase you need. For more details on setting up repositories, see Preparing Packages and Repositories. You can also manually download packages. 

The following ecosystem repositories are available:

Repository 
MapR 5.x Ecosystem Repository (for repository install)http://package.mapr.com/releases/ecosystem-5.x
All Ecosystem Packages (for manual install) http://package.mapr.com/releases/ecosystem-all

To update the repository cache

If you plan to install from a repository, update the repository cache on each node where HBase is installed.

On RedHat and CentOS...

yum clean all

On Ubuntu...

apt-get update

2. Take Snapshot of the hbase Volume

Take a snapshot of the hbase volume. The snapshot creates a backup of the volume data that you can use to recover your data in the event that corruption occurs during the upgrade process.  For more information, see MapR Data Platform.

3. Backup Configuration Files

If you have changed configuration properties on your current installation of HBase, you probably want to apply those changes to the updated version. Configuration properties are located in /opt/mapr/hbase/hbase-<version>/conf/. Create a backup of any configuration files that contains customized values.

4. Upgrade HBase

Complete the following steps to upgrade HBase: 

  1. Upgrade the packages using one of the following methods:

    To upgrade with a package manager

    After configuring repositories so that the version you want to install is available, you can use a package manager to install from the repository. The upgrade process will remove all but the following directories in the current HBase directory: conf and logs.

    On RedHat and CentOS

    To upgrade an HBase region server node:

    yum upgrade mapr-hbase mapr-hbase-regionserver

    To upgrade an HBase master node:

    yum upgrade mapr-hbase mapr-hbase-master

    To upgrade an HBase client node:

    yum upgrade mapr-hbase
    On Ubuntu

    To upgrade an HBase region server node:

    apt-get install mapr-hbase mapr-hbase-regionserver

    To upgrade an HBase master node:

    apt-get install mapr-hbase mapr-hbase-master

    To upgrade an HBase client node:

    apt-get install mapr-hbase

    To upgrade by manually installing packages

    On RedHat and CentOS
    1. Download the RPM package files mapr-hbase, mapr-hbase-master, and mapr-hbase-regionserver for version 0.98.x from http://package.mapr.com/releases/ecosystem-all.
    2. Install the package with rpm.
      To upgrade an HBase region server node:

      rpm -i --force mapr-hbase-0.98.<version>.noarch.rpm mapr-hbase-regionserver-0.98.<version>.noarch.rpm

      To upgrade an HBase master node:

      rpm -i --force mapr-hbase-0.98.<version>.noarch.rpm mapr-hbase-master-0.98.<version>.noarch.rpm
    On Ubuntu
    1. Download the RPM package files mapr-hbase, mapr-hbase-master, and mapr-hbase-regionserver for version 0.98.x from http://package.mapr.com/releases/ecosystem-all.
    2. Install the package with dpkg.
      To upgrade an HBase region server node:

      dpkg -i mapr-hbase_0.98.<version>_all.deb mapr-hbase-regionserver_0.98.<version>_all.deb

      To upgrade an HBase master node:

      dpkg -i mapr-hbase_0.98.<version>_all.deb mapr-hbase-master_0.98.<version>_all.deb

    If you have additional HBase services or libraries installed, you should also upgrade those packages to match the HBase version you are upgrading to.

  2. Migrate any custom configuration settings to the configuration files within the conf directory (opt/mapr/hbase/hbase-<version>/conf/)
  3. Run configure.sh -R on all of the upgraded HBase nodes:
    $ /opt/mapr/server/configure.sh -R


5. Start HBase Services 

Start the upgraded HBase services. You can use either the maprcli or the MCS to start the services.