For distributed platformsFor IBM i platforms
This topic applies to WebSphere Application Server Liberty V8.5.5.9 and earlier. For the latest Liberty topics, see the WebSphere Application Server Liberty documentation.

Installing Liberty by extracting a Java archive file

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

Before you begin

Your system must meet the operating system and Java™ requirements for using Liberty. See System Requirements for WebSphere Application Server V8.5.5.

For IBM i platformsFor the IBM® i platform, this topic assumes that the minimum supported Java level is installed at one of the following locations:
  • /QOpenSys/QIBM/ProdData/JavaVM/jdk626/32bit
  • /QOpenSys/QIBM/ProdData/JavaVM/jdk626/64bit

Procedure

  1. Get a copy of the distribution image JAR file.
    • [8.5.5.8 or later]You can download a single, edition-specific archive file that contains the Liberty runtime environment with all applicable features from IBM Fix Central.

      These JAR files are called wlp-edition-all-version.jar, such as wlp-core-all-8.5.5.8.jarwlp-nd-all-8.5.5.8.jar.

    • You can download separately packaged archive files that contain the Liberty runtime with the Version 8.5.5.2 feature set.

      The edition-specific runtime JAR files are called wlp-edition-runtime-version.jar.

      • Download the archive file for the no-charge, unsupported edition from the WASdev download page. If you install from this JAR file, you can upgrade later to a supported edition.
      • Download the archive file for the initial release, which includes IBM support, from Passport Advantage® online. The associated fix packs are available from Fix Central.

    For a list of all available archives, see List of installation Java archive files.

  2. Extract the distribution images to your preferred directory.

    To extract the distribution image by using the interactive install wizard, run java -jar wlp-archive-name.jar. All application server files are stored in subdirectories of the wlp directory.

    For a list of the available extraction options, see Java archive file extraction options.

  3. Optional: Set the JAVA_HOME property for your environment.

    Liberty runs in a Java Runtime Environment (JRE). It does not share the JDK or JRE that WebSphere® Application Server traditional 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 environment. When you set the JAVA_HOME property in the server.env file, Liberty uses the same Java runtime location regardless of the user profile that Liberty server runs under.

    For IBM i platformsOn the IBM i platform, setting the JAVA_HOME property as a system-level environment variable is not recommended. The IBM i platform is a shared environment, and changing system-level environment variables might affect other applications.

    For distributed platformsOn 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. 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%
    [8.5.5.11 or later]Note: Support for using Java SE 6 with WebSphere Liberty ends in September 2017. After the end of support, the Liberty kernel will be recompiled and can no longer run with Java SE 6. If you continue to use Java SE 6 on earlier fix packs after the end of support date, you could expose your environment to security risks.

    Java SE 8 is the recommended Java SDK because it provides the latest features and security updates. You can install it by installing the IBM SDK, Java Technology Edition, Version 8 package to the package group that contains WebSphere Liberty.

    Note: The Liberty runtime environment searches for the java command in this order: JAVA_HOME property, JRE_HOME property, and system PATH property.

    For more information about supported Java environments, and where to get them, see Minimum supported Java levels.

  4. Optional: Upgrade your Liberty installation to a more advanced supported edition. For example, you can upgrade from WebSphere Application Server Liberty Core to WebSphere Application Server Network Deployment. For more information, see Upgrading Liberty installations.

What to do next

After you install Liberty, you can further customize your environment by installing additional assets; see Installing Liberty Repository assets.

For IBM i platformsOn the IBM i platform, after you extract the distribution image, you can configure all servers to run as jobs in the batch subsystem under the QEJBSVR user profile that is provided with the product. For more information, see Configuring the Liberty server to start as a job in the QWAS85 subsystem on IBM i.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: Tuesday, 12 December 2017
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_inst_kernel
File name: twlp_inst_kernel.html