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.

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:
    • Cloudera Manager installation:
      1. When upgrading Cloudera Manager, allow Cloudera Manager to upgrade the JDK when you upgrade Cloudera Manager Agent packages.
      2. If you have configured TLS for Cloudera Manager, as described in Configuring TLS Encryption Only for Cloudera Manager, copy the jssecacerts file from the previous JDK installation to the new JDK installation. For example:
        cp previous_java_home/jre/lib/security/jssecacerts new_java_home/jre/lib/security
        
        (Substitute previous_java_home and new_java_home with the paths to the JDK installations.)
    • Manual installation
      1. 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.
        3. If you have configured TLS for Cloudera Manager, as described in Configuring TLS Encryption Only for Cloudera Manager, copy the jssecacerts file from the previous JDK installation to the new JDK installation. For example:
          cp previous_java_home/jre/lib/security/jssecacerts new_java_home/jre/lib/security
          
          (Substitute previous_java_home and new_java_home with the paths to the JDK installations.)
  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.
  4. Delete your previous Java version files.

Upgrading to Oracle JDK 1.7 in an Unmanaged Deployment

  1. Shut down the cluster, following directions in the documentation for the CDH 4 release you are currently running.
  2. 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.
    3. If you have configured TLS for Cloudera Manager, as described in Configuring TLS Encryption Only for Cloudera Manager, copy the jssecacerts file from the previous JDK installation to the new JDK installation. For example:
      cp previous_java_home/jre/lib/security/jssecacerts new_java_home/jre/lib/security
      
      (Substitute previous_java_home and new_java_home with the paths to the JDK installations.)
  3. Start the CDH upgrade.
  4. Delete your previous Java version files.