Installing the Liberty profile application-serving environment by running a JAR file

By running the Java archive (JAR) file that contains the distribution image, you install the application-serving environment, and you are ready to create a Liberty server.

About this task

You can install the Liberty profile application-serving environment by running a JAR file as described in this topic, or by using the Installation Manager.

When you run the JAR file for WebSphere® Application Server to install the Liberty profile, you must extract the JAR file first. Then, extract the Liberty profile JAR file for WebSphere eXtreme Scale. If you use IBM Installation Manager to install WebSphere Application Server Version 8.5 and obtain the Liberty profile, then you must use Installation Manager to also install WebSphere eXtreme Scale.

This task supports the following editions:
  • WebSphere Application Server Liberty Core
  • WebSphere Application Server, Base and Developer editions
  • WebSphere Application Server, Network Deployment
  • WebSphere Application Server for z/OS

For download information for the Liberty profile application-serving and data caching environments, see the WASdev community downloads page.

Procedure

  1. Extract the WebSphere Application Server Liberty profile distribution image to your preferred directory.
    This image is packaged as a JAR file; for example, wlp-edition-8.5.0.0.jar . Use one of the following actions to extract this JAR file:
    • To extract the distribution image by using the wizard, run java -jar wlp-edition-8.5.0.0.jar .
    • To extract the distribution image by accepting the license terms and conditions silently, run java -jar wlp-edition-8.5.0.0.jar -acceptLicense .
    • To view all available options, run java -jar wlp-edition-8.5.0.0.jar -help .
    All the application server files are stored in subdirectories of the wlp directory.
  2. Optional: Set the JAVA_HOME property for your environment.

    The Liberty profile requires a JRE in which to run. It does not share the JDK or JRE that the WebSphere Application Server full profile uses. You can specify the JDK or JRE location using the JAVA_HOME property in the server.env file, as described in Customizing the Liberty profile environment. On Linux or UNIX systems, you can instead set JAVA_HOME in the user .bashrc file, or append the JDK or JRE path to the PATH environment variable. On Windows systems, you can instead set JAVA_HOME as a system environment variable, or append the JDK or JRE path to the PATH system variable.

    [Windows] For example, on Windows systems you can use the following commands to set the JAVA_HOME property, and to add the Java™ /bin directory to the path:
    set JAVA_HOME=C:\Progra~1\Java\JDK16
    set PATH=%JAVA_HOME%\bin;%PATH%
    Notes:
  3. Download WebSphere eXtreme Scale for Developers -Liberty profile. Extract the WebSphere eXtreme Scale distribution image to the directory where you extracted the wlp-edition-8.5.0.0.jar file.
    This image is packaged as a JAR file called wxs-wlp_8.5.0.1.jar . To extract the distribution image, run the JAR file; for example, run the following command, depending on your version of eXtreme Scale:
    java -jar wxs-wlp_8.5.0.1.jar -acceptLicense

Results

If you extract the wxs-wlp_8.5.0.1.jar file , eXtreme Scale is installed on top of the WebSphere Application Server Liberty profile when you extract both JAR files to the same directory.