Agent upgrade parameters on IBM i systems

About this task

The parameters set when using the twsinst script to upgrade a dynamic agent on IBM i systems.

-acceptlicense yes|no
Specify whether to accept the License Agreement.
-addjruntime true
Adds the Java run time to run job types with advanced options to the agent. The run time environment is used to run application job plug-ins on the agent and to enable the capability to run remotely, from the agent, the dynamic workload broker resource command on the server.

By default, if the Java run time was already installed on the agent, it will be upgraded to the new version.

If the Java run time was not installed on the agent, it will not be installed during the upgrade, unless you specify -addjruntime true.

If you decide not to install Java run time when upgrading, you can still add this feature at a later time as it is described in Adding a feature.

-create_link
Create the symlink between /usr/bin/at and <install_dir>/TWS/bin/at. See Symbolic link options for more information.
-displayname
The name to assign to the agent. The default is the host name of this computer.
-inst_dir installation_dir
The directory of the HCL Workload Automation installation.
Note: The path cannot contain blanks. If you do not manually specify a path, the path is set to the default home directory, that is, the user_ home\user_name directory.
-jmport port_number

The JobManager port number used by the dynamic workload broker to connect to the HCL Workload Automation dynamic agent. The default value is 31114. The valid range is from 1 to 65535.

-jmportssl true|false
The JobManager port used by the dynamic workload broker to connect to the HCL Workload Automation dynamic agent. This number is registered in the ita.ini file located in the ITA/cpa/ita directory.
For communication using SSL or HTTPS
Set jmportssl = true. To communicate with the dynamic workload broker, it is recommended that you set the value to true. If the value is set to true, the port specified in jmport communicates in HTTPS.
For communication without using SSL, or through HTTP
Set jmportssl = false. If the value is set to false, the port specified in jmport communicates in HTTP.
-lang lang_id
The language in which the twsinst messages are displayed. If not specified, the system LANG is used. If the related catalog is missing, the default C language catalog is used.
Note: This is the language in which the installation log is recorded, and not the language of the installed engine instance. The twsinst script installs all languages by default.
-recovInstReg true
To re-create the registry files. Specify it if you have tried to upgrade a stand-alone agent and you received an error message that states that an instance of HCL Workload Automation cannot be found, this can be caused by a corrupt registry file. See Upgrading when there are corrupt registry files.
-skip_usercheck
Enable this option if the authentication process within your organization is not standard, thereby disabling the default authentication option. If you specify this parameter, you must create the user manually before running the script.
-skipcheckprereq
If you specify this parameter, HCL Workload Automation does not scan system prerequisites before upgrading the agent.

For a detailed list of supported operating systems and product prerequisites, see HCL Workload Automation Detailed System Requirements.

-tdwbhostname host_name
The dynamic workload broker fully qualified host name. It is used together with the -tdwbport tdwbport_number parameter. It adds and starts the capabilities to run workload dynamically to HCL Workload Automation. If not specified you cannot run your workload dynamically and this parameter assumes the localhost default value. This value is registered in the ResourceAdvisorUrl property in the JobManager.ini file.
-tdwbport tdwbport_number
The dynamic workload broker HTTP or HTTPS port number used to add dynamic scheduling capabilities to your distributed or end-to-end environment. It is used together with the -tdwbhostname host_name parameter. This number is registered in the ResourceAdvisorUrl property in the JobManager.ini file. The default value is 0, however, if you leave the value as 0, you cannot run your workload dynamically. Specify a nonzero value to add dynamic capability. The valid range is 0 to 65535.
-uname user_name
The name of the user for which HCL Workload Automation is being updated. The software is updated in this userʼs home directory. This user name is not to be confused with the user performing the upgrade.
Note: This user name is not the same as the user performing the installation logged on as QSECOFR.
-update
Upgrades an existing agent that was installed using twsinst.
-wait minutes
The number of minutes that the product waits for jobs that are running to complete before starting the upgrade. If the jobs do not complete during this interval the upgrade does not proceed and an error message is displayed. Valid values are integers or -1 for the product to wait indefinitely. The default is 60 minutes.
-work_dir working_dir
The temporary directory used for the HCL Workload Automation installation process files deployment. The path cannot contain blanks. If you do not manually specify a path, the path is set to /tmp/TWA/tws95.