In-place upgrade overview

To plan your upgrade from Ambari managed HDP 3.1.5 to CDP Private Cloud Base, you must be aware of the two stages of in-place upgrade along with the pre-upgrade, upgrade, and post-upgrade tasks.

This upgrade path consists of two stages:

Upgrade HDP 3.1.5 to Cloudera Runtime 7.1.x using Ambari.
Transition the management platform from Ambari to Cloudera Manager.

To upgrade to Cloudera Runtime 7.1.x, you must first upgrade from Ambari 2.7.5.x (source) to Ambari 7.1.x.x (target) and then upgrade from HDP 3.1.5 to Cloudera Runtime 7.1.x.

Upgrading and transitioning to CDP Private Cloud Base

To upgrade and transition to CDP Private Cloud Base using the documentation, perform the following steps.

Architecture diagram of the upgrade and transition:

important

While the upgrade process will temporarily install HDP intermediate bits, the HDP intermediate bits is an interim artifact that enables you to complete the upgrade to CDP Private Cloud Base and is not a new release of HDP intended for production use. When the upgrade process is complete, your cluster will be using the Cloudera Runtime 7.1.x parcel.
If you are migrating from HDP 3.1.5 to CDP Private Cloud Base 7.1.7 SP2, then:
- The supported Runtime version is 7.1.7 SP2.
- The supported Cloudera Manager version is 7.6.7.
- The supported AM2CM tool version is AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, and AM2CM 2.4.1.1.
If you are migrating from HDP 3.1.5 to CDP Private Cloud Base 7.1.8, then:
- The supported Runtime version is 7.1.8.
- The supported Cloudera Manager version is 7.7.1.
- The supported AM2CM tool version is AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, and AM2CM 2.4.1.1.
If you are migrating from HDP 3.1.5 to CDP Private Cloud Base 7.1.7 SP1, then:
- The supported Runtime version is 7.1.7 SP1.
- The supported Cloudera Manager version is 7.6.1.
- The supported AM2CM tool version is AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, and AM2CM 2.4.1.1.
If you are migrating from HDP 3.1.5 to CDP Private Cloud Base 7.1.7, then:
- The supported Runtime version is 7.1.7.
- The supported Cloudera Manager version is 7.4.4.
- The supported AM2CM tool version is AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1,AM2CM 2.4.0,2.3.0.0,2.1.0.0, 2.0.4.0, 2.0.3.0, and 2.0.2.0.
If you are migrating from HDP 3.1.5 to CDP Private Cloud Base 7.1.6, then:
- The supported Runtime version is 7.1.6.
- The supported Cloudera Manager version is 7.3.1.
- The supported AM2CM tool version is AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1,AM2CM 2.4.0,2.3.0.0,2.1.0.0, 2.0.4.0, 2.0.3.0, and 2.0.2.0.

The following table shows the supported versions of HDP and Ambari on the source cluster, Cloudera Manager and CDP on the target cluster, and the AM2CM tool:

HDP Version	Operating System	Ambari Version	AM2CM Version	Cloudera Manager Version	CDP Version
HDP 3.1.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.7.5	AM2CM 2.8.1.0,AM2CM 2.6.0.0, AM2CM 2.4.3.0,AM2CM 2.4.2.0, AM2CM 2.4.1.1,	Cloudera Manager 7.6.7	CDP PvC Base 7.1.7 SP2
HDP 3.1.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.7.5	AM2CM 2.8.1.0,AM2CM 2.6.0.0,AM2CM 2.4.3.0,AM2CM 2.4.2.0, AM2CM 2.4.1.1,	Cloudera Manager 7.7.1	CDP PvC Base 7.1.8
HDP 3.1.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.7.5	AM2CM 2.8.1.0, AM2CM 2.4.3.0,AM2CM 2.4.2.0, AM2CM 2.4.1.1,	Cloudera Manager 7.6.1	CDP PvC Base 7.1.7 SP1
HDP 3.1.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.7.5	AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1,AM2CM 2.4.0,2.3.0.0,2.1.0.0, 2.0.4.0, 2.0.3.0, and 2.0.2.0	Cloudera Manager 7.4.4	CDP PvC Base 7.1.7
HDP 3.1.5	RHEL 7	Ambari 2.7.5	AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0,AM2CM 2.4.1.1,AM2CM 2.4.0,2.3.0.0 2.1.0.0, 2.0.4.0, 2.0.3.0, 2.0.2.0, and1.2.0.0	Cloudera Manager 7.3.1	CDP PvC Base 7.1.6

The final step of the upgrade process is to transition from the Ambari to Cloudera Manager latest version using the AM2CM tool. It includes the following steps:

HDP cluster blueprint is exported from Ambari and converted to a Cloudera Manager deployment template using the AM2CM tool.
Deploy the template to Cloudera Manager and activate the Cloudera Runtime 7.1.x parcels.
Start using the CDP Private Cloud Base cluster with Cloudera Manager.
Uninstall Ambari and the HDP stack

Troubleshooting: A selection of Cloudera Knowledge Base articles are available that describe common issues encountered by Cloudera customers during upgrades and migrations. See CDP Upgrade/Migrate Troubleshooting Articles. (Cloudera login required.)