Procedure

About this task

To modify agents by using the twsinst script, perform the following steps:
On Windows™ operating systems
  1. Download the eImage for your operating system. See Downloading installation images on your workstation.
  2. Log in as administrator on the workstation where you want to upgrade the product.
  3. From the root/TWS/operating_system directory of the eImage, run twsinst by using the synopsis described below.
    Note: twsinst for Windows™ is a Visual Basic Script (VBS) that you can run in CScript and WScript mode, for example:
    cscript twsinst -modify -uname username 
-password user_password -acceptlicense yes
-addjruntime true
On UNIX™ and Linux™ operating systems
  1. Download the eImage according to the operating system. See Downloading installation images on your workstation.
  2. From the root/TWS/operating_system directory, run the twsinst script by using the synopsis described below.
A successful modify by using the twsinst script issues the return code RC = 0. If the operation fails, to understand the cause of the error, see Analyzing return codes for agent installation, upgrade, restore, and uninstallation.
Synopsis:
On Windows™ operating systems:
Show command usage and version
twsinst -u | -v
Modify an instance
twsinst -modify -uname user_name
 -password user_password
 -acceptlicense yes|no
 -addjruntime true
 [-inst_dir install_directory]
 [-recovInstReg boolean]
On UNIX™ and Linux™ operating systems
Show command usage and version
./twsinst -u | -v
Modify an instance
./twsinst -modify -uname user_name
 -acceptlicense yes|no
 -addjruntime true
 [-inst_dir install_directory]
 [-recovInstReg boolean]
-acceptlicense yes|no
Specify whether or not 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. With the -modify option, the only valid value for this parameter is true.

This option is applicable to both fault-tolerant agents and dynamic agents.

-inst_dir install_directory
The installation directory for HCL Workload Automation. The default is the home directory of the user for which HCL Workload Automation is being installed.
-modify
Modifies an existing agent that was installed by using twsinst.
-password user_password
Windows™ operating systems only. The password of the user for which you are upgrading HCL Workload Automation.
-recovInstReg boolean
Select this option to recover workstations that have corrupt registry files without reinstalling the product. If you specify this option, HCL Workload Automation re-creates the installation registries. Valid values are true and false. The default value is false.

You can use this option also to recover registry files in a cluster environment; in this case you can run the command on any node of the cluster and not necessarily on the node where you installed HCL Workload Automation. This is useful when the cluster node where the product is installed is unavailable or in an inconsistent state.

-uname username
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 that performs the upgrade.