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.