Ambari Upgrade Guide
Also available as:
PDF

Chapter 4. Upgrading HDP

There are different HDP upgrade options based on your current HDP and the target HDP. This section describes the different upgrade options and their prerequisites.

[Note]Note

The HDP Stack version is based on the following format: major.minor.maintenance.patch. 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 to describe the different upgrade paths. For example: if you want to upgrade from HDP 2.2 to HDP 2.3, that is a Minor Upgrade. If you want to upgrade from HDP 2.2.x to HDP 2.2.y, that is a Maintenance Upgrade.

The following table describes the different upgrade options based on the current and target Stack combinations.

Table 4.1. HDP Stack Upgrade Options

Upgrade Path

Current HDP

Target HDP

Upgrade Options

Minor Upgrade *

HDP 2.2

HDP 2.3

Rolling Upgrade HDP 2.2 to 2.3

or

Manual Upgrade HDP 2.2 to 2.3

Maintenance Upgrade

HDP 2.2.x

HDP 2.2.y

Rolling Maintenance Upgrade

or

Manual Maintenance Upgrade

Maintenance Upgrade

HDP 2.3.x

HDP 2.3.y

Rolling Maintenance Upgrade

or

Manual Maintenance Upgrade

Minor Upgrade

HDP 2.0 or 2.1

HDP 2.3

Ambari 2.1 does not support directly upgrading from HDP 2.0 to HDP 2.3. In order to upgrade from HDP 2.0, you must first upgrade to HDP 2.2 using either Ambari 1.7 or 2.0. Once completed, upgrade your current Ambari to Ambari 2.1. Then, leverage Ambari 2.1 to complete the upgrade from HDP 2.2 to HDP 2.3.

* Before performing a Minor Upgrade, you must upgrade your Ambari first. See Preparing to Upgrade Ambari and HDP for more information.