Tivoli Workload Automation, Version 9.2

Procedure

About this task

To modify agents by using the twsinst script, perform the following steps:
On Windows operating systems
  1. Insert the DVD for your operating system. See Installation media.
  2. Log in as administrator on the workstation where you want to upgrade the product.
  3. From the DVD_root/TWS/operating_system directory of the DVD, 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. Insert the installation DVD according to the operating system. See Installation media.
  2. From the DVD_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
Start of changeModify an instanceEnd of change
Start of change 
twsinst -modify -uname user_name
 -password user_password
 Start of change-acceptlicense yes|noEnd of change
 -addjruntime true
 [-inst_dir install_directory]
 [-recovInstReg boolean]
End of change
On UNIX and Linux operating systems
Show command usage and version
./twsinst -u | -v
Start of changeModify an instanceEnd of change
Start of change 
./twsinst -modify -uname user_name
 Start of change-acceptlicense yes|noEnd of change
 -addjruntime true
 [-inst_dir install_directory]
 [-recovInstReg boolean]
End of change
Start of change-acceptlicense yes|noEnd of change
Start of changeStart of changeSpecify whether or not to accept the License Agreement.End of changeEnd of change
-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 Tivoli dynamic workload broker resource command on the server. With the -modify option, the only valid value for this parameter is true.
-inst_dir install_directory
The installation directory for Tivoli Workload Scheduler. The default is the home directory of the user for which Tivoli Workload Scheduler 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 Tivoli Workload Scheduler.
-recovInstReg boolean
Select this option to recover workstations that have corrupt registry files without reinstalling the product. If you specify this option, Tivoli Workload Scheduler 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 Tivoli Workload Scheduler. 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 Tivoli Workload Scheduler 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.