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 Installing Open Liberty.

If you have installed WebSphere Application Server Liberty Base in your environment and you want to upgrade to the latest version, see Installing 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 Installing Open Liberty or Installing WebSphere Application Server Liberty Base.

Installing Open Liberty

About this task

To install Open Liberty, perform the following steps:

Procedure

Find out which version of Open Liberty is required, by checking the required version of the Application server in Related Software Report.
Download Open Liberty from Get started with Open Liberty. Download the package named All GA Features.
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 install Open Liberty.
Note: Install the new Open Liberty in the exact location of the previous WebSphere Application Server Liberty Base installation, if any.
Ensure the HCL Workload Automation administrative user has the rights to run Open Liberty and full access to the installation directory. If Open Liberty is shared between the master domain manager and the Dynamic Workload Console, ensure also the Dynamic Workload Console user has the same rights.

Installing WebSphere Application Server Liberty Base

About this task

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

Procedure

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.
Download WebSphere Application Server Liberty Base from Recommended updates for WebSphere Application Server Liberty.
Install WebSphere Application Server Liberty Base by extracting the archive file to a directory of your choice.
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 install WebSphere Application Server Liberty Base.
Note: Note that the value of the <install_dir> parameter must match the value to be defined for the wlpdir parameter when installing the master domain manager and its backup, dynamic domain manager and its backup, and the Dynamic Workload Console.
Ensure the HCL Workload Automation administrative user has the rights to run WebSphere Application Server Liberty Base and full access to the installation directory. If WebSphere Application Server Liberty Base is shared between the master domain manager and the Dynamic Workload Console, ensure also the Dynamic Workload Console user has the same rights.

What to do next

You have now successfully upgraded WebSphere Application Server Liberty and can proceed to Performing a direct upgrade of the Dynamic Workload Console and its database, to Performing a direct upgrade of the backup master domain manager and its database, or to Performing a direct upgrade of the master domain manager.