4. Upgrading from HDP 2.2.x to HDP 2.2.6

HDP 2.2.6 is a maintenance release of HDP 2.2.x. If you already have HDP 2.2.x installed, upgrading your cluster to HDP 2.2.6 means:

  • Keeping the same configuration files you used for HDP 2.2.x

  • Keeping the same data and metadata in the same location you used for HDP 2.2.x

  • Installing any new components (added for the first time in HDP 2.2.6) side-by-side with existing components

The following table summarizes HDP 2.2.x-to-2.2.6 upgrade options:

Cluster Management

Supporting Doc

Notes

Cluster managed manually

Use these Release Notes

If you have an earlier version of HDP (such as HDP 2.0 or HDP 2.1), see the HDP v. 2.2.6 Manual Upgrade Guide

Cluster managed via Ambari 1.7.0

Use these Release Notes

Cluster managed via Ambari 2.0

Use the Upgrading Ambari Guide

Ambari 2.0 supports rolling upgrade between HDP 2.2.x and HDP 2.2.6

Before You Begin

Upgrade Procedure

To upgrade your cluster from HDP 2.2.x to HDP 2.2.6:

  1. Download the appropriate HDP 2.2.6 hdp.repo file for your OS:

    or

    Download the HDP RPM single repository tarball. (For information on how to install the repositories, see the local repository instructions.)

  2. Run an update:

    apt-get update

  3. Install the HDP 2.2.6 bits:

    Operating System

    Commands

    RHEL/CentOS/Oracle LINUX

    Install HDP 2.2.6 components on relevant nodes, according to the services that run on those hosts:

    yum install "hadoop_2_2_6_2800*" "oozie_2_2_6_2800*" "pig_2_2_6_2800*" "sqoop_2_2_6_2800*" "zookeeper_2_2_6_2800*" "hbase_2_2_6_2800*" "hive_2_2_6_2800*" "tez_2_2_6_2800*" "storm_2_2_6_2800*" "falcon_2_2_6_2800*" "flume_2_2_6_2800*" "phoenix_2_2_6_2800*" "accumulo_2_2_6_2800*" "mahout_2_2_6_2800*"

    SLES

    Install HDP 2.2.6 components on relevant nodes, according to the services that run on those hosts:

    zypper install "hadoop_2_2_6_2800*" "oozie_2_2_6_2800*" "pig_2_2_6_2800*" "sqoop_2_2_6_2800*" "zookeeper_2_2_6_2800*" "hbase_2_2_6_2800*" "hive_2_2_6_2800*" "tez_2_2_6_2800*" "storm_2_2_6_2800*" "falcon_2_2_6_2800*" "flume_2_2_6_2800*" "phoenix_2_2_6_2800*" "accumulo_2_2_6_2800*" "mahout_2_2_6_2800*"

    Ubuntu/Debian

    Install HDP 2.2.6 components on relevant nodes, according to the services that run on those hosts:

    apt-get install "hadoop_2_2_6_2800*" "oozie_2_2_6_2800*" "pig_2_2_6_2800*" "sqoop_2_2_6_2800*" "zookeeper_2_2_6_2800*" "hbase_2_2_6_2800*" "hive_2_2_6_2800*" "tez_2_2_6_2800*" "storm_2_2_6_2800*" "falcon_2_2_6_2800*" "flume_2_2_6_2800*" "phoenix_2_2_6_2800*" "accumulo_2_2_6_2800*" "mahout_2_2_6_2800*"

  4. Stop all HDP 2.2.x Services.

    If you are managing your cluster manually, stop all HDP 2.2.x Services. See "Controlling HDP Services Manually" in the HDP Reference Guide.

    If you are managing your cluster with Ambari 1.7.0, do the following:

    1. Open Ambari Web

    2. Browse to Services

    3. Use Service Actions to stop each service

    For all services, switch the active version to HDP 2.2.6.

    On each host in the cluster, use hdp-select to switch all services to the HDP 2.2.6 version:

    hdp-select set all $VERSION-$BUILD

  5. (Ambari 1.7.0-managed clusters only) Complete the Stack Upgrade.

    If you are managing your cluster with Ambari 1.7.0, update the repository Base URLs to use the HDP 2.2.6 repositories for HDP and HDP-UTILS:

    1. Open Ambari Web

    2. Browse to Admin > Repositories

    3. Edit the Base URLs

  6. Start all HDP 2.2.6 services, in the following order:

    1. ZooKeeper

      su - zookeeper export ZOOCFGDIR=/usr/hdp/current/zookeeper-server/conf ; export ZOOCFG=zoo.cfg; source /usr/hdp/current/zookeeper-server/conf/zookeeper-env.sh ; /usr/hdp/current/zookeeper-server/bin/zkServer.sh start

    2. (HA NameNode upgrade only) ZooKeeper Failover Controller Daemons

      /usr/hdp/current/hadoop-hdfs-namenode/../hadoop/sbin/hadoop-daemon.sh start zkfc

    3. (HA NameNode upgrade only) JournalNodes

      su - hdfs /usr/hdp/current/hadoop-hdfs-journalnode/../hadoop/sbin/hadoop-daemon.sh start journalnode

    4. HDFS NameNode(s)

      Start the HDFS NameNode(s). Because there is no metadata schema update for this upgrade, start the NameNode(s) in normal mode:

      su - hdfs /usr/hdp/current/hadoop-hdfs-namenode/../hadoop/sbin/hadoop-daemon.sh start namenode

    5. Remaining Services

      Start the rest of the HDP services. On each host in the cluster, start the services that are relevant to that cluster. To identify the start commands for all services, see "Controlling HDP Services Manually" in the HDP Reference Guide.

    You now have an upgraded cluster. Ensure that your workloads run correctly on this upgraded cluster.