Upgrading WebSphere Application Server Liberty Base

Upgrading 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 IBM® Workload Scheduler 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 and Java requirements. For more information, see the detailed system requirements for the application server.

About this task

You can quickly install or upgrade WebSphere Application Server Liberty Base by extracting a file on all supported platforms.

Install WebSphere Application Server Liberty Base on all of the following workstations, which comprise a typical installation:
  • 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 install a dynamic domain manager and its backup, these components require a separate application server.

To extract the archive, you can use your own Java Ext or use the Java Ext provided with the IBM® Workload Scheduler image. The provided Java Ext is located in the following path in the image for your operating system: <IMAGE_DIR>/TWS/<INTERP>/Tivoli_Eclipse_<INTERP>/TWS/JavaExt/.

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 running the Detailed System Requirements report and browsing to the Prerequisites tab.
  2. Download WebSphere Application Server Liberty Base from Recommended updates for WebSphere Application Server Liberty.
  3. 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.
  4. Ensure the IBM® Workload Scheduler 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 can now proceed to Encrypting passwords (optional) or to Upgrading the Dynamic Workload Console and its database.