Upgrading Open Liberty or WebSphere Application Server Liberty Base

Upgrading Open Liberty or WebSphere Application Server Liberty Base to the latest supported version. This is an optional step you might want to perform before you upgrade the Dynamic Workload Console and the server components.

Before you begin

On UNIX workstations, ensure you permanently set the ulimit parameter as follows:

data segment process (option -d) = unlimited
file size (option -f) = unlimited
max user processes (option -u) = >260000 up to unlimited
open files (option -n) = >100000 up to unlimited
max memory size (option -m) = unlimited
stack size (option -s) = >33000 up to unlimited

On the master domain manager (distributed systems only), these settings must be applied to:

root
the HCL Workload Automation administrative user

On the Dynamic Workload Console, these settings must be applied to:

root
the Dynamic Workload Console installation user (if this user is different from root)

Ensure that your system meets the operating system requirements. For more information, see the detailed system requirements for the application server.

About this task

You can quickly set up Open Liberty or WebSphere Application Server Liberty Base by extracting a file on all supported platforms.

If you already have WebSphere Application Server Liberty Base installed, you can use it with HCL Workload Automation, otherwise you can use Open Liberty, as described below.

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.

Set up Open Liberty or WebSphere Application Server Liberty Base on all of the following workstations, which comprise a typical environment:

master domain manager (distributed environments only)
backup domain manager (distributed environments only)
two Dynamic Workload Console installations on two separate workstations (distributed and z/OS environments)

If you plan to set up a dynamic domain manager and its backup, these components require a separate application server.

On UNIX workstations, you can set up Open Liberty using a user of your choice. In this case, assign the HCL Workload Automation administrative user read and write access to the Open Liberty directory.

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

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.
Stop the application server by running the stopAppServer command, as explained in Application server - starting and stopping.
Optionally rename the current Open Liberty folder, if you plan to keep it for backup purposes.
Browse to the same folder where the previous version was installed.
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.
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

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.
Stop the application server by running the stopAppServer command, as explained in Application server - starting and stopping.
Optionally rename the current WebSphere Application Server Liberty Base folder, if you plan to keep it for backup purposes.
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.
Start the application server by running the startAppServer command, as explained in Application server - starting and stopping.