Installing Liberty on z/OS

You can install the Liberty offerings by using IBM® Installation Manager Version 1.8.5 or later. Installation Manager installs offerings from one or more product repositories.

Before you begin

Important: Liberty on z/OS supports Java™ SE 8.

As of version 22.0.0.9, Liberty on z/OS supports Java SE 11.

As of version 23.0.0.12, Liberty on z/OS supports Java SE 17.

When support ends for your Java SE version, you must upgrade to a supported version.

• 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 11 is October 2026, 26.0.0.10.
• The Liberty end of support date for Java SE 17 is October 2027, 27.0.0.10.

For more information, see Removal notices. After support is removed, the Liberty kernel is recompiled and can no longer run with the removed Java version.

1. Create an Installation Manager.
   Perform the following procedures:

   • Obtaining an Installation Manager installation kit for installing Liberty on z/OS
   • Installing Installation Manager on z/OS
2. Access the product repositories.

   Perform the following procedure: Accessing product repositories on z/OS.

3. Optional: Configure an instance of the Liberty Asset Repository Service or a local directory-based repository.
   As part of installing Liberty, you can choose to install assets from the following repositories:

   • The Liberty Repository, a public IBM-hosted repository that is accessible through the internet. For more information, see Liberty Repository.
   • The Liberty Asset Repository Service, an open source service that you can use to create an on-premises repository that is remotely accessible behind the firewall of an enterprise. For more information, see the WASdev/tool.lars project on GitHub.
   • Local directory-based repositories, which you create by using the installUtility download action or by downloading the wlp-featureRepo-<version>.zip file, which contains all applicable features and addons. For more information, see Downloading assets using the installUtility command.

   Access to the Liberty Repository requires internet access. If your system does not have internet access or you want to install customized Liberty assets, set up an instance of the Liberty Asset Repository Service or a local directory-based repository, and then add the repository URL, directory path, or archive path in Installation Manager. For more information about the Liberty repositories, see Installing assets using Installation Manager.

4. Install WebSphere Application Server for z/OS Liberty.

   Perform the following procedure: Installing WebSphere Application Server for z/OS Liberty.