This is the documentation for Cloudera 5.2.x.
Documentation for other versions is available at Cloudera Documentation.

Upgrading Cloudera Manager

Upgrading Cloudera Manager enables new features of the latest product versions while preserving existing data and settings. Some new settings are added, and some additional steps may be required, but no existing configuration is removed.
  Note: When an upgraded Cloudera Manager adds support for a new feature (for example, Sqoop 2, WebHCat, and so on), it does not install the software on which the new feature depends. If you install CDH and managed services from packages, you must add the packages to your managed hosts before adding a service or role that supports the new feature.

Understanding Upgrades

The process for upgrading Cloudera Manager varies depending on the starting point. Categories of tasks to be completed include the following:
  • Install databases required for the release. In Cloudera Manager 5, the Host Monitor and Service Monitor roles use an internal database that provides greater capacity and flexibility. You do not need to configure an external database for these roles. If you are upgrading from Cloudera Manager 4, this transition is handled automatically. If you are upgrading a Free Edition installation and you are running a MapReduce service, you are asked to configure an additional database for the Activity Monitor that is part of Cloudera Express.
  • Upgrade the Cloudera Manager Server.
  • Upgrade the Cloudera Manager Agent. You can use an upgrade wizard that is invoked when you connect to the Admin Console or manually install the Cloudera Manager Agent packages.

Upgrading Cloudera Manager

You can upgrade from any version of Cloudera Manager 4 running CDH 4 to Cloudera Manager 5, or from Cloudera Manager 5 to a later version of Cloudera Manager 5. See the instructions at:
  • Upgrading Cloudera Manager 5 to the Latest Cloudera Manager:
    • The database schema is upgraded to reflect the current version.
    • The Cloudera Manager Server and all supporting services are updated.
    • Client configurations are redeployed to ensure client services have the most current configuration.
  • Upgrading Cloudera Manager 4 to Cloudera Manager 5 and Upgrading Cloudera Manager 3.7.x:
    • The database schema is upgraded to reflect the current version. Data from the existing Host and Service Monitor databases is migrated.
    • The Cloudera Manager Server and all supporting services are updated.
    • Client configurations are redeployed to ensure client services have the most current configuration.
    • Cloudera Manager 5 continues to support a CDH 4 cluster with an existing high availability deployment using NFS shared edits directories. However, if you disable high availability in Cloudera Manager 5, you can re-enable high availability only by using Quorum-based Storage. CDH 5 does not support enabling NFS shared edits directories with high availability.

Upgrading CDH

Cloudera Manager 5 can manage both CDH 4 and CDH 5, so upgrading existing CDH 4 installations is not required. However, to benefit from the most current CDH features, you must upgrade CDH. For more information on upgrading CDH, see Upgrading CDH and Managed Services Using Cloudera Manager.