Java Runtime Environment

  • Make sure to uninstall any previous version of Java™ before you install the newest version. The minimum patch level that is required for Java 1.8 is 1.8.0_191 and for Java 11 is 11.0.11. Failing to use Java 1.8.0_191 or Java 11.0.11 a later version will cause IBM® AD to not work.
  • IBM AD Build Client runs only on the 64-bit JVM.
  • 64-bit AdoptOpenJDK 8/11 HotSpot -
    • Make sure to download the JRE version of AdoptOpenJDK for the target platform.
    • Make sure that Set JAVA_HOME variable and JavaSoft (Oracle) registry keys subfeatures are selected when you install AdoptOpenJDK Development Kit with Hotspot.
  • 64-bit Java 8/11 Oracle
    Important: Make sure that the system variable JAVA_HOME is added and the value of the JAVA_HOME is correct when you install Oracle Java.
  • 64-bit Java 8/11 IBM -
    • On Windows
      Since there is no executable for IBM Java, it needs to be unzipped, and you need to set the IBM Java path in Windows Registry.
      Important: IBM AD installer is looking in Windows Registry to find out the IBM Java path. Use extreme caution when you edit the Windows Registry. Incorrect edits can render your computer unusable.
      1. Create the following path: Computer > HKEY_LOCAL_MACHINE > SOFTWARE > JavaSoft > Java Development Kit > 1.8.
      2. Right-click 1.8, and then select New > String Value.
      3. Rename New Value #1 to JavaHome.
      4. Right-click JavaHome, and then select Modify.
      5. In Value data, enter the path to the unzipped IBM Java folder.
        Figure 1. IBM Java path
        This image shows the IBM Java path.
        Note: ibm_sdk80 represents the IBM Java version that is used during the installation process.
      6. Restart the Windows machine so that the changes can take effect.
  • To ensure that the path for Java instance is set at the beginning of the PATH system environment variable in your system, follow these steps:
    1. Go to Start > System > Advanced Settings > Environment Variables > System variables.
    2. Locate the Path variable and click Edit.
    3. Add the path to the Java installation folder, including the bin folder. For example, C:\Program Files\Java\jdk-11\bin.
    4. If the path is already created, make sure to place the Java instance path at the beginning of the list. Then, click Ok to save the changes.

    By this setting, you can ensure that your system prioritizes the specified Java installation.

  • To ensure the consistency between the installed Java version in Environment Variables > System Variables and the Java version in the JavaHome key of Registry Editor, follow the description below.
    • To find the Java version that is associated with the PATH variable, click System Properties > Advanced > Environment Variables > System Variables. (This should be found on the first row in the top of the list as shown below.)
    • To find the Java version that is associated with the JavaHome string, click Windows Registry Editor > Computer > HKEY_LOCAL_MACHINE > SOFTWARE > JavaSoft > JDK.