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: Support for using Java SE 7 with WebSphere® Liberty ended in September 2019. The Liberty kernel was recompiled for 19.0.0.9. Beginning with 19.0.0.9, the Liberty kernel no longer runs with Java SE 7. If Java SE 7 is installed with Liberty version 19.0.0.8 or before, you must uninstall it and install the com.ibm.java.jdk.v8 offering to apply an update to Liberty version 19.0.0.9 or later.
Important: Support for using Java SE 6 with WebSphere Liberty ended in September 2017. The Liberty kernel was recompiled for 17.0.0.3. Beginning with 17.0.0.3, the Liberty kernel no longer runs with Java SE 6. If you continue to use Java SE 6 on earlier releases after the end of support date, you might expose your environment to security risks.

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 Supported Java Releases table on the Open Liberty website.

New: Installation Manager now supports two types of Java SDK offerings:
  • 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.
  • WebSphere Java SDKs: These offerings, which are denoted by com.ibm.websphere.liberty.IBMJAVA IDs, are available for older Java versions. Updates to these offerings are delivered according to the WebSphere fix pack schedule.

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 11 com.ibm.java.jdk.v11
IBM SDK, Java Technology Edition, Version 8 com.ibm.java.jdk.v8
IBM SDK, Java Technology Edition, Version 7 Release 1 com.ibm.java.jdk.v71
IBM WebSphere SDK, Java Technology Edition, Version 7 com.ibm.websphere.liberty.IBMJAVA.v70
IBM WebSphere SDK, Java Technology Edition, Version 6 com.ibm.websphere.liberty.IBMJAVA.v60
Note: Liberty Version 8.5.5 supported the com.ibm.websphere.liberty.IBMJAVA.v80 and com.ibm.websphere.liberty.IBMJAVA.v71 offerings. Although you can continue to install these offerings, consider installing the common Java SDK instead for both new and existing installations. Note that these WebSphere Java SDK offerings cannot be used with the versionless Liberty offerings, such as com.ibm.websphere.liberty.ND, 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.

Important:

Beginning with 17.0.0.3, Liberty does not support IBM WebSphere SDK, Java Technology Edition, Version 6 offering. You cannot install the com.ibm.websphere.liberty.IBMJAVA.v60 offering on Liberty beginning with 17.0.0.3.

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.v8
        -repositories http://www.ibm.com/software/repositorymanager/com.ibm.java.jdk.v8
        -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.v8" />
      </server>
      <install modify='false'>
      <offering id='com.ibm.java.jdk.v8'
        profile='WebSphere Application Server Liberty'
        features='com.ibm.sdk.8'/>
      </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.
    Important: The type of Java SDK that you choose impacts how updates are delivered.

    For both the IBM Java SDKs and the WebSphere Java SDKs, fix packs contain bundled service that brings the Java SDK installation up to a new level, such as 8.0.3.10. However, the packaging and installation of individual fixes differs:

    • 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.
    • WebSphere Java SDKs: Similar to Liberty and other WebSphere product offerings, individual fixes are packaged as interim fixes, which are applied differently from fix packs. For information about installing interim fixes, see Installing and uninstalling Liberty interim fixes. To install fix packs, see 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.v8
        -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.v8' 
        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 Java version that you want to use.For Windows platforms
JAVA_HOME=C:\IBM\WebSphere\Liberty\java\java_1.8_64\jre