HCL Workload Automation, Version 9.4

Uninstalling agents using the twsinst script

Before you begin

  1. Before starting to uninstall, verify that the user running the uninstallation process has the following authorization requirements:
    Windows operating systems

    If you set the Windows User Account Control (UAC), your login account must be a member of the Windows Administrators group or domain administrators with the right, Act as Part of the Operating System.

    If you set the Windows User Account Control (UAC) on the workstation, you must run the installation as administrator.

    UNIX and Linux operating systems

    To uninstall a fault-tolerant agent, the user must have root access.

    To uninstall a dynamic agent that was installed by the root user, the user must have root access.

    To uninstall a dynamic agent that was installed by a non-root user, the uninstaller must use the same login used to install the agent. To find the login value used at installation, see the read-only InstallationLoginUser parameter in the JobManager.ini configuration file in the agent.

  2. Ensure that you have enough temporary space before starting the uninstallation process. If you have not much space in the temporary directory and you cannot free the space, see twsinst needs long time to run if the machine does not have enough temporary space.
  3. Ensure that all HCL Workload Automation processes and services are stopped, and that there are no active or pending jobs. For information about stopping the processes and services, see Administration Guide.
Follow these steps to uninstall HCL Workload Automation agents using the twsinst script. Depending on the operating system, proceed as follows:
On Windows operating systems:
  1. Ensure that all HCL Workload Automation processes and services are stopped, and that there are no active or pending jobs. For information about stopping the processes and services see Administration Guide.
  2. Log on as administrator on the workstation where you want to uninstall the product.
  3. twsinst for Windows is a Visual Basic Script (VBS) that you can run in CScript and WScript mode, from the installation_dir\TWS, run the twsinst script as follows: 
    cscript twsinst -uninst -uname username [-wait minutes]
[-lang lang_id] 
[-work_dir working_dir]
The uninstallation is performed in the language of the locale and not the language set during the installation phase. If you want to uninstall agents in a language other than the locale of the computer, run the twsinst script from the installation_dir\TWS as follows: 
cscript twsinst -uninst -uname user_name -lang language
where language is the language set during the uninstallation.
On UNIX and Linux operating systems:
  1. Log on as root and change your directory to /installation_dir/TWS
  2. From the TWS directory, run the twsinst script as follows: 
    twsinst -uninst -uname username [-wait minutes]
[-lang lang_id] [-work_dir working_dir]
The uninstallation is performed in the language of the locale and not the language set during the installation phase. If you want to uninstall agents in a language other than the locale of the computer, run the twsinst script from the /installation_dir/TWS as follows: 
./twsinst -uninst -uname user_name -lang language
where language is the language set during the uninstallation.
-uninst
Uninstalls the HCL Workload Automation agent.
-uname username
The name of the user for which the HCL Workload Automation agent is uninstalled. This user name is not to be confused with the user performing the uninstallation logged on as administrator on Windows operating systems and as root on UNIX and Linux operating systems.
-wait minutes
The number of minutes that the product waits for jobs that are running to complete before starting the uninstallation. If the jobs do not complete during this interval, the uninstallation stops and an error message is displayed. Valid values are integers or -1 for the product to wait indefinitely. The default is 60 minutes.
-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: The -lang option is not to be confused with the HCL Workload Automation supported language packs.
-work_dir working_dir
The temporary directory used for the HCL Workload Automation installation process files deployment.
On Windows operating systems:
If you specify a path that contains blanks, enclose it in double quotation marks. If you do not manually specify a path, the path is set to %temp%\TWA\tws<version_number>, 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/tws<version_number>.
The following is an example of a twsinst script that uninstalls the HCL Workload Automation agent, originally installed for user named twsuser:
On Windows operating systems:
cscript twsinst -uninst -uname TWS_user
On UNIX and Linux operating systems:
./twsinst -uninst -uname TWS_user