For distributed platforms

Installing, updating, and uninstalling IBM SDK, Java Technology Edition

You can install IBM® SDK, Java™ Technology Edition by using IBM Installation Manager Version 1.8.5 or later. Liberty can run with any compliant Java runtime environment (JRE) or Java software development kit (SDK).

About this task

Important:

Java SE 17 is the recommended Java SDK because it provides the latest features and security updates. As an alternative to installing Java SE 17, you can install another supported Java SDK version. Liberty runs on any of the Java SE versions that are listed in the Java SE versions column of the Supported Java Releases table on the Open Liberty website.

The Liberty end of support date for Java SE 11 is October 2024, fix pack 24.0.0.10. The Liberty end of support date for Java SE 8 is October 2026, fix pack 26.0.0.10. The Liberty end of support date for Java SE 17 is October 2027, fix pack 27.0.0.10. For more information, see Removal notices.

Installation Manager supports two types of Java SDK offerings:
  • IBM Semeru Runtimes: These offerings are production-ready binaries that are built with the OpenJDK class libraries and the Eclipse OpenJ9 JVM.
  • Common IBM Java SDKs: These offerings, which are denoted by com.ibm.java.jdk IDs, are available for the latest Java versions. Because these offerings do not follow the WebSphere® fix pack schedule, you can receive Java security updates faster, as they become available. These offerings are also used by WebSphere Application Server traditional V9.0.

The following table lists the Java SDK offering names and IDs.

Table 1. IBM Java SDK offerings
Java SDK offering name Offering ID
IBM Semeru Runtime Certified Edition, Version 17 com.ibm.java.jdk.v17
IBM Semeru Runtime Certified Edition, Version 11 com.ibm.java.jdk.v11
IBM SDK, Java Technology Edition, Version 8 com.ibm.java.jdk.v8
Note:

The WebSphere Java SDKs, which were denoted by com.ibm.websphere.liberty.IBMJAVA IDs, are no longer available.

Note that these WebSphere Java SDK offerings cannot be used with the versionless Liberty offerings, such as com.ibm.websphere.liberty.BASE, which were introduced in Version 9.0. For these Liberty offerings, you must install the IBM Java SDKs.

The com.ibm.websphere.liberty.IBMJAVA.v80 offering is deprecated and no fix packs or interim fixes will be provided for this offering after March 2020. If this offering is installed with Liberty Version 8.5.5 after March 2020, you must uninstall it and install com.ibm.java.jdk.v8 to continue to receive security updates and fixes.

The Java SDK offerings are installed by using the standard Installation Manager procedures. The architecture of the Java SDK offering is automatically selected based on your operating system.

Procedure

  • Install the Java SDK by using IBM Installation Manager.
    • Install the Java SDK by starting the Installation Manager GUI, clicking Install, and choosing an IBM SDK, Java Technology Edition offering.

      For information about installing by using the GUI, see Installing Liberty on distributed operating systems by using the GUI.

    • Install the Java SDK from the command line by running the imcl install command:
      imcl.exe install com.ibm.java.jdk.v17
        -repositories http://www.ibm.com/software/repositorymanager/com.ibm.java.jdk.v17
        -installationDirectory "C:\Program Files\IBM\WebSphere\Liberty"
        -secureStorageFile C:\IM\credential.store -masterPasswordFile C:\IM\master_password.txt

      For more information about installing from the command line, see Installing Liberty on distributed operating systems using the command line.

    • Install the Java SDK by using a response file:
      <?xml version="1.0" encoding="UTF-8"?>
      <agent-input clean="true" temporary="true">
      <server>
      <repository location="http://www.ibm.com/software/repositorymanager/com.ibm.java.jdk.v17" />
      </server>
      <install modify='false'>
      <offering id='com.ibm.java.jdk.v17'
        profile='WebSphere Application Server Liberty'
        features='com.ibm.sdk.17'/>
      </install>
      <profile id='WebSphere Application Server Liberty' installLocation='C:\Program Files\IBM\WebSphere\Liberty'>
       <data key='eclipseLocation' value='C:\Program Files\IBM\WebSphere\Liberty' /> 
       <data key='cic.selector.arch' value='x86_64' /> 
      </profile>
      </agent-input>

      For more information, see Installing Liberty on distributed operating systems using response files.

  • Update the Java SDK.
    For common IBM Java SDKs, individual fixes are packaged as fix packs that have an updated time stamp. Content in the individual fixes for IBM SDK, Java Technology Edition is cumulative, so the fixes contain the fix pack content for the specified level plus any maintenance prior to the fix. Because individual fixes are packaged as fix packs, no interim fixes are provided, and all updates for the IBM Java SDKs are installed by following the method for installing and uninstalling fix packs described in Installing and uninstalling Liberty fix packs.

    You can install the updates directly from the online service repository, or you can download the update files from IBM Fix Central for a local installation.

  • Uninstall the Java SDK by using IBM Installation Manager.
    • Uninstall the Java SDK by starting the Installation Manager GUI, clicking Uninstall, and selecting the IBM SDK, Java Technology Edition offering to uninstall.

      For more information about uninstalling by using the GUI, see Uninstalling Liberty from distributed operating systems using the GUI.

    • Uninstall the Java SDK from the command line by running the imcl uninstall command:
      imcl.exe uninstall com.ibm.java.jdk.v17
        -installationDirectory "C:\Program Files\IBM\WebSphere\Liberty"

      For more information about using the uninstall command, see Uninstalling Liberty from distributed operating systems using the command line.

    • Uninstall the Java SDK by using a response file:
      <?xml version="1.0" encoding="UTF-8"?>
      <agent-input clean='true' temporary='true'>
      <uninstall modify='false'>
      <offering id='com.ibm.java.jdk.v17' 
        profile='WebSphere Application Server Liberty'/>
      </uninstall>
      <profile id='WebSphere Application Server Liberty' 
        installLocation='C:\Program Files\IBM\WebSphere\Liberty'>
      </profile>
      </agent-input>

      For more information about uninstalling from a response file, see Uninstalling Liberty from distributed operating systems using response files.

What to do next

After you install, update, or uninstall a Java SDK, you can change the Java runtime environment that Liberty uses by setting the JAVA_HOME variable. Set the JAVA_HOME environment variable to the jre directory of the version that you want to use.

For Windows platforms
JAVA_HOME=C:path_to_Liberty\java\17.0
For LINUX platforms
JAVA_HOME=path_to_Liberty/java/17.0