Upgrading WebSphere Application Server Liberty

You can optionally upgrade WebSphere Application Server Liberty 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.

Upgrading Open Liberty

About this task

Perform the following steps to upgrade Open Liberty to the latest supported version on the workstations hosting the Dynamic Workload Console and the server components (dynamic domain manager and its backups, master domain manager and its backups).

Procedure

Download Open Liberty from Get started with Open Liberty.

Check the required version of the Application server in the Supported Software document available in Product Requirements. Download the package named All GA Features for the required version.
Stop the application server as described in Application server - starting and stopping.
Also stop HCL Workload Automation and all other applications running on the Open Liberty instance.
Optionally create a backup of the current Open Liberty instance in a directory different from the Open Liberty installation directory.
Uninstall Open Liberty.
Extract all data from the .zip folder:
On Windows operating systems
```
unzip <openliberty_download_dir>\openliberty-<version>.zip -d <install_dir>
--acceptLicense 
```
On UNIX operating systems
```
unzip <openliberty_download_dir>/openliberty-<version>.zip -d <install_dir>
--acceptLicense 
```
where:

<openliberty_download_dir>

The directory where you downloaded Open Liberty.

install_dir

The directory where you want to upgrade Open Liberty.
Note: Install the new Open Liberty in the exact location of the previous Open Liberty installation.
Assign reading, writing, and processing permissions to libraries that are contained in the folder:
```
chmod -R 755 /open_liberty_installation_directory/wlp/lib/versions/
```
where:

open_liberty_installation_directory

The directory where you installed Open Liberty.
Restart the application server as described in Application server - starting and stopping.
Also restart HCL Workload Automation and all other applications running on the Open Liberty instance.

Upgrading WebSphere Application Server Liberty Base

About this task

Perform the following steps to upgrade WebSphere Application Server Liberty Base to the latest supported version on the workstations hosting the Dynamic Workload Console and the server components (dynamic domain manager and its backups, master domain manager and its backups).

Procedure

Download WebSphere Application Server Liberty Base from .
Each WebSphere Application Server Liberty Base image is packaged as a .jar file named wlp-base-all-fix_pack.jar.

Check the release notes to ensure the latest WebSphere Application Server Liberty Base version is supported by HCL Workload Automation. You can find the Release Notes at HCL Workload Automation Release Notes.
Stop the application server as described in Application server - starting and stopping.
Also stop HCL Workload Automation and all other applications running on the WebSphere Application Server Liberty Base instance.
Optionally create a backup of the current WebSphere Application Server Liberty Base instance in a directory different from the WebSphere Application Server Liberty Base installation directory.
Uninstall WebSphere Application Server Liberty Base.
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-fix_pack.jar 
--acceptLicense install_dir
```
On UNIX operating systems
```
java -jar liberty_download_dir/wlp-base-all-fix_pack.jar 
--acceptLicense install_dir
```
where:

liberty_download_dir

The directory where you downloaded WebSphere Application Server Liberty Base.

install_dir

The directory where you want to upgrade WebSphere Application Server Liberty Base.
Note: Install the new WebSphere Application Server Liberty Base in the exact location of the previous WebSphere Application Server Liberty Base installation.
Restart the application server as described in Application server - starting and stopping.
Also restart HCL Workload Automation and all other applications running on the WebSphere Application Server Liberty Base instance.

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.