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.

JAVA_HOME=C:path_to_Liberty\java\17.0

JAVA_HOME=path_to_Liberty/java/17.0