For distributed platformsFor IBM i platforms[8.5.5.5 or later]
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.

Upgrading Liberty installations

You can upgrade the edition or license of Liberty by using a self-extracting Java™ archive (JAR) file.

Before you begin

To download the upgrade JAR files from IBM® Fix Central or Passport Advantage®, you must be enrolled as a customer.

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, 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

About this task

Liberty offers installation from a ZIP archive file or a self-extracting Java archive (JAR) file as an alternative to using IBM Installation Manager. If you installed Liberty using one of these archive files, you can upgrade the product license by applying an executable JAR file, available from IBM Fix Central or the Passport Advantage website.

You might upgrade Liberty in the following example scenarios:
  • Upgrade a trial edition or other unsupported edition to a supported production edition.
  • Upgrade a basic edition to a more advanced edition for access to advanced features.
You can upgrade WebSphere® Application Server Liberty offerings in the following paths:
Table 1. Liberty offering upgrade paths
License JAR file Source edition Target edition
wlp-core-license.jar Unsupported ZIP or JAR file installations WebSphere Application Server Liberty Core
WebSphere Application Server Liberty Core Trial
wlp-base-license.jar Unsupported ZIP or JAR file installations WebSphere Application Server Liberty
WebSphere Application Server Liberty Trial
WebSphere Application Server Liberty Core
WebSphere Application Server Liberty for Developers
WebSphere Application Server Liberty - Express®
wlp-nd-license.jar Unsupported ZIP or JAR file installations WebSphere Application Server Liberty Network Deployment
WebSphere Application Server Liberty Network Deployment Trial
WebSphere Application Server Liberty Core
WebSphere Application Server Liberty for Developers
WebSphere Application Server Liberty - Express
WebSphere Application Server Liberty

For example, an installation of WebSphere Application Server Liberty Core also requires features from WebSphere Application Server Network Deployment. If you have the required entitlement, you can download the wlp-nd-license.jar license file and apply it to your Liberty installation, which upgrades the license from WebSphere Application Server Liberty Core to WebSphere Application Server Network Deployment. Upgrading the license does not install any features from WebSphere Application Server Network Deployment, but it enables you to install WebSphere Application Server Network Deployment features to your Liberty installation if needed.

Procedure

  1. Download the license upgrade archive for the edition that you want to upgrade to from IBM Fix Central or the IBM Passport Advantage website. You can apply the license JAR files to all fix packs of Liberty ZIP or JAR file installations.

    For a list of the JAR files on IBM Fix Central, see license JAR files on the Fix Central website.

    For a list of Passport Advantage part numbers, see How to download WebSphere Application Server Liberty Core V8.5.5 from Passport Advantage Online.

  2. Apply the license archive to an existing Liberty installation. For example, to apply the license by using the installation wizard and the wlp-nd-license.jar file, run the following command:
    java -jar wlp-nd-license.jar

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_ins_upgrade_archive
File name: twlp_ins_upgrade_archive.html