Apache Ambari Upgrade for IBM Power Systems
Also available as:

Chapter 4. Upgrading HDP

There are different HDP upgrade options based on your current HDP version and the target HDP version. This section describes the different upgrade options, their prerequisites, and the overall process. You are strongly encouraged to read completely through this entire document before starting the upgrade process, to that you understand the interdependencies and order of the steps. It is highly recommended you validate these steps in a test environment to adjust and account for any special configurations for your cluster.

The high-level process for performing an HDP upgrade is as follows:

Ambari will guide you through the steps required to upgrade HDP. Make sure Ambari and the cluster are healthy, operating normally and all service checks are passing.


Be sure to review the available HDP upgrade scenarios below. It is strongly recommended that you first upgrade to Ambari 2.5.2 before upgrading HDP unless otherwise noted. After upgrading Ambari, be sure the cluster is operating normally and service checks are passing prior to attempting an HDP upgrade.

There are two methods for upgrading HDP with Ambari: Rolling Upgrade and Express Upgrade.

  • A Rolling Upgrade orchestrates the HDP upgrade in an order that is meant to preserve cluster operation and minimize service impact during upgrade. This process has more stringent prerequisites (particularly regarding cluster high availability configuration) and can take longer to complete than an Express Upgrade.

  • An Express Upgrade orchestrates the HDP upgrade in an order that will incur cluster downtime but with less stringent prerequisites.

The following table describes which upgrade option is available based on the current and target HDP version combinations. It is important to note that the HDP Stack version is based on the following format: major.minor.maintenance.patch-build#. A "minor" release is a release that increments the second-digit. A "maintenance" release is one that increments the third-digit. This terminology is used in the following table to describe the different upgrade paths. For example: an upgrade from HDP 2.5 to HDP 2.6, is a "Minor Upgrade". An upgrade from HDP 2.6.1 to HDP 2.6.2, is a "Maintenance" Upgrade.

Table 4.1. HDP Upgrade Options for IBM-PPC

Upgrade Path

Current HDP*

Target HDP*

Rolling Upgrade

Express Upgrade




More Information

Preparing to Upgrade Ambari and HDP

Rolling Upgrade Prerequisites