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.

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

Upgrading and transitioning to CDP Private Cloud Base

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

To upgrade and transition to CDP Private Cloud Base perform the following steps:

Review the Upgrade document topic for the supported upgrade paths.
Gather information on your deployment and verify cluster environment readiness.
Prepare sample data for ingestion.
Validate Apache Hive constructs before you upgrade.
Plan how and when to begin your upgrade.
Check readiness and upgrade from Ambari 2.7.5.x to Ambari 7.1.x .
Upgrade from HDP 3.1.5 to HDP 7.1.x and complete post-upgrade tasks.
Transition from HDP to Cloudera Manager.
1. Perform the pre-transition steps for the components deployed in your clusters including exporting blueprint with hosts from Ambari.
2. Install Cloudera Manager 7.3.1 - the Cloudera Manager server, daemons, and agents.
3. Generate Cloudera Manager Deployment template using the AM2CM tool and the exported blueprint with hosts.
4. Shutdown Ambari and HDP and import the deployment template into Cloudera Manager.
5. Download, distribute, and activate Cloudera Runtime 7.1.x parcels using Cloudera Manager.
6. Start CDP Private Cloud Base using Cloudera Manager.
7. Perform the post transition steps in Cloudera Manager.
Configure external authentication with Cloudera Manager if you have LDAP configured on your cluster.
Install additional services like Hue on your cluster using Cloudera Manager.
Test and update applications and services on your CDP cluster.