In-place upgrade overview

This document provides instructions on upgrading from Ambari managed HDP 3.1.5 to CDP Private Cloud Base.

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.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-1.2.0.0-45.tar.gz.

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	Ambari Version	AM2CM Version	Cloudera Manager Version	CDP Version
HDP 3.1.5	Ambari 2.7.5	AM2CM 1.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 7.3.1 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 7.3.1 and activate the Cloudera Runtime 7.1.x parcels.
Start using the CDP Private Cloud Base cluster with Cloudera Manager 7.3.1.
Uninstall Ambari and the HDP stack

note

If you are upgrading from HDP 3.0.0.x/3.0.1.x/3.1.0.x/3.1.4.x/3.1.5.0 and HBase is part of your HDP cluster, you must first upgrade to HDP 3.1.5.6091-7 to prevent HBase data loss. Also, ensure that all the previously installed hotfixes on your current HDP version are part of HDP 3.1.5.6091-7. If the hotfixes are not a part or you are not certain, you must contact Cloudera Support.
If you are upgrading from a hotfix on top of HDP 3.1.5 and HBase is part of your HDP cluster, you must contact Cloudera Support and ask for HBASE-23044 and HBASE-25206 in a hotfix and upgrade to the hotfix.