MettleCI’s Workbench and Command Line components cannot work with the IBM-specific version of Java typically shipped with DataStage due to technical limitations with that version. To resolve this you need to install a more recent version of Java alongside (not replacing) your IBM-supplied version. This page provides instructions for doing so on Unix and Windows.

For more information about this dependency, refer to the FAQ page Why do I have to install another version of Java?

If you believe that you may already have a compatible Java Virtual Machine installed on your DataStage environment then see Can I use my existing version of Java Virtual Machine?

Installing Java 8 on Unix

Follow these steps before installing the MettleCI Workbench or Command Shell on your Unix host.

Download and Install OpenJDK v8. We test MettleCI with - and therefore recommend - the latest OpenJDK distribution of OpenJDK 8 LTS.

1. If your DataStage Engine tier has direct access to the internet then you can use your machine’s package manger to install Java 8 using an RPM reference which resolves to a URL. For example, on a Red Hat Enterprise Linux host :

   $> sudo yum install java-1.8.0-openjdk-devel.x86_64 $> export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.212.b04-0.el6_10.x86_64 $> export JRE_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.212.b04-0.el6_10.x86_64/jre

2. If your DataStage Engine tier does not have direct access to the internet then you can use your machine’s package manger to install Java 8 using a local RPM file reference.

   1. Download the OpenJDK RPM image from the OpenJDK website (you’ll need to unzip it once you’ve downloaded it.)

   2. Install it using your machine’s package manager. For example, on a Red Hat Enterprise Linux host :

      $> sudo yum localinstall /path/to/file/java-1.8.0-openjdk-devel.x86_64 $> export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.212.b04-0.el6_10.x86_64 $> export JRE_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.212.b04-0.el6_10.x86_64/jre

Installing Java 8 on Windows

Before installing the MettleCI workbench or the MettleCI CLI you’ll need to install Java 8. For example…

1. Download the Windows 64-bit installer for Java 8. We test MettleCI with - and therefore recommend - the latest OpenJDK distribution of OpenJDK 8 LTS.

2. Run the installer and click Next until prompted to accept the license terms.

3. Select the checkbox to accept the licence terms and click Next.

4. Leave the custom setup options as supplied.

5. Open

   

6. Set the System-level PATH environment variable if the installer hasn’t already done so:

   1. Select Control Panel then either System or System and Security then System.

   2. Click Advanced and then Environment Variables.

   3. Add the location of the bin folder of the JDK installation to the PATH variable in System Variables. Ensure that this new entry appears before any other entries that point to a different Java \bin folder.

   4. The following is an example of the PATH variable:

      "C:\Program Files\Java\jdk-8\bin”;C:\WINDOWS\system32;C:\WINDOWS

7. You don’t need to set the JAVA_HOME variable.

See also

• MettleCI Installation Walkthrough - Introduction and Prerequisites