Java Development Kit Installation

Some installation paths require that you install the Oracle Java Development Kit on hosts before deploying Cloudera Manager, CDH, and managed services. To install the Oracle JDK, follow the instructions in Installing the Oracle JDK. The completed installation, or any already existing installation, must meet the following requirements.

Requirements

The JDK must be 64-bit. Do not use a 32-bit JDK.
Install a supported version:
- CDH 5 - Supported JDK Versions
- CDH 4 - Supported JDK Versions
Install the same version of the Oracle JDK on each host.
Install the JDK in /usr/java/jdk-version.

Important:

You cannot upgrade from JDK 1.7 to JDK 1.8 while upgrading to CDH 5.3. The cluster must already be running CDH 5.3 when you upgrade to JDK 1.8.
If you are upgrading from a lower major version of the JDK to JDK 1.8 or 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.)
On SLES 11 platforms, do not install or try to use the IBM Java version bundled with the SLES distribution. CDH does not run correctly with that version.

Installing the Oracle JDK

The Oracle JDK installer is available both as an RPM-based installer for RPM-based systems, and as a binary installer for other systems.

Download the .tar.gz file for one of the supported versions of the Oracle JDK from Java SE 8 Downloads, Java SE 7 Downloads, or Java SE 6 Downloads. (These links are correct at the time of writing but change frequently.)
Extract the JDK to /usr/java/jdk-version; for example /usr/java/jdk.1.7.0_nn or /usr/java/jdk.1.8.0_nn, where nn is a supported version.
Set JAVA_HOME to the directory where the JDK is installed. Add the following line to the specified files:
```
export JAVA_HOME=/usr/java/jdk.1.7.0_nn
```
- Cloudera Manager Server host: /etc/default/cloudera-scm-server. This affects only the Cloudera Manager Server process, and does not affect the Cloudera Management Service roles.
- All hosts in an unmanaged deployment: /etc/default/bigtop-utils. You do not need to do this for clusters managed by Cloudera Manager.
Follow the instructions in Configuring a Custom Java Home Location. This change affects all CDH cluster processes and Cloudera Management Services in your cluster.

Categories: Installing | Java | Oracle | Requirements | All Categories

Installing Cloudera Manager and CDH

Installing Cloudera Manager, CDH, and Managed Services