Installing from the command-line interface

About this task

Install HCL Workload Automation from the command-line interface based on a typical installation scenario. Variations to the typical scenario are described in the FAQ sections.

Before you get started, download the installation images and verify the prerequisites, as described in sections Downloading installation images and Prerequisites.

Downloading installation images

Steps to take when downloading images on your workstation.

About this task

You can download installation images from Flexnet or from HCL Software.

Procedure

Ensure that your workstation has sufficient space to store the compressed file containing the installation images. For more information about system requirements, see Product Requirements.
From Flexnet or from HCL Software, download the compressed file, containing the latest product image, to a temporary directory.
Extract the installation image from the downloaded file and verify that the installation image is complete.
Extract the content of the ZIP files into a directory, using one of the extraction tools available on your system or that can be downloaded from the internet. The tool you use must be able to keep the file permissions on the extracted files, for example, infozip.
On Windows™ systems, ensure that you extract the image into a path that is not very long, otherwise, the file name might be truncated. The maximum length allowed is 255 characters.
If you are installing on a UNIX™ operating system, run the following command:
```
 chmod -R 755 <imagesDir>  
```
Note: To extract the .zip file onto a Windows™ 64-bit system, ensure that the image is not located on the desktop because the Windows™ operating system extract tool might encounter a problem. Choose another directory into which to extract the product image.

Note: DB2 is available for download from HCL License Portal only. The latest versions of Open Liberty can be downloaded from Get started with Open Liberty. For further details, see the HWA_10.2.3_QuickStartGuide.zip available from Flexnet or from HCL Software.

Prerequisites

When installing HCL Workload Automation components, consider the following prerequisites.

About this task

For a complete list of the correct versions to install, see the System Requirements Document at HCL Workload Automation Detailed System Requirements.

For a complete list of system requirements (disk spaces, temporary spaces and RAM usage), see HCL Workload Automation Detailed System Requirements.

Open Liberty: The latest versions of Open Liberty can be downloaded from Get started with Open Liberty.; 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 in Installing Open Liberty. WebSphere Application Server Liberty Base is no longer distributed from the HCL Software portal and needs to be obtained independently.
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.

Before you install HCL Workload Automation for the first time, you must have one of the following databases installed. The following requirements apply to the RDBMS systems:

DB2

DB2® Enterprise Server Edition

You can install DB2® Server and the master domain manager or Dynamic Workload Console on the same workstation, then configure the database drivers from any workstation in your environment.

If you purchase a new DB2 license, you can typically use your existing DB2 installation without needing to reinstall the software. You simply need to apply the new license certificate to your current DB2 setup using the db2licm command to update your license compliance. For more information, see Applying Db2 licenses. If you have any further questions regarding your license on your account, contact your sales representative.

You can install DB2® manually.

Oracle and Amazon RDS for Oracle

You can install Oracle in the following ways:

Oracle Enterprise Edition: The advantage of choosing Oracle Enterprise Edition is that you can implement the Oracle Partitioning feature to improve the performance of event-driven workload automation. This improves rule management performance, in particular the following queries: event_rule_instance, action_run, and operator_messages. For information about event-driven workload automation, see Running event-driven workload automation.
Oracle Standard Edition: Oracle Standard Edition does not include the Oracle Partitioning feature. Installing this edition does not improve the performance of event-driven workload automation.
Amazon RDS for Oracle: Amazon RDS for Oracle is a robust and convenient option for managing Oracle databases in the cloud. It handles routine database tasks such as provisioning, patching, backup, recovery, and scaling, allowing you to focus on application development.

For supported versions, see the HCL Workload Automation System Requirements Document at HCL Workload Automation Detailed System Requirements.

Note:

When installing the product on a 64-bit library operating system, use an Oracle database on a 64-bit library.
When upgrading:
- If you already have an RDBMS installed and you want to upgrade it, you must upgrade it after you upgrade HCL Workload Automation.
- Use an Oracle database on a 64-bit library when installing the product on a 64-bit library.

For information about upgrading the RDBMS, see Data maintenance.

MSSQL

Before you create the HCL Workload Automation schema on the database, you must have created the directory where the HCL Workload Automation table spaces will be placed when the HCL Workload Automation schema is created. The default is C:\MSSQL.

Azure SQL: A family of managed, secure, and intelligent products that use the SQL Server database engine in the Azure cloud
Google Cloud SQL for SQL server: A fully-managed database service that helps you set up, maintain, manage, and administer your relational databases on Google Cloud Platform.
Amazon RDS for MSSQL: Amazon RDS for MSSQL offers a powerful and user-friendly solution for managing MSSQL databases in the cloud. It takes care of routine tasks like provisioning, patching, backups, recovery, and scaling, so you can concentrate on developing your applications.

PostgreSQL

A powerful, open source object-relational database system, which provides reliability, feature robustness, and performance.

Scanning system prerequisites for HCL Workload Automation

Before installing or upgrading the product, HCL Workload Automation automatically runs a scan on your system.

Before you begin

When installing HCL Workload Automation using the serverinst script, the script first runs the scanner to verify system prerequisites.

Note: To ensure that the prerequisite scan process does not fail, verify that the bc executable is present on the local system and that it is set in the PATH environment variable. If you do not want to install the bc executable, you can skip the prerequisites check by using the skipcheckprereq parameter when running the serverinst and twsinst parameters. For more information about the bc executable, see bc, an arbitrary precision calculator language. For more information about installation commands, see Server components installation - serverinst script and Agent installation parameters - twsinst script.

About this task

Having an environment that meets the product system requirements ensures that an installation or upgrade succeeds without any delays or complications.

The scan verifies that:

The operating system is supported for the product.
On UNIX™ operating systems, the necessary product libraries are installed.
There is enough permanent and temporary disk space to install both the product and its prerequisites.
There is enough memory and virtual memory.

Note: The scan verifies only that the environment meets the requirements of HCL Workload Automation. It does not check the requirements for other components, such as DB2®.

If any of these checks fails, HCL Workload Automation returns an error message.

The log files for the server components are located in:

On Windows™ operating systems:: <TWA_home>\logs\serverinst<version_number>.log
On UNIX™ and Linux™ operating systems:: <TWA_DATA_DIR>/installation/logs/serverinst<version_number>.log

The log files for the Dynamic Workload Console are located in:

On Windows™ operating systems:: <DWC_home>\logs\dwcinst<version_number>.log
On UNIX™ and Linux™ operating systems:: <DWC_DATA_dir>/installation/logs/dwcinst<version_number>.log

The log files for the agents are located in:

On Windows™ operating systems:: <TWA_home>\logs\twsinst<interp><user_name><version_number>.log
On UNIX™ and Linux™ operating systems:: <TWA_DATA_DIR>/installation/logs/twsinst<interp><user_name><version_number>.log

You can decide to rerun the installation or upgrade without executing the prerequisite scan. If you set the -skipcheckprereq parameter to true when performing the installation, the installation script does not execute the prerequisite scan. If a problem occurs, an error is displayed, the component is installed or upgraded, but might not work. For more information about the -skipcheckprereq parameter in all installation scripts, see Reference.