Tivoli Workload Automation, Version 9.1

Installing agents on IBM i systems

About this task

You install the Tivoli Workload Scheduler agent on an IBM i system by using the twsinst installation script.

To install an agent, perform the following steps:
  1. Sign on as QSECOFR user.
  2. Create an IBM i user profile for which the Tivoli Workload Scheduler agent is installed.
    Note: The user profile is not the same as that for the user performing the installation logged on as QSECOFR, but instead is for the user that you specify in the -uname username parameter when running the twsinst script. For descriptions of the syntax parameters, see Agent installation parameters on IBM i systems. You cannot use an existing IBM i system user profile, an application supplied user profile, or any of the following reserved IBM i user profiles:
    • QDBSHR
    • QDFTOWN
    • QDOC
    • QLPAUTO
    • QLPINSTALL
    • QRJE
    • QSECOFR
    • QSPL
    • QSYS
    • QTSTRQS
    Attention:
    Be aware of the following consideration:
    • If the user profile is a member of a group, the installation fails. Set the group profile that is associated with the user profile to *NONE.
    • If the username is longer than 8 characters, after the installation the agent (and the JobManager component) runs under the QSECOFR user instead of under the authority of the installation user. To prevent this problem, set the PASE_USRGRP_LIMITED environment variable to N.
  3. On the IBM i system, verify that no library exists with the same name as the user profile supplied for the agent user.
  4. Insert the DVD for the IBM i system or download the agent eImage from the Passport Advantage® Online website. For more information about the installation media, see Installation media or the Download Document at http://www-01.ibm.com/support/docview.wss?rs=672&uid=swg24034807.
  5. If you downloaded the eImages, to untar the package, use the PASE shell or the AIXterm command.
    Using PASE shell:
    1. Open the PASE shell.
    2. Run the command "CALL QP2TERM".
    3. Locate the folder where you downloaded the eImages and run the command: 
      "tar xvf TWS91_IBM_I.tar"
    4. Exit from the PASE shell.
    Using AIXterm command:
    1. Start the Xserver on your desktop.
    2. On the iSeries machine, open a QSH shell and export the display.
    3. In QSH shell, go to the directory /QopenSys and run the command "aixterm -sb".
    4. A pop-up window is displayed on your desktop. By Using this pop-up window, extract the file TWS91_IBM_I.tar.

  6. Open a QSH shell and run the twsinst script. During the installation process, the product creates an IBM i library and a job description with the same name as the user profile created in Step 2.

    The installation procedure adds this library to the user profile library list of the dynamic agent user profile and sets this job description as the job description of the dynamic agent user profile. By default, the software is installed in the user's home directory.
    Note: If you do not run the twsinst script from a QSH shell the installation fails.
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 the following configuration task:
Command usage and version
Show command usage and version
twsinst -u | -v
Install a new instance
twsinst -new -uname username
   [-addjruntime true|false]
   [-agent dynamic]
   [-company company_name]
   [-displayname agentname]
   [-hostname hostname]
   [-inst_dir install_dir]
   [-jmport port_number]
   [-jmportssl true|false]
   [-lang lang_id]
   [-tdwbport tdwbport_number]
   [-tdwbhostname host_name]
   [-work_dir working_dir]

For a description of the installation parameters and options that are related to agent on this operating system, see Agent installation parameters on IBM i systems.

Parent topic: Tivoli Workload Scheduler for z/OS Agent on IBM i systems