[Java programming language only]

Installing Liberty

You install Liberty application-serving environment by using the Installation Manager, or by running a Java™ archive (JAR) file.

About this task

To install the Liberty, you can use IBM® Installation Manager to install WebSphere® Application Server Version 8.5 or higher with WebSphere eXtreme Scale, or you can install the Liberty by running a provided JAR file. If you install the WebSphere Application ServerLiberty using Installation Manager, then you must also install WebSphere eXtreme Scale Version 8.5 or higher using Installation Manager. Likewise, if you install the WebSphere Application ServerLiberty by running a JAR file, then you must also install the WebSphere eXtreme Scale Version 8.5 or higher product image by running a JAR file.

On z/OS® operating systems, the Liberty provides an operations environment. You can work natively with this environment using the MVS™ console. For application development, consider using the Eclipse-based developer tools on a separate distributed system, on Mac OS, or in a Linux® shell on z/OS.

Procedure

  • Install the WebSphere Application Server Liberty:
  • Install WebSphere eXtreme Scale Version 8.5 or higher.
    For more information, see IBM Installation Manager and WebSphere eXtreme Scale product offerings.
  • Migrate your Liberty environment.
    When you migrate from one major release of the Liberty to a higher major release, you must change the feature version numbers in your Liberty server.xml file.

    For example, in the initial version of the Liberty that the product supported, feature version numbers were at the 1.0 level. In WebSphere eXtreme Scale Version 8.6 and higher, feature version numbers are at the 1.1 level.

    Note: When you upgrade to WebSphere Application Server V8.5.5, the Liberty is removed. WebSphere eXtreme Scale supports the removal of the feature. However, if you roll back to WebSphere Application Server V8.5, the Liberty is added again, which causes problems in WebSphere eXtreme Scale.
    [Version 8.6.0.2 and later]Support for WebSphere Application Server Liberty Version 8.5.5 was added in WebSphere eXtreme Scale Version 8.6 Fix Pack 2. To install WebSphere eXtreme Scale Version 8.6 on the Liberty Version 8.5.5, use IBM Installation Manager in one of the following ways:
    • Install WebSphere eXtreme Scale Version 8.6 Fix Pack 2, and then upgrade WebSphere eXtreme Scale to the fix pack that you need.
    • Define repositories to WebSphere eXtreme Scale Version 8.6 and to the WebSphere eXtreme Scale fix pack that you need (Version 8.6 Fix Pack 2 or greater), and install WebSphere eXtreme Scale. When you complete this action, you install and upgrade to the fix pack that you need.