Start of changeTivoli Workload Automation, Version 9.2

Procedure

Before you begin

  1. Before you start to install, upgrade, or uninstall, verify that the user that runs the installation process has the following authorization requirements:
    Windows operating system
    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 rights 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
    root access
  2. Ensure that you inserted the DVD for your operating system or that you downloaded the Tivoli Workload Scheduler agent eImage (for details, see the Download Document at http://www-01.ibm.com/support/docview.wss?rs=672&uid=swg24036734).
  3. Ensure that you have enough temporary space before you start the installation 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.

About this task

You can install a fault-tolerant or dynamic agent in a distributed or an end-to-end environment.

To install a Tivoli Workload Scheduler agent, perform the following steps:
On Windows operating systems:
  1. Insert the DVD for your operating system or download the agent eImage. For more information, see Installation media or the Download Document at http://www-01.ibm.com/support/docview.wss?rs=672&uid=swg24036734.
  2. Log in as administrator on the workstation where you want to install the product.
  3. From the DVD_root/TWS/operating_system directory, run twsinst by using the following syntax:
    cscript twsinst -new -uname username -password user_password -acceptlicense yes
    For a description of the syntax parameters and a complete list of them, see Agent installation parameters.
    Note: twsinst for Windows is a Visual Basic Script (VBS) that you can run in CScript and WScript mode.

    The Tivoli Workload Scheduler user is automatically created. The software is installed by default in the Tivoli Workload Scheduler installation directory. The default value is %ProgramFiles%\IBM\TWA.

    If you enabled the Security Warning, a dialog box is displayed during the installation. In this case answer Run to continue.

On UNIX and Linux operating systems:
  1. Insert the DVD for your operating system or download the agent eImage. For more information about eImages, see Installation media or the Download Document at http://www-01.ibm.com/support/docview.wss?rs=672&uid=swg24036734).
  2. Create the Tivoli Workload Scheduler user. The software is installed by default in the user's home directory, referred to as /installation_dir/TWS.
    User:
    TWS_user
    Home:
    /installation_dir/TWS (for example: /home/user1/TWS where user1 is the name of Tivoli Workload Scheduler user.)
  3. Log in as root on the workstation where you want to install the product.
  4. From the DVD_root/TWS/operating_system directory, run twsinst by using the syntax described below. For a description of the syntax parameters, see Agent installation parameters.
If the installation fails, to understand the cause of the error see Analyzing return codes for agent installation, upgrade, restore, and uninstallation.
After a successful installation, perform one of the following configuration tasks, depending on the type of agent you installed:
On Windows operating systems:
Show command usage and version
twsinst -u | -v
Install a new instance
twsinst -new -uname username
   -password user_password
   Start of change-acceptlicense yes|noEnd of change
   [-addjruntime true|false]
   [-agent dynamic|fta|both]
   [-company company_name] 
   [-displayname agentname]
   [-domain user_domain]
   Start of change[-gateway local|remote|none]End of change
   Start of change[-gwid gateway_id]End of change
   [-hostname host_name]
   [-inst_dir install_dir]
   [-jmport port_number]
   [-jmportssl true|false]
   [-lang lang_id]
   [-master master_cpu_name]
   [-password user_password]
   [-port port_number]
   [-skip_usercheck]
   [-stoponcheckprereq]
   [-tdwbhostname host_name]
   [-tdwbport tdwbport_number]
   [-thiscpu workstation]
   [-work_dir working_dir]
On UNIX and Linux operating systems
Show command usage and version
twsinst -u | -v
Install a new instance
twsinst -new -uname username
   Start of change-acceptlicense yes|noEnd of change
   [-addjruntime true|false]
   [-agent dynamic|fta|both]
   [-company company_name]
   [-create_link]
   [-displayname agentname]
   Start of change[-gateway local|remote|none]End of change
   Start of change[-gwid gateway_id]End of change
   [-hostname hostname]
   [-inst_dir install_dir]
   [-jmport port_number]
   [-jmportssl true|false]
   [-lang lang_id]
   [-master master_cpu_name]
   [-port port_number]
   [-reset_perm]
   [-skip_usercheck]
   [-stoponcheckprereq]
   [-tdwbhostname host_name]
   [-tdwbport tdwbport_number]
   [-thiscpu workstation]
   [-work_dir working_dir]


End of change