Apache Ambari Upgrade
Also available as:

Chapter 5. Upgrading HDP

You may choose from several available upgrade options, based on your current HDP version and the HDP version to which you will upgrade (the target version). This topic describes available 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.6.1 before upgrading HDP unless otherwise noted. Ambari 2.6.1 supports patch and maintenance upgrades to HDP 2.6.4.x stack. 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 HDP Stack version is based on the following format: major.minor.maintenance.patch-build#. A major release increments the first digit; a minor release, the second; a maintenance release the third; and a patch release the fourth. 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.5.x to HDP 2.5.y, is a Maintenance Upgrade, and an upgrade from to is a patch upgrade. A Maintenance Upgrade may include multiple patch releases.

The following table describes available upgrade options.

Table 5.1. HDP Upgrade Options

Upgrade Path

Current HDP*

Target HDP*

Rolling Upgrade

Express Upgrade

Minor **

HDP 2.5

HDP 2.6

Minor **

HDP 2.4

HDP 2.5 or 2.6


HDP 2.6.x.y

HDP 2.6.x.y


HDP 2.5.x.y

HDP 2.5.x.y


HDP 2.4.x.y

HDP 2.4.x.y

* The instructions in this document sometimes refer to an HDP “version” using the HDP #.#.x.y convention. For example, you will see the HDP 2.4.x.y convention to refer to any HDP 2.4 “maintenance” release. Therefore, to use a specific HDP 2.4 maintenance release, be sure to replace 2.4.x.y in the following instructions with the appropriate maintenance version, such as for the HDP 2.4 GA release, or for an HDP 2.4 maintenance release.

** A Minor upgrade can be performed from any current maintenance release to any target maintenance release in that minor release. For example, you can upgrade from HDP 2.4.x.y to HDP 2.5.x.y as part of a Minor upgrade.


Because HDP 2.3.6 contains features and fixes that are not applicable to HDP 2.4.0 or HDP 2.4.2, do not upgrade from HDP 2.3.6 to HDP 2.4.0 or HDP 2.4.2.

More Information

Preparing to Upgrade Ambari and HDP

Rolling Upgrade Prerequisites