Installation paths

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

IBM Workload Scheduler
IBM® Z Workload Scheduler
IBM Workload Scheduler for Applications
Dynamic Workload Console

Many IBM Workload Scheduler components are installed in what is called an IBM Workload Automation instance.

This section describes the installation paths of the IBM Workload Scheduler components:

TWA_home installation path

Many of the components are installed in an IBM Workload Automation instance. Although this is a notional structure it is represented on the computer where you install IBM 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 IBM Workload Scheduler 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 .

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 IBM Workload Scheduler, 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 IBM Workload Scheduler 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.

IBM Workload Scheduler installation directory

You can install more than one IBM Workload Scheduler 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 IBM Workload Automation, as described above.

The installation directory of IBM Workload Scheduler 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

IBM Workload Scheduler 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/IBM/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%\IBM\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 IBM Workload Scheduler documentation or requested to do so by IBM 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 installed in the following location:

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 IBM Workload Scheduler documentation or requested to do so by IBM 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 IBM 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 IBM Workload Automation instances, see Finding out what has been installed in which IBM Workload Automation instances