Upgrading to Cloudera Manager 4.5

You can upgrade existing Cloudera Manager and Cloudera's Distribution Including Apache Hadoop (CDH) to this version. Upgrading preserves existing data and settings, while enabling the use of the new features provided with the latest product versions. To enable new features, some new settings are added, but nothing is removed.

Understanding Upgrades

The process for upgrading to Cloudera Manager varies based on the starting point. The categories of tasks to be completed include the following:

  • Install any databases that are newly required for this release.
  • Upgrade Cloudera Manager.
  • Upgrade hosts in the cluster.

Before Upgrading

  • The Cloudera Manager Server must have SSH access to the cluster hosts and you must log in using a root account or an account that has password-less sudo permission. See Requirements for Cloudera Manager for more information.
  • Ensure there are no running commands. Use the Admin Console's main navigation bar to check for any running commands. You can either wait for commands to complete or abort any running commands. For more information on viewing and aborting running commands, see Viewing Running and Recent Commands.
  • Ensure you have completed any required process for preparing databases, as described in Database Considerations for Cloudera Manager Upgrades.

During the Upgrade

During the upgrade process, the following changes occur:

  • The database schemas are modified for any databases storing information for Cloudera Manager Server, Activity Monitor, Service Monitor, Report Manager, and Host Monitor.
  • Configuration information is reorganized.

After Upgrading

After completing an upgrade to 4.5, the following is true:

  • You should deploy client configurations to ensure client services have the most current configuration.
  • Required databases are established to store information for Cloudera Manager Server, Activity Monitor, Service Monitor, Report Manager, and Host Monitor.
  • The database schemas reflect the current version.
  • The Host Monitor service is added and active.
  • The Cloudera Manager Server and all supporting services, such as the Activity Monitor, Service Monitor, Report Manager, and Host Monitor are updated.

Upgrade Paths

In some cases, completing an upgrade requires changes to your environment, and in other cases, elements are already in place. For example, if you are upgrading your environment from 3.7 to 4.5, you must add Host Monitor, but if you are upgrading from 4.0 to 4.5, this is not required, as Host Monitor is included in 4.0. The specific steps required vary based on the path taken.

To upgrade from an older version of Cloudera Manager, begin by upgrading to 3.7, and then proceed to upgrade from there.


Cloudera Manager 4.5 works with CDH3 and CDH4, but does not work with CDH4.0 beta. You must upgrade any installations of CDH4.0 beta.

Begin the upgrade process by evaluating Database Considerations for Cloudera Manager Upgrades.