Upgrading process

According to your operating system, to upgrade the HCL Workload Automation Agent with twsinst perform the following steps:

Windows™ operating systems

Insert the DVD related to your operating system.
Log in as administrator on the workstation where you want to upgrade the agent.
From the DVD_root/TWS/operating_system directory of the DVD, run the twsinst script using the synopsis described in this section.
Note: twsinst for Windows™ is a Visual Basic Script (VBS) that you can run in CScript and WScript mode, for example:
```
cscript twsinst -update -uname username 
 -acceptlicense yes
```

UNIX™ and Linux™ operating systems

Insert the installation DVD related to your operating system.
From DVD_root/TWS/operating_system, run the twsinst script using the synopsis described in this section.

A successful upgrade using the twsinst script issues the return code RC = 0. If the installation 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

Upgrade an instance

twsinst -update -uname user_name
  [-addjruntime true]
  [-domain user_domain]
  [-inst_dir install_directory]
  [-lang lang_id]

  [-recovInstReg true]
  [-skip_usercheck]
  [-wait minutes]
  [-work_dir working_directory]

UNIX™ and Linux™ operating systems:

Show command usage and version

twsinst -u | -v

Upgrade an instance

twsinst -update -uname user_name
 [-addjruntime true]
 [-inst_dir install_directory]
 [-lang lang-id]

 [-recovInstReg true]
 [-reset_perm]
 [-skip_usercheck]
 [-wait minutes]
 [-work_dir working_directory]

-addjruntime true

Adds the Java™ run time to run job types with advanced options, both those supplied with the product and the additional types implemented through the custom plug-ins. With the -update option, the only valid value for this parameter is true.

If you decided 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.

-recovInstReg true

To re-create the registry files. Specify it if you have tried to upgrade a stand-alone, fault-tolerant agent (an agent that is not shared with other components or does not have the connector feature) 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 in HCL Workload Automation: Planning and Installation.

-reset_perm

UNIX™ and Linux™ only. Reset the permissions of the libatrc library.

-skip_usercheck

Enable this option if the authentication process within your organization is not standard, thereby disabling the default authentication option. On UNIX™ and Linux™ operating systems if you specify this parameter, the program skips the check of the user in the /etc/passwd file or the check you perform using the su command. On Windows™ operating systems if you specify this parameter, the program does not create the user you specified in the -uname username parameter. If you specify this parameter you must create the user manually before running the script.

-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_directory

The temporary directory used by the installation process to store the files to deploy.

On Windows™ operating systems:: If you specify a path that contains blanks, enclose it in a double quotation marks. If you do not manually specify a path, the path is set to %temp%\TWA\tws93, where %temp% is the temporary directory of the operating system.
On UNIX™ and Linux™ operating systems:: The path cannot contain blanks. If you do not manually specify a path, the path is set to /tmp/TWA/tws93.