Installing Open Liberty or WebSphere Application Server Liberty Base

Installing Open Liberty or WebSphere Application Server Liberty Base to the latest supported version.

Before you begin

On AIX and Linux 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 install or upgrade 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 install 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.

Install Open Liberty or 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.

On UNIX workstations, you can install 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 installation directory.

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

  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. 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.
  4. 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

  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. 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 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.