Where products and components are installed

Describes where the HCL Workload Automation products and components are installed.

This section commences by briefly introducing HCL Workload Automation and explaining how this concept impacts the installed structure of HCL Workload Automation.

HCL Workload Automation

IBM Workload Automation is the name of a family of products and components, which includes the following components:

HCL Workload Automation
HCL Workload Automation for Z
HCL Workload Automation for Applications
Dynamic Workload Console

Many HCL Workload Automation components are installed in what is called a HCL Workload Automation instance.

Installation paths

TWA_home installation path

Many of the components are installed in an HCL Workload Automation instance. Although this is a notional structure it is represented on the computer where you install HCL Workload Automation components by a common directory referred to in the documentation as TWA_home. The path of this directory is determined when you install an HCL Workload Automation component for the first time on a computer. You have the opportunity to choose the path when you make that first-time installation, but if you accept the default path, it is as follows:

On UNIX™ operating systems: /opt/wa/server_<wauser><n>
On Windows™ operating systems: %Program Files%\wa\server<n>

where <n> is an integer value ranging from 0 for the first instance installed, 1 for the second, and so on.

This path is called, in the publications, TWA_home. For details about the directories created outside of TWA_home, see Directories created outside of TWA_home at installation time.

If you install an HCL Workload Automation component, either agent or server, in the C:\ or C:\Program Files\ directories, the twsuser or any user other than the Administrator might encounter issues when running commands from the command-line interface due to security settings. For example, the resource command-line interface might fail to run commands, and the conman command might display error or warning messages. To prevent these issues, open the command prompt with the Run as administrator option to run commands.

TWA_DATA_DIR and DWC_DATA_dir configuration directories

To simplify administration, configuration, and backup and recovery on UNIX systems, a new default behavior has been implemented with regard to the storage of product data and data generated by HCL Workload Automation, such as logs and configuration information. These files are now stored by default in the <data_dir> directory, which you can optionally customize at installation time.

By default, this directory is TWA_home/TWSDATA for the server and agent components, and DWC_home/DWC_DATA for the Dynamic Workload Console. The product binaries are stored instead, in the installation directory.

You can optionally customize the <data_dir> directory at installation time by setting the --data_dir argument when you install using the command-line installation. If you want to maintain the previous behavior, you can set the --data_dir argument to the HCL Workload Automation installation directory.

If you deploy the product components using Docker containers, the <data_dir> is set to the default directory name and location, and it cannot be modified.

To retrieve the TWA_DATA_DIR and DWC_DATA_dir location in case you have modified the default path, check the values for the TWS_datadir and DWC_datadir properties stored in the twainstance<instance_number>.TWA.properties file. The file is located in /etc/TWA.

Alternatively, you can also proceed as follows:

Browse to <TWA_home>/TWS path.
Source the . ./tws_env.sh shell script.
Type echo $UNISONWORK. As a result, the path to the TWA_DATA_DIR is returned.

HCL Workload Automation installation directory

You can install more than one HCL Workload Automation component (master domain manager, backup master domain manager, domain manager, or backup domain manager) on a system, but each is installed in a separate instance of HCL Workload Automation, as described above.

The installation directory of HCL Workload Automation is:

<TWA_home>/TWS

DWC_home installation directory

The Dynamic Workload Console can be installed in the path of your choice, but the default installation directory is as follows:

On Windows™ operating systems: %ProgramFiles%\wa\DWC
On UNIX™ operating systems: /opt/wa/DWC
On z/OS operating system: /opt/wa/DWC

HCL Workload Automation agent installation directory

The agent also uses the same default path structure, but has its own separate installation directory:

<TWA_home>/TWS/ITA/cpa

Note: The agent also installs some files outside this path. If you have to share, map, or copy the agent files (for example when configuring support for clustering) share, map, or copy these files, as well:

On UNIX™ operating systems

/etc/teb/teb_tws_cpa_agent_<tws_user>.ini
/opt/HCL/CAP/EMICPA_default.xml
  /etc/init.d/tebctl-tws_cpa_agent_<tws_user>
   (on Linux)
   /etc/rc.d/init.d/tebctl-tws_cpa_agent_<tws_user>
   (on AIX)

On Windows™ operating systems

%windir%\teb\teb_tws_cpa_agent_<tws_user>.ini
%ALLUSERSPROFILE%\HCL\CAP\EMICPA_default.xml

The agent uses the following configuration files which you might need to modify:

JobManager.ini

This file contains the parameters that tell the agent how to run jobs. You should only change the parameters if advised to do so in the HCL Workload Automation documentation or requested to do so by HCL Software Support. Its path is:

On UNIX™ operating systems: TWA_DATA_DIR/ITA/cpa/config/JobManager.ini
On Windows™ operating systems: TWA_home\TWS\ITA\cpa\config\JobManager.ini

JobManagerGW.ini

When a dynamic agent is installed and -gateway local|remote is specified, then this file contains the same parameters as the JobManager.ini file except for the following differences:

The ResourceAdvisorUrl parameter points to the dynamic workload broker, and not the master domain manager.

The JobManagerGW.ini file is located in the following paths:

On UNIX™ operating systems: TWA_DATA_DIR/ITA/cpa/config/JobManagerGW.ini
On Windows™ operating systems: TWA_home\TWS\ITA\cpa\config\JobManagerGW.ini

ita.ini

This file contains parameters which determine how the agent behaves. Changing these parameters may compromise the agent functionality and require it to be reinstalled. You should only change the parameters if advised to do so in the HCL Workload Automation documentation or requested to do so by HCL Software Support. Its path is:

On UNIX™ operating systems: TWA_DATA_DIR/ITA/cpa/ita/ita.ini
On Windows™ operating systems: TWA_homeTWS\ITA\cpa\config\ita.ini

Installation path for files giving the dynamic scheduling capability

The files that give the dynamic scheduling capability are installed in the following path:

<TWA_home>/TDWB

The command line client installation path

The command line client is installed outside all HCL Workload Automation instances. Its default path is:

TWA_home/TWS/CLI

However, the information above supplies only the default paths. To determine the actual paths of products and components installed in your HCL Workload Automation instances, see Finding out what has been installed in which HCL Workload Automation instances