Installing or upgrading the HCL Workload Automation for Z agent automatically
You can automatically install or upgrade an HCL Workload Automation for Z agent
(z-centric) or an agent with dynamic capabilities by customizing and
running the following applications provided with the product. The
applications are provided in both batch loader and Workload Automation Programming Language formats.
IWSZZCENINSTALL
- To upgrade an HCL Workload Automation for Z agent.
Run this application on a workstation where an HCL Workload Automation for Z agent
instance exists, to automatically upgrade it.
Use the EQQZCEBL sample to import the batch loader format or the EQQZCEWA sample to import the Workload Automation Programming Language format.
IWSZZREMINSTALL
- To install an HCL Workload Automation for Z agent
by running a Remote Command job defined on the Dynamic Workload Console.
Run this application on a workstation where an HCL Workload Automation for Z agent
instance exists, to automatically install as many HCL Workload Automation for Z agents
on as many workstations as you want.
Use the EQQZREBL sample to import the batch loader format or the EQQZREWA sample to import the Workload Automation Programming Language format.
IWSZZDYNINSTALL
- To upgrade a dynamic agent. Run this application on a workstation
where a dynamic agent instance exists, to automatically upgrade it.
Use the EQQZDYBL sample to import the batch loader format or the EQQZDYWA sample to import the Workload Automation Programming Language format.
Before importing the
IWSZZCENINSTALL
, IWSZZREMINSTALL
,
or IWSZZDYNINSTALL
application to the AD database,
complete the following customization steps:- The applications apply to the Linux operating system. To use them in a Windows environment, modify the paths and commands within each sample job as required.
- The workstation names associated with the operations within the
samples are
A130
andZ130
. Ensure that you either create these workstations in your environment or modify the samples with your actual workstation names, as follows:A130
- The agent running the command (driving agent).
Z130
- The agent that is to be installed (target agent).
- All the jobs that are run by the
IWSZZCENINSTALL
orIWSZZDYNINSTALL
application are defined in the EQQZCJCL sample. Create the corresponding jobs in the controller JOBLIB and customize them according to your environment, as follows:/opt/IBM/TWA_twszc
- Installation path of the target agent.
Buildzcen
- Directory of the target agent where the agent will be installed.
/mnt/build
- Source directory on the target agent from which the new agent code will be copied.
- -uname
twszc
- Name of the user for which the HCL Workload Automation for Z agent is installed.
- /JDBC_drivers
- Installation path of the JDBC drivers on the target agent.
TheIWSZZCENINSTALL
,IWSZZREMINSTALL
, andIWSZZDYNINSTALL
applications comprise the following jobs, connected by internal dependencies:- Operation 001, workstation A130, job name JOBSTOP
- Stops the target agent.
- Operation 002, workstation A130, job name JOBUNINS
- Uninstalls the target agent by running the
twsinst
command. - Operation 003, workstation A130, job name JOBDLBLD
- Deletes the source directory containing the old compressed file for the target agent.
- Operation 004, workstation A130, job name JOBDLINS
- Deletes the target agent installation path.
- Operation 005, workstation A130, job name JOBCOPY
- Copies the compressed file to install the agent from the driving agent to the target agent installation path.
- Operation 006, workstation A130, job name JOBUNTAR
- Runs the uncompress command of the agent code.
- Operation 007, workstation A130, job name JOBINSZC (in
IWSZZCENINSTALL
) or JOBINSDY (inIWSZZDYNINSTALL
) - Installs the target agent by running the
twsinst
command. - Operation 008, workstation A130, job name JOBJDBC (automatic)
- Copies the JDBC drivers to the target agent.
- Operation 009, workstation WAIT
- This operation waits for a few minutes, to ensure that the target agent is started.
- Operation 010, workstation Z130, job name
- Runs a sample job on the target agent to verify that the installation was successful.
Choose which application you want to run and use the appropriate sample to load it into your AD database.