In-place upgrade overview

To plan your upgrade from Ambari managed HDP 2.6.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 2.6.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.6.2.x (source) to Ambari 7.1.x.x (target) and then upgrade from HDP 2.6.5 to Cloudera Runtime 7.1.x.

Upgrading and transitioning to CDP Private Cloud Base overview:

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 stay on HDP 7.1.x you will not be able to upgrade directly to CDP-7.1.y (where y > x). You must always first upgrade from HDP 7.1.x to CDP 7.1.x and then upgrade to CDP-7.1.y.

The following table shows the supported versions of the AM2CM tool, Cloudera Manager, and Runtime for each upgrade path:

Upgrade path	AM2CM version	Cloudera Manager	Runtime
HDP 2.6.5 to CDP 7.1.7 SP2	AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1 and 2.4.1.0	Cloudera Manager 7.6.7	CDH-7.1.7 SP2
HDP 2.6.5 to CDP 7.1.8	AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1 and 2.4.0.0	Cloudera Manager 7.7.1	CDH-7.1.8
HDP 2.6.5 to CDP 7.1.7 SP1	AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1 and 2.4.1.0	Cloudera Manager 7.6.1	CDH-7.1.7 SP1
HDP 2.6.5 to CDP 7.1.7 or 7.1.6 or 7.1.4	AM2CM 2.8.1.0, 2.1.0.0, 2.0.4.0, 2.0.3.0, and 2.0.2.0	Cloudera Manager 7.4.4	CDH-7.1.7, CDH-7.1.6, and CDH-7.1.4.6 hotfix versions
HDP 2.6.5 to CDP 7.1.7	2.0.0.0	Cloudera Manager 7.4.4	CDH-7.1.7
HDP 2.6.5 to CDP 7.1.6	1.1.1.0	Cloudera Manager 7.3.1	CDH-7.1.6
HDP 2.6.5 to CDP 7.1.4	1.1.0.0	CM-7.2.4_patch4455	CDH-7.1.4.6 hotfix versions

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 2.6.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.6.2.x	AM2CM 2.8.1.0, AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1 and AM2CM 2.4.1.0	Cloudera Manager 7.6.7	CDP PvC Base 7.1.7 SP2
HDP 2.6.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.6.2.x	AM2CM 2.8.1.0,AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1 and AM2CM 2.4.0.0	Cloudera Manager 7.7.1	CDP PvC Base 7.1.8
HDP 2.6.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.6.2.x	AM2CM 2.8.1.0,AM2CM 2.4.3.0, AM2CM 2.4.2.0, AM2CM 2.4.1.1 and AM2CM 2.4.1.0	Cloudera Manager 7.6.1	CDP PvC Base 7.1.7 SP1
HDP 2.6.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.6.2.x	AM2CM 2.8.1.0,AM2CM 2.1.0.0, AM2CM 2.0.4.0, AM2CM 2.0.3.0, and AM2CM 2.0.2.0	Cloudera Manager 7.4.4	CDP PvC Base 7.1.7
HDP 2.6.5	RHEL 7, Sles 12, and Ubuntu 18	Ambari 2.6.2.x	AM2CM 2.8.1.0,AM2CM 2.0.0.0	Cloudera Manager 7.4.4	CDP PvC Base 7.1.7
HDP 2.6.5	RHEL 7	Ambari 2.6.2.x	AM2CM 2.8.1.0,AM2CM 1.1.1.0	Cloudera Manager 7.3.1	CDP PvC Base 7.1.6
HDP 2.6.5	RHEL 7	Ambari 2.6.2.x	AM2CM 2.8.1.0,AM2CM 1.1.0.0	Cloudera Manager 7.2.4_patch-4455	CDP PvC Base 7.1.4
HDP 2.6.5	RHEL 7	Ambari 2.6.2.x	AM2CM 1.0.0.0 (Technical preview)	Cloudera Manager 7.1.3	CDP PvC Base 7.1.3
HDP 2.6.5	RHEL 7	Ambari 2.6.2.x	AM2CM 1.0.0.0 (Technical preview)	Cloudera Manager 7.1.2	CDP PvC Base 7.1.2
HDP 2.6.5	RHEL 7	Ambari 2.6.2.x	AM2CM 1.0.0.0 (Technical preview)	Cloudera Manager 7.1.1	CDP PvC Base 7.1.1

The final step of the upgrade process is to transition from the Ambari to Cloudera Manager 7.x.x 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.x.x and activate the Cloudera Runtime 7.1.x parcels.
Start using the CDP Private Cloud Base cluster with Cloudera Manager 7.x.x.
Uninstall Ambari and the HDP stack

note

Whether you are upgrading to incorporate new features into your environment, or to stay within the lifecycle of products that are serviced and supported, you will eventually want to file an Upgrade Planning Case. When upgrading to CDP Private Cloud Base, Cloudera recommends working with Cloudera Professional Services to simplify your journey and get faster time to value. Cloudera PS offers SmartUpgrade to help you efficiently upgrade or migrate to CDP Private Cloud Base with minimal disruptions to your SLAs. Alternatively, you and your team may have the desire and expertise to perform the upgrade yourself. The choice is yours and Cloudera is here to help.

The Upgrade Planning Cases Guide will help you file an Upgrade Planning case to:

Receive suggestions on which version of the CDP Private Cloud runtime to deploy
Obtain other recommendations to have a better upgrade experience
Communicate with Cloudera when your expected upgrade will take place
Obtain a limited scope "Extended Support" for out of support products while planning to Upgrade to CDP-DC. This limited support will be available until June 30, 2021.

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.)