Cloudera Docs

Supported in-place upgrade paths

Supported upgrade paths for Cloudera Base on premises, Cloudera Data Services on premises, CDH, and HDP.

The tables below detail the supported upgrade paths for upgrades to Cloudera Base on premises and Cloudera Data Services on premises. Before upgrading, ensure that you select a compatible version of Cloudera Manager. See Cloudera Manager Support Matrix.

For supported upgrades to CDH, see Supported Upgrade Paths

Upgrades from Cloudera Director are not supported.

Table 1. Upgrade paths for Cloudera Base on premises
Upgrade supported from: Upgrade to: Notes
Cloudera Base on premises 7.3.1.400 SP2 / Cloudera Manager 7.13.1.400 CHF4
Cloudera Base on premises 7.3.1.200 SP1 / Cloudera Manager 7.13.1.200 CHF2
Cloudera Base on premises 7.3.1 or 7.3.1.100 CHF1 / Cloudera Manager 7.13.1
  • If you want to upgrade from CDP Private Cloud Base 7.1.9 SP1 or 7.1.7 SP3 to Cloudera Base on premises 7.3.1 or 7.3.1.100 CHF1, you must not have any CHF installed on CDP Private Cloud Base 7.1.9 SP1 or 7.1.7 SP3. The CHFs on CDP Private Cloud Base 7.1.9 SP1 or 7.1.7 SP3 are not in sync with Cloudera Base on premises 7.3.1 or 7.3.1.100 CHF1.
  • Trying to upgrade from CDP Private Cloud Base 7.1.9 SP1 or 7.1.7 SP3 with any CHF to Cloudera Base on premises 7.3.1 or 7.3.1.100 CHF1 could lead to feature regression or loss of few bug fixes.
  • Trying to upgrade from CDP Private Cloud Base 7.1.8 CHF 18 and higher to Cloudera Base on premises 7.3.1 or 7.3.1.100 CHF1 could lead to feature regression or loss of few bug fixes.
  • CDP Private Cloud Base 7.1.8 CHF2 or higher / Cloudera Manager 7.7.1
  • CDP Private Cloud Base 7.1.8 CHF2 or higher / Cloudera Manager 7.7.3
  • CDP Private Cloud Base 7.1.7.2000 (SP2) / Cloudera Manager 7.6.7
  • CDP Private Cloud Base 7.1.7.1000 (SP1) / Cloudera Manager 7.6.1
 CDP Private Cloud Base 7.1.9 / Cloudera Manager 7.11.3
  • CDP Private Cloud Base 7.1.8 / Cloudera Manager 7.7.1
  • CDP Private Cloud Base 7.1.7.1000 (SP1) / Cloudera Manager 7.6.1
  • CDP Private Cloud Base 7.1.7.78 (HOTFIX-4836 “Log4j”)
  • CDP Private Cloud Base 7.1.7 / Cloudera Manager 7.4.4
  • CDP Private Cloud Base 7.1.7.78 / Cloudera Manager 7.5.4-20668437 (w/ Log4J fixes)
  • CDP Private Cloud Base 7.1.7.1000 / Cloudera Manager 7.6.1 (SP1)
  • CDP Private Cloud Base 7.1.7 / Cloudera Manager 7.4.4
  • CDP Private Cloud Base 7.1.6 / Cloudera Manager 7.3.1
  • CDP Private Cloud Base / Cloudera Manager 7.1.1, 7.1.2, 7.1.3, 7.1.4
  • CDP Private Cloud Base 7.1.5 / Cloudera Manager 7.2.4
 CDP Private Cloud Base 7.1.8 / Cloudera Manager 7.7.1
Upgrading Cloudera Manager to version 7.7.1 or higher from clusters where CDH 5.x is deployed is not supported. To upgrade such clusters:
  1. Upgrade Cloudera Manager to version 6.3.4.
  2. Upgrade CDH to version 6.3.4
  3. Upgrade Cloudera Manager to version 7.7.1
  • CDP Private Cloud Base 7.0.3 - 7.1.6
  • Cloudera Manager 7.0.3-7.1.4, 7.2.4, 7.3.1
 CDP Private Cloud Base 7.1.7 / Cloudera Manager 7.4.4
  • Lower versions of CDP Private Cloud Base 7.0.3 - 7.1.6
  • Lower versions of Cloudera Manager 7.0.3-7.1.4, 7.3.1
 CDP Private Cloud Base 7.1.1 - 7.1.6 / Cloudera Manager 7.1.1-7.1.4, 7.3.1
Table 2. Upgrade paths for Cloudera Base on premises Service Packs
Upgrade supported from: Upgrade to: Notes
CDP Private Cloud Base 7.1.9.1000 (SP1) / Cloudera Manager 7.11.3 Latest cumulative hotfix
  • CDP Private Cloud Base 7.1.7.2000 (SP2) / Cloudera Manager 7.6.7 Latest cumulative hotfix
  • CDP Private Cloud Base 7.1.7.1000 (SP1) / Cloudera Manager 7.6.1
  • CDP Private Cloud Base 7.1.7 / Cloudera Manager 7.4.4
  • CDP Private Cloud Base 7.1.6 / Cloudera Manager 7.3.1
 CDP Private Cloud Base 7.1.7.3000 (SP3) / Cloudera Manager 7.11.3 Latest cumulative hotfix
  • CDP Private Cloud Base 7.1.7.1000 (SP1) / Cloudera Manager 7.6.1
  • CDP Private Cloud Base 7.1.7 (Log4J2) / Cloudera Manager 7.4.4 (Log4J)
  • CDP Private Cloud Base 7.1.6 / Cloudera Manager 7.3.1
 CDP Private Cloud Base 7.1.7.2000 (SP2) Latest cumulative hotfix / Cloudera Manager 7.6.7
CDP Private Cloud Base 7.1.7/Cloudera Manager 7.4.4 CDP Private Cloud Base 7.1.7.1000 (SP1) Latest cumulative hotfix / Cloudera Manager 7.6.1
  • Parcel upgrade only required (running the Upgrade Wizard is not required). See Applying a Service Pack.
  • Cloudera Manager 7.6.5 is intended for use with CDP Private Cloud Base with CDP Private Cloud Data Services. Cloudera does not recommend using Cloudera Manager 7.6.5 in CDP Private Cloud Base environments without CDP Private Cloud Data Services installations.
Table 3. Upgrade paths for Cloudera Data Services on premises 1.5.5
Source version Target version
Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises
Fresh install of Cloudera Data Services on premises 1.5.5
NA NA NA 7.13.1 Cumulative hotfix 3 7.1.9 Service Pack 1 Cumulative hotfix 7 1.5.5
NA NA NA 7.13.1 Cumulative hotfix 3 7.1.7 SP3 CHF 10 1.5.5
Using Cloudera Base on premises, but new to Cloudera Data Services on premises 1.5.5
Cloudera Manager 7.11.3 CHF6 7.1.9 CHF6 1.5.4 7.13.1 Cumulative hotfix 3 7.1.9 Service Pack 1 Cumulative hotfix 7 1.5.5
Cloudera Manager 7.11.3 CHF6 7.1.8 CHF22 1.5.4 7.13.1 Cumulative hotfix 3 7.1.9 Service Pack 1 Cumulative hotfix 7 1.5.5
Cloudera Manager 7.11.3 CHF6 7.1.7 SP3 1.5.4 7.13.1 Cumulative hotfix 3 7.1.7 SP3 CHF 10 1.5.5
Using Cloudera Data Services on premises and wanting to upgrade to the latest version without upgrading Cloudera Base on premises version
7.11.3 Cumulative hotfix 11 7.1.9 Service Pack 1 Cumulative hotfix 7 1.5.4 SP1 7.13.1 Cumulative hotfix 3 7.1.9 Service Pack 1 Cumulative hotfix 7 1.5.5
7.13.1 Cumulative hotfix 1 7.1.7 SP3 CHF 10 1.5.4 SP2 7.13.1 Cumulative hotfix 3 7.1.7 SP3 CHF 10 1.5.5
7.11.3 Cumulative hotfix 7 and 7.11.3 Cumulative hotfix 9.1 7.1.7 SP3 CHF 10 1.5.4 CHF1 and CHF3 7.13.1 Cumulative hotfix 3 7.1.7 SP3 CHF 10 1.5.5
7.11.3 Cumulative hotfix 1 7.1.9 Service Pack 1 Cumulative hotfix 7 1.5.3 SP1 and 1.5.3 7.13.1 Cumulative hotfix 3 7.1.9 Service Pack 1 Cumulative hotfix 7 1.5.5
Table 4. Upgrade paths for Cloudera Data Services on premises 1.5.4 SP2
Source version Target version
Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises
Fresh install of Cloudera Data Services on premises 1.5.4 SP2
NA NA NA 7.13.1 Cumulative hotfix 1 7.1.9 Cumulative hotfix 7 1.5.4 SP2
NA NA NA 7.13.1 Cumulative hotfix 1 7.1.9 Service Pack 1 1.5.4 SP2
NA NA NA 7.13.1 Cumulative hotfix 1 7.1.7 SP3 1.5.4 SP2
Using Cloudera Base on premises, but new to Cloudera Data Services on premises 1.5.4 SP2
7.11.3 Cumulative hotfix 6 7.1.9 Cumulative hotfix 6 1.5.4 7.13.1 Cumulative hotfix 1 7.1.9 Cumulative hotfix 7 1.5.4 SP2
7.11.3 Cumulative hotfix 6 7.1.8 Cumulative hotfix 22 or higher 1.5.4 7.13.1 Cumulative hotfix 1 7.1.9 Service Pack 1 Cumulative hotfix 4 1.5.4 SP2
7.11.3 Cumulative hotfix 6 7.1.7 SP3 1.5.4 7.13.1 Cumulative hotfix 1 7.1.7 SP3 1.5.4 SP2
7.11.3 Cumulative hotfix 4 7.1.7 SP2, 7.1.8 CHF 17, 7.1.9.4 1.5.3 7.13.1 Cumulative hotfix 1 7.1.7 SP 3, 7.1.9 Cumulative hotfix 7, or 7.1.9 SP1 CHF 4 1.5.4 SP2
Using Cloudera Data Services on premises and wanting to upgrade to the latest version without upgrading Cloudera Base on premises version
7.11.3 Cumulative hotfix 4 7.1.9 Cumulative hotfix 7 1.5.3 7.13.1 Cumulative hotfix 1 7.1.9 Cumulative hotfix 7 1.5.4 SP2
7.11.3 Cumulative hotfix 4 7.1.9 Service Pack 1 1.5.3 7.13.1 Cumulative hotfix 1 7.1.9 Service Pack 1 1.5.4 SP2
7.11.3 Cumulative hotfix 4 7.1.7 SP3 1.5.3 7.13.1 Cumulative hotfix 1 7.1.7 SP3 1.5.4 SP2
7.11.3 Cumulative hotfix 1 7.1.7 SP3 1.5.2 7.13.1 Cumulative hotfix 1 7.1.7 SP3 1.5.2->1.5.4-> 1.5.4 SP2
Table 5. Upgrade paths for Cloudera Data Services on premises 1.5.4 SP1
Source version Target version
Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises
Fresh install of Cloudera Data Services on premises 1.5.4 SP1
NA NA NA 7.11.3 Cumulative hotfix 11 7.1.9 Cumulative hotfix 7 1.5.4 SP1
NA NA NA 7.11.3 Cumulative hotfix 11 7.1.9 Service Pack 1 CHF 4 1.5.4 SP1
NA NA NA 7.11.3 Cumulative hotfix 11 7.1.7 SP3 1.5.4 SP1
Using Cloudera Base on premises, but new to Cloudera Data Services on premises 1.5.4 SP1
7.11.3 Cumulative hotfix 6 7.1.9 Cumulative hotfix 6 1.5.4 7.11.3 Cumulative hotfix 11 7.1.9 Cumulative hotfix 7 1.5.4 SP1
7.11.3 Cumulative hotfix 6 7.1.8 Cumulative hotfix 22 or higher 1.5.4 7.11.3 Cumulative hotfix 11 7.1.9 Service Pack 1 CHF4 1.5.4 SP1
7.11.3 Cumulative hotfix 6 7.1.8 Cumulative hotfix 22 or higher and 7.1.7 SP3 1.5.4 7.11.3 Cumulative hotfix 11 7.1.7 SP3 1.5.4 SP1
7.11.3 Cumulative hotfix 4 7.1.9.4, 7.1.7 SP2, 7.1.8 CHF 17 1.5.3 7.11.3 Cumulative hotfix 11 7.1.7 SP3, 7.1.9 Cumulative hotfix 7, 7.1.9 Service Pack 1 CHF4 1.5.4 SP1
Using Cloudera Data Services on premises and wanting to upgrade to the latest version without upgrading Cloudera Base on premises version
7.11.3 Cumulative hotfix 4 7.1.9 Cumulative hotfix 7 1.5.3 7.11.3 Cumulative hotfix 6 7.1.9 Cumulative hotfix 7 1.5.4 SP1
7.11.3 Cumulative hotfix 4 7.1.9 Service Pack 1 1.5.3 7.11.3 Cumulative hotfix 6 7.1.9 Service Pack 1 1.5.4 SP1
7.11.3 Cumulative hotfix 4 7.1.7 SP3 1.5.3 7.11.3 Cumulative hotfix 6 7.1.7 SP3 1.5.4 SP1
7.11.3 Cumulative hotfix 1 7.1.7 SP3 1.5.2 7.11.3 Cumulative hotfix 6 7.1.7 SP3 1.5.2->1.5.4-> 1.5.4 SP1
Table 6. Upgrade paths for Cloudera Data Services on premises 1.5.4
Source version Target version
Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises Cloudera Manager Cloudera Base on premises Cloudera Data Services on premises
Fresh install of Cloudera Data Services on premises 1.5.4
NA NA NA 7.11.3 Cumulative hotfix 6 7.1.9 Cumulative hotfix 6 1.5.4
NA NA NA 7.11.3 Cumulative hotfix 6 7.1.8 Cumulative hotfix 22 or higher 1.5.4
NA NA NA 7.11.3 Cumulative hotfix 6 7.1.7 SP3 1.5.4
Using Cloudera Base on premises, but new to Cloudera Data Services on premises 1.5.4
7.11.3 Cumulative hotfix 4 7.1.9.4 1.5.3 7.11.3 Cumulative hotfix 6 7.1.9 Cumulative hotfix 6 1.5.4
7.7.3 Latest cumulative hotfix 7.1.8 Cumulative hotfix 17 1.5.3 7.11.3 Cumulative hotfix 6 7.1.8 Cumulative hotfix 22 or higher 1.5.4
7.11.3 Cumulative hotfix 4 7.1.7 SP2 1.5.3 7.11.3 Cumulative hotfix 6 7.1.7 SP3 1.5.4
7.11.3 Cumulative hotfix 1 7.1.7 SP2, 7.1.8 Cumulative hotfix 11, 7.1.9 1.5.2 7.11.3 Cumulative hotfix 6 7.1.9 Cumulative hotfix 6, 7.1.8 Cumulative hotfix 22 or higher, and 7.1.7 SP3 1.5.4
Using Cloudera Data Services on premises and wanting to upgrade to the latest version without upgrading Cloudera Base on premises version
7.11.3 Cumulative hotfix 4 7.1.9 Cumulative hotfix 6 1.5.3 7.11.3 Cumulative hotfix 6 7.1.9 Cumulative hotfix 6 1.5.4
7.11.3 Cumulative hotfix 4 7.1.8 Cumulative hotfix 22 or higher 1.5.3 7.11.3 Cumulative hotfix 6 7.1.8 Cumulative hotfix 22 or higher 1.5.4
7.11.3 Cumulative hotfix 4 7.1.7 SP3 1.5.3 7.11.3 Cumulative hotfix 6 7.1.7 SP3 1.5.4
7.11.3 Cumulative hotfix 1 7.1.8 Cumulative hotfix 22 or higher 1.5.2 7.11.3 Cumulative hotfix 6 7.1.8 Cumulative hotfix 22 or higher 1.5.4
Table 7. Upgrade paths for CDP Private Cloud Data Services 1.5.3
Source version Target version
Cloudera Manager CDP Private Cloud Base CDP Private Cloud Data Services Cloudera Manager CDP Private Cloud Base CDP Private Cloud Data Services
Greenfield deployment of CDP Private Cloud Data Services 1.5.3
NA NA NA 7.11.3 Cumulative hotfix 4 7.1.9 Cumulative hotfix 3 1.5.3
NA NA NA 7.11.3 Cumulative hotfix 4 7.1.8 Cumulative hotfix 19 or higher 1.5.3
NA NA NA 7.11.3 Cumulative hotfix 4 7.1.7 SP2 1.5.3
Using CDP Private Cloud Base, but new to CDP Private Cloud Data Services 1.5.3
7.11.3 Cumulative hotfix 1 7.1.9 Cumulative hotfix 3 NA 7.11.3 Cumulative hotfix 4 7.1.9 Cumulative hotfix 3 1.5.3
7.7.3 Latest cumulative hotfix 7.1.8 Cumulative hotfix 19 or higher NA 7.11.3 Cumulative hotfix 4 7.1.8 Cumulative hotfix 19 or higher 1.5.3
7.7.1 Latest cumulative hotfix 7.1.8 Cumulative hotfix 19 or higher NA 7.11.3 Cumulative hotfix 4 7.1.8 Cumulative hotfix 19 or higher 1.5.3
7.6.7 Latest cumulative hotfix 7.1.7 SP2 NA 7.11.3 Cumulative hotfix 4 7.1.7 SP2 1.5.3
Using CDP Private Cloud Data Services and wanting to upgrade to the latest version without upgrading CDP Private Cloud Base version
7.11.3 Cumulative hotfix 1 7.1.9 Cumulative hotfix 3 1.5.2 7.11.3 Cumulative hotfix 4 7.1.9 Cumulative hotfix 3 1.5.3
7.11.3 Cumulative hotfix 1 7.1.8 Cumulative hotfix 19 or higher 1.5.2 7.11.3 Cumulative hotfix 4 7.1.8 Cumulative hotfix 19 or higher 1.5.3
7.11.3 Cumulative hotfix 1 7.1.7 SP2 1.5.2 7.11.3 Cumulative hotfix 4 7.1.7 SP2 1.5.3
7.10.1 7.1.8 Cumulative hotfix 19 or higher 1.5.1 7.11.3 Cumulative hotfix 4 7.1.8 Cumulative hotfix 19 or higher 1.5.3
7.10.1 7.1.7 SP2 1.5.1 7.11.3 Cumulative hotfix 4 7.1.7 SP2 1.5.3
Table 8. Upgrade paths for CDH
Upgrade supported from: Upgrade to: Notes
  • CDH 6.3.4 / Cloudera Manager 6.3.4
  • CDH 6.2.1 / Cloudera Manager 6.2.1
  • CDH 6.3.4 / Cloudera Manager 6.3.4
  • CDH 6.2.1 / Cloudera Manager 6.2.1
  • CDH 6.3.4 / Cloudera Manager 6.3.4
  • CDH 6.2.1 / Cloudera Manager 6.2.1
  • CDH 6.1.1 / Cloudera Manager 6.1.1
  • CDH 5.16.2 / Cloudera Manager 5.16.2
  • CDH 5.16.2 / Cloudera Manager 6.3.1
 CDP Private Cloud Base 7.1.7.2000 (SP2) / Cloudera Manager 7.6.7
  • CDH / Cloudera Manager 6.1 - 6.3
CDP Private Cloud Base 7.1.8 / Cloudera Manager 7.7.1
Upgrading Cloudera Manager to version 7.7.1 or higher from clusters where CDH 5.x is deployed is not supported. To upgrade such clusters:
  1. Upgrade Cloudera Manager to version 6.3.4.
  2. Upgrade CDH to version 6.3.4
  3. Upgrade Cloudera Manager to version 7.7.1
  • CDH / Cloudera Manager 5.13-5.16
  • CDH / Cloudera Manager 6.1-6.3
 CDP Private Cloud Base 7.1.7 /Cloudera Manager 7.4.4
  • CDH / Cloudera Manager 5.13 - 5.16
  • CDH / Cloudera Manager 6.1, 6.2
 CDH 6.3
CDH / Cloudera Manager 5.0 - 5.12 CDH / Cloudera Manager 5.13 - 5.16 Upgrades from Cloudera Manager/CDH 5.0 - 5.12 to CDP Private Cloud Base require that you first upgrade to Cloudera Manager/CDH 5.13 or higher.
Table 9. Upgrade paths for HDP
Upgrade supported from: Upgrade to: Notes
HDP 3.1.5 CDP Private Cloud Base 7.1.7 SP1, CDP Private Cloud Base 7.1.8, CDP Private Cloud Base 7.1.7 SP2, 7.1.9, CDP Private Cloud Base 7.1.7 SP3, and CDP Private Cloud Base 7.1.9 SP1. One stage upgrade.
HDP 2.6.5 CDP Private Cloud Base 7.1.8, CDP Private Cloud Base 7.1.7 SP2, and CDP Private Cloud Base 7.1.7 SP3. One stage upgrade.
HDP 3.1.5 CDP Private Cloud Base 7.1.8 / Cloudera Manager 7.7.1 Two stage upgrade from Ambari required.
HDP 2.6.5 CDP Private Cloud Base 7.1.8 / Cloudera Manager 7.7.1.

Requires an interim upgrade to CDP Private Cloud Base 7.1.7/Cloudera Manager 7.4.4.

 Two stage upgrade from Ambari required.
HDP 2.6.5 CDP Private Cloud Base 7.1.1 - 7.1.7 You can upgrade from HDP 2.6.5 and Ambari 2.6.2.x to CDP Private Cloud Base 7.1.x This upgrade requires several major steps, including upgrading to an interim version of Ambari. After the upgrade, your cluster will be managed by Cloudera Manager and the components will be upgraded to Cloudera Runtime 7.1.1 or higher.