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

Upgrading to Oracle JDK 1.7

Oracle JDK 1.7 is required for CDH 5. Follow the instructions on this page to upgrade to Java 1.7 before you upgrade to CDH 5.

The process for upgrading to Oracle JDK 1.7 varies depending on whether you have a Cloudera Manager Deployment or an Unmanaged Deployment.

  Important: If you are upgrading from JDK 1.6 to JDK 1.7 and you are using AES-256 bit encryption, you must install new encryption policy files. (In a Cloudera Manager deployment, Cloudera Manager offers you an option to automatically install the policy files; for unmanaged deployments, install them manually.) See If you are Using AES-256 Encryption, install the JCE Policy File.

For both managed and unmanaged deployments, you must also ensure that the Java Truststores are retained during the upgrade. (See Creating Truststores.)

Upgrading to Oracle JDK 1.7 in a Cloudera Manager Deployment

Minimum Required Role: Cluster Administrator (also provided by Full Administrator)

  1. Upgrade the JDK using one of the following processes:
  2. In the Cloudera Manager Admin Console, restart all services:
    1. On the Home > Status tab, click next to the cluster name and select Restart.
    2. In the confirmation dialog box that displays, click Restart.
  3. If the cluster host is also running Cloudera Management Service roles, restart the Cloudera Management Service.
    1. Do one of the following:
        1. Select Clusters > Cloudera Management Service > Cloudera Management Service.
        2. Select Actions > Restart.
      • On the Home > Status tab, click to the right of Cloudera Management Service and select Restart.
    2. Click Restart to confirm. The Command Details window shows the progress of stopping and then starting the roles.
    3. When Command completed with n/n successful subcommands appears, the task is complete. Click Close.

Upgrading to Oracle JDK 1.7 in an Unmanaged Deployment

  Important:
  • If you use Cloudera Manager, do not use these command-line instructions.
  • This information applies specifically to CDH 5.8.x. If you use a lower version of CDH, see the documentation for that version located at Cloudera Documentation.
  1. Shut down the cluster, following directions in the documentation for the CDH 4 release you are currently running.
  2. Clean up existing JDK versions.
  3. On each cluster host:
    1. Install the same supported version of JDK 1.7. See Java Development Kit Installation for instructions.
    2. Verify that you have set JAVA_HOME on each host to the directory where you installed JDK 1.7, as instructed.
  4. Start the CDH upgrade.
Page generated July 8, 2016.