Upgrading Open Liberty or WebSphere Application Server Liberty Base

You can optionally upgrade Open Liberty or WebSphere Application Server Liberty Base to the latest supported version.

About this task

This is an optional step you might want to perform before you upgrade the Dynamic Workload Console and the master components. WebSphere Application Server Liberty refers both to WebSphere Application Server Liberty Base and Open Liberty.

If you have installed Open Liberty in your environment and you want to upgrade to the latest version, see Upgrading Open Liberty.

If you have installed WebSphere Application Server Liberty Base in your environment and you want to upgrade to the latest version, see Upgrading WebSphere Application Server Liberty Base.

If you want to move from WebSphere Application Server Liberty Base to Open Liberty, see Moving from WebSphere Application Server Liberty Base to Open Liberty.

What to do next

Depending on the application server you choose, see Upgrading Open Liberty or Upgrading WebSphere Application Server Liberty Base.

Upgrading Open Liberty

About this task

To upgrade Open Liberty, perform the following steps:

Procedure

  1. Find out which version of Open Liberty is required, by checking the required version of the application server in Related Software Report.
  2. Download Open Liberty from Get started with Open Liberty. Download the package named All GA Features.
  3. Stop the application server by running the stopAppServer command, as explained in Application server - starting and stopping.
  4. Optionally rename the current Open Liberty folder, if you plan to keep it for backup purposes.
  5. Browse to the same folder where the previous version was installed.
  6. Perform one of the following actions:
    1. Extract Open Liberty using the root user:
      On Windows operating systems
      unzip <openliberty_download_dir>\openliberty-<version>.zip -d <install_dir>
      On UNIX operating systems
      unzip <openliberty_download_dir>/openliberty-<version>.zip -d <install_dir>
    2. Run the following command to assign permissions:
      chmod 755 -R "wlp_directory"

    OR

    Extract Open Liberty using the user who is going to install the product, as follows:
    su - "wauser"
unzip
    where:
    <openliberty_download_dir>
    The directory where you downloaded Open Liberty.
    install_dir
    The directory where you want to set up Open Liberty.
    Note: Install the new Open Liberty in the exact location of the previous Application Server installation, if any.
  7. Start the application server by running the startAppServer command, as explained in Application server - starting and stopping.

Upgrading WebSphere Application Server Liberty Base

About this task

To upgrade WebSphere Application Server Liberty Base, perform the following steps:

Procedure

  1. Find out which version of WebSphere Application Server Liberty Base is required, by checking the required version of the Application server in Related Software Report.
  2. Download WebSphere Application Server Liberty Base from Recommended updates for WebSphere Application Server Liberty.
  3. Stop the application server by running the stopAppServer command, as explained in Application server - starting and stopping.
  4. Optionally rename the current WebSphere Application Server Liberty Base folder, if you plan to keep it for backup purposes.
  5. Extract WebSphere Application Server Liberty Base to the same folder where the previous version was installed, as follows:
    On Windows operating systems
    java -jar <liberty_download_dir>\wlp-base-all-<version>.jar --acceptLicense <install_dir>
    On UNIX operating systems
    ./java -jar <liberty_download_dir>/wlp-base-all-<version>.jar --acceptLicense <install_dir>
    where:
    <liberty_download_dir>
    The directory where you downloaded WebSphere Application Server Liberty Base.
    <version>
    The number of the version.
    <install_dir>
    The directory where you want to set up WebSphere Application Server Liberty Base.
  6. Start the application server by running the startAppServer command, as explained in Application server - starting and stopping.