Installing WebSphere Application Server for z/OS Liberty

The product code for all Liberty offerings is installed by using IBM® Installation Manager.

Before you begin

[17.0.0.3 and 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 8 is the recommended Java SDK because it provides the latest features and security updates. As an alternative to installing Java SE 8, you can install another supported Java SDK version.

Create an Installation Manager on your z/OS® system. You must know the location of the binaries directory for the Installation Manager and have access to a user ID that can invoke the Installation Manager. See Installing Installation Manager on z/OS.

Obtain the product repository for WebSphere Application Server Liberty. See Accessing product repositories on z/OS.

If you want to install Liberty assets from local directory-based repositories or an instance of the Liberty Asset Repository Service, configure the repositories. For more information about the Liberty asset repositories, see Installing assets using Installation Manager.

About this task

The Installation Manager imcl install command is used to install WebSphere Application Server for z/OS Liberty.

Note: This procedure uses several WebSphere Application Server for z/OS sample jobs. These jobs can be found in the BBO.SBBOJCL data set that is installed as part of FMID HBBO900. You can also download the sample jobs by following the instructions in the Sample jobs for WebSphere Application Server Version 9 on z/OS page.

Procedure

  1. Choose an installation location for this copy of Liberty.

    This copy of the product must be mounted at this location every time Installation Manager accesses it to install, uninstall, or modify it. This location does not have to be the same location at which the product will be mounted when used in production. Installation Manager requires that every installed product or group of products have its own installation location.

    The following location is recommended, where level indicates either the service level of the Liberty runtime environment or the purpose for this copy of the product, such as test:

    /InstallationManager/products/WebSphere/Liberty/level

  2. Create and mount a file system for this Liberty installation by editing and submitting sample job BBO2CFS.
  3. Install Liberty by editing and submitting one of the following sample installation jobs.
    • BBO2INS: Install Liberty from the web-based product and service repository.
    • BBO2INSL: Install Liberty from local repositories.
  4. Optional: Install an IBM Java SDK.
    You can run Liberty with any compliant Java runtime environment (JRE) or Java software development kit (SDK). To install IBM SDK, Java Technology Edition, Version 8, edit and submit one of the following sample installation jobs:
    • BBO5INS: Install IBM SDK, Java Technology Edition, Version 8 from the web-based product and service repository.
    • BBO5INSL: Install IBM SDK, Java Technology Edition, Version 8 from local repositories.
  5. When product installation is complete, unmount the product file system and remount it read-only for use by Liberty servers.

    Product installation is complete when the jobs complete without error messages. Logs for the installation can be found in the logs subdirectory of the Installation Manager runtime data location.

    The product documentation and configuration tools assume that the product file system is mounted for use at the /usr/lpp/WebSphere/Liberty location.

What to do next

Create and configure your Liberty server. See Setting up Liberty.

You can install Liberty assets to extend your server functionality. For more information, see Installing Liberty Repository assets.


Icon that indicates the type of topic Task topic

File name: twlp_ins_installation_zos_installing.html