Cloudera Enterprise 5.15.x | Other versions

Upgrading CDH Using Cloudera Manager

You can use Cloudera Manager to upgrade CDH for major, minor, and maintenance upgrades. The procedures vary depending on the version of Cloudera Manager you are using and from which versions of CDH you are upgrading. Procedures to upgrade Cloudera Manager installations are different when using parcels compared to packages.

After completing preparatory steps, you use the Cloudera Manager upgrade wizard to complete the upgrade. If you use parcels (recommended), have enabled HDFS High Availability, and have a Cloudera Enterprise license, you can perform a rolling upgrade that does not require you to take the cluster offline during the upgrade.

The Cloudera Manager minor version must always be equal to or greater than the CDH minor version because older versions of Cloudera Manager may not support features in newer versions of CDH. For example, if you want to upgrade to CDH 5.4.8, you must first upgrade to Cloudera Manager 5.4 or higher. To upgrade Cloudera Manager, see Overview of Upgrading Cloudera Manager.

Choose one of the following procedures to upgrade CDH using Cloudera Manager:

Upgrading CDH 5.x

The procedures for upgrading to CDH 5.x differ for minor release upgrades and maintenance release upgrades.

Minor Version Upgrades

To upgrade CDH 5.x to a higher version of CDH, for example from CDH 5.4 to CDH 5.8, see Upgrading CDH. You can choose to upgrade using either parcels or packages.
  • Parcels – This option uses Cloudera Manager to upgrade CDH and allows you to upgrade your cluster either via a full restart or a rolling restart if you have HDFS high availability enabled and have a Cloudera Enterprise license. The use of Parcels requires that your cluster be managed by Cloudera Manager. This includes any components that are not a regular part of CDH, such as Spark 2.
  • Packages – This option is the most time consuming and requires you to log in using ssh and execute a series of package commands on all hosts in your cluster. Cloudera recommends that you instead upgrade your cluster using parcels, which allows Cloudera Manager to distribute the upgraded software to all hosts in the cluster without having to log in to each host. If you installed the cluster using packages, you can upgrade using parcels and the cluster will use parcels for subsequent upgrades.

    If the CDH cluster you are upgrading was installed using packages, you can upgrade it using parcels, and the upgraded version of CDH will then use parcels for future upgrades or changes. You can migrate your cluster from using packages to using parcels before starting the upgrade.

Maintenance Version Upgrades

Maintenance upgrades fix critical bugs or address security issues. No new functionality or incompatible changes are introduced. The version numbers for maintenance releases differ only in the third digit, for example, when upgrading from CDH 5.8.0 to CDH 5.8.2.

To upgrade to a maintenance release, you only need to perform a subset of the Minor version upgrade steps. Follow the same procedures as for minor version upgrades but skip the steps that are labeled as follows:

[Not required for CDH maintenance release upgrades.].

Page generated May 18, 2018.