May the source be with you, but remember the KISS principle ;-)
Home Switchboard Unix Administration Red Hat TCP/IP Networks Neoliberalism Toxic Managers
(slightly skeptical) Educational society promoting "Back to basics" movement against IT overcomplexity and  bastardization of classic Unix

TWS agents

News Job schedulers Recommended Links Documentation   Reference
silent installation twsinst script Using TCM software packages      
Troubleshooting  Redbook Maintaining Your Tivoli Environment Useful framework commands TEC Humor Etc

Before you perform an upgrade on an agent workstation, ensure that all Tivoli Workload Scheduler processes and services are stopped. If you have jobs that are currently running, you must manually stop the related processes.

You can install/upgrade Tivoli Workload Scheduler agents using four different methods:

  1. Using the installation wizard. In this method you start the installation program similar to the way you start a new installation. After selecting the installation language and accepting the license agreement, you select an existing installation of a previous release of the product from the drop-down list and perform the installation or upgrade.
  2. Using a silent installationAlternatively you can use the silent installation. To upgrade an agent using a silent installation, you must use the following response file templates provided on the CDs in the \RESPONSEFILES\ directory:

    You can customize the response file based on your environment:

    For a UNIX or Linux agent upgrade, use the following syntax:

    ./SETUP.bin -options <local_dir>/response_file.txt -silent
  3. Using the twsinst scriptIf you use the twsinst method, the command syntax for an upgrade is the following:
    twsinst -update -uname username 
    	[-inst_dir install_dir]]
    	[-backup_dir backup_dir] 
    	[-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.

  4. Using TCM software packages. You can also use IBM Tivoli Configuration Manager or IBM Tivoli Provisioning Manager to upgrade your agents. The software package block uses a number of Tivoli Workload Scheduler parameters to perform the upgrade. You can assign values to each variable to reflect the installation that is being upgraded; otherwise, the default value is assigned.

Silent installation

Silent installation using an automatically generated response file

During the initial installation of the current version of Tivoli Workload Scheduler, you can create a response file based on the parameters of the initial installation. You use this response file to run subsequent installations with the same parameters. Creating an automatically generated response file is recommended because all input is automatically validated by the program.

To perform a silent installation using an automatically generated response file, perform the following steps:

Perform the initial installation using the following command:


SETUP.exe -options-record <local_dir>\response_file.txt 

where response_file.txt is the name of the response file to be created. The SETUP.exe file is located in the WINDOWS directory. See Installation media.

UNIX® and Linux®

./SETUP.bin -options-record <local_dir>/response_file.txt 

where response_file.txt is the name of the response file to be created. The file is located in the root directory of the relevant installation DVD. See Installation media.

The installation wizard is launched. Follow the prompts and complete the installation (see Using the installation wizard). A response file is created in the directory that you specified in the setup command.

Although the response file contains the parameters that you entered in the installation wizard, be aware that you might need to edit the file for each subsequent installation. This depends on the configuration of each workstation.


The response file that is created will contain unencrypted password information.

  • For all subsequent installations, enter the following command:
    SETUP.exe -options <local_dir>\response_file.txt -silent
    UNIX and Linux
    ./SETUP.bin -options <local_dir>/response_file.txt -silent
  • After each silent installation, review the installation messages in the summary.log file to check that installation was successful.
  • At the end of a successful installation, perform one of the following configuration tasks, depending on the type of agent you installed:

    Using  twsinst script

    Installing a new non-integratable agent

    You can use the twsinst script to install non-integratable agents on UNIX® and Linux®.

    Use twsinst to install non-integratable agents only if you do not run a JVM on the workstation. If this is not your situation, you might choose to perform a silent installation instead. See Performing a silent installation.

    Agents installed using twsinst can only be uninstalled using twsinst. Agents installed using twsinst do not support the connector feature.

    Refer to for a complete list of supported operating systems.

    During the installation process, twsinst creates a file in the /TWA/TWS directory for each of the installation steps. If you stop and restart the installation, the installation process starts from the installation step where it was stopped.

    To install a non-integratable agent, perform the following steps:

    1. Insert the DVD for your operating system. See Installation media.
    2. Create the Tivoli Workload Scheduler user. The software is installed by default in the user's home directory, referred to as /TWA/TWS.
      /TWA/TWS (for example: /opt/TWA/TWS)
    3. Log in as root on the operating system where you want to install.
    4. Run the twsinst script.

    A successful installation using the twsinst issues the return code RC = 0. A failed installation issues the return code RC = 1. In the case of a failed installation, refer to Installation, uninstallation, and upgrade messages.


    Show command usage and version
    twsinst -u | -v
    Install a new instance
    twsinst -new -uname <username>
        [-thiscpu <workstation>]
        [-master <workstation>]
        [-port <port_number>]
        [-company <company_name>] 
        [-inst_dir <install_dir>]
        [-lang <lang_id>]


    Displays command usage information and exits.
    Displays the command version and exits.
    Specifies the type of installation to perform:
    A fresh installation of Tivoli Workload Scheduler, version 8.5. Installs an agent or master and all supported language packs.
    -uname <username>
    The name of the user for which Tivoli Workload Scheduler is installed, updated, or uninstalled. This user name is not to be confused with the user performing the installation logged on as root. For a new installation, this user account must be created manually before running the installation. Create a user with a home directory. Tivoli Workload Scheduler is installed by default under the HOME directory of the specified user.
    -thiscpu <workstation>
    The name of the Tivoli Workload Scheduler workstation of this installation. The name cannot exceed 16 characters. This name is registered in the localopts file. If not specified, the default value is the hostname of the workstation.
    master <workstation>
    The workstation name of the master domain manager. This name cannot exceed 16 characters and cannot contain spaces. If not specified, the default value is MASTER.
    -port <port_number>
    The TCP/IP port number. This number is registered in the localopts file. The default value is 31111.
    -company <company_name>
    The name of the company. The company name cannot contain blank characters. The name appears in program headers and reports. If not specified, the default name is COMPANY.
    -inst_dir <install_dir>
    The directory of the Tivoli Workload Scheduler installation. This path cannot contain blanks. If not specified, the path is set to the username home directory.
    -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.


    This is the language in which the installation log is recorded, and not the language of the installed engine instance. twsinst installs all languages as default.
    Create the symlink between /usr/bin/at and <install_dir>/TWS/bin/at. See Table 5 for more information.
    Skip the check of the user in the /etc/password file or using the su command. Enable this option if the authentication process within your organization is not standard, thereby disabling the default authentication option.
    Reset the permissions of the libatrc library.


    For example, a sample twsinst script for installing a new non-integratable agent workstation:
    ./twsinst -new -uname <TWS_user> -thiscpu phughes -master TWSmdm
          -port 37124 -company IBM   

    Help -

    Using TCM software packages

    Using TCM software packages

    Non-integratable agents can be installed distributing a software package block (SPB), using the Software Distribution component of Tivoli® Configuration Manager, Versions 4.1, 4.2, 4.2.1, 4.2.2, or 4.2.3. You can distribute the SPB, using either the command line interface or from the Tivoli desktop.


    Do not modify the SPB supplied with the product.

    An SPB exists for each supported operating system located on the installation disks under the directory of the operating system. The SPBs are named according to the operating system: Tivoli_TWS_<operating_system>.SPB. For the packages to be distributed, they must be imported in software package profiles . The software package profiles must be named according to the operating system and user: FP_TWS_<operating_system>_<TWS_user>.8.5.00. Possible values for operating system are:

    An SPB also exists to install language packs: Tivoli_TWS_LP.SPB. The software package profiles must be named according to the user: Tivoli_TWS_LP_<TWS_user>.8.5.00. The language pack software package block is located in the root directory of the installation DVD.

    Tivoli Workload Scheduler installation parameters are defined as default variables in the software package. Table 12 is a list of installation parameters.

    Table 12. SPB installation parameters
    Variable Description
    installer Windows® operating systems only. The user ID of the installer of Tivoli Workload Scheduler. The default value is Administrator.
    install_dir Required. The fully qualified path to the location of the Tivoli Workload Scheduler installation. This path cannot contain blanks. On Windows workstations, the path is created if it does not already exist. On UNIX® and Linux® operating systems, the path is the same as the user's home directory. The default values are:
    • Windows: $(system_drive)\win32app1TWS\<TWS_user>
    • UNIX and Linux: opt/TWS/<TWS_user>
    tws_user Required. The user name for which Tivoli Workload Scheduler instance is being installed. On Windows systems, if this user account does not already exist, it is automatically created. If you specify a domain user or domain controller, you must specify the domain in the domain variable. If you specify a local user with the same name as a domain user, the local user must first be created manually by an administrator and then identified as <system_name>\<user_name>.

    On UNIX and Linux operating systems, this user account must be created manually before running the installation.

    The default value is <user_name>.

    domain Optional unless the user is a domain user. Windows operating systems only. The domain name of the user. If you specify a domain user, specify the name as domain_name\<user_name>. The default value is <computer_name>.
    backup_dir Optional. Indicates the location to where the current installation is copied before it is upgraded. The default value is <install_dir>_backup_<TWS_user>.
    pwd (for Windows only) Required for Windows operating systems when performing a first time install. The password associated with the <TWS_user> user name. The SPB password variable is passed to the pwd variable.
    Required. This parameter must always be set to true.
    company Optional. The company name. This name appears in program headers and reports. The default value is COMPANY.
    this_cpu Required. The name of the workstation on which you are performing the installation. The name cannot exceed 16 characters and cannot contain spaces. The default value is THIS_CPU.
    master_cpu Optional. The name of the master domain manager. The name cannot exceed 16 characters and cannot contain spaces. The default is MASTER.
    tcp_port Required. The TCP/IP port number used by the instance being installed. When installing more than one instance on the same workstation, use different port numbers for each instance. It must be an unassigned 16-bit value in the range 1-65535. The default value is 31111.
    fresh_install Required. Indicates if this is a first time install. To perform a fresh installation, specify true. To perform an upgrade, specify false. The default value is true.
    upgrade Required. Indicates if the install is an upgrade. To perform an upgrade, specify true. To perform a fresh installation, specify false. The default value is false.
    from_release When you specify upgrade="true", you must also specify from_release indicating the release of the existing instance. The default value is 8.2 and the format is 8.x.x.
    backup Optional. Indicates a backup. For a fresh install, specify false. The default value is false.
    1. fresh_install and upgrade are mutually exclusive.
    2. The variables that are not documented here are for debugging purposes only. See Tivoli Workload Scheduler: Administration Guide.


    Installation procedure

    When installing, the installation procedure checks that there is sufficient space for the Tivoli Workload Scheduler engine to be installed. It does not, however, check that there is sufficient space for the Configuration Manager backup directory specified in the swdis.ini file. Before you begin installing, make sure that there is enough space available in the directory specified in the backup_dir parameter in the swdis.ini file according to the operating system. Refer to the Tivoli® Configuration Manager documentation for these space requirements.

    To perform the installation, complete the following steps:

    1. Create a software package profile: FP_TWS_<operating_system>_<TWS_user>.8.5.00 where operating_system is the operating system where you are installing and <TWS_user> is the user of the installation.
    2. Import the software package block using the wimpspo command. When you import the software package block, you must pass the name of the profile to wimpspo so that the Configuration Manager endpoint catalogs the name correctly.
    3. Install the software package block using the wdinstsp command.

      Note that the supplied software packages must be installed as COMMITTED. The packages cannot be installed as UNDOABLE because the UNDO action does not rollback the product registry entries.

    4. Perform the steps in Configuring an agent.

    For complete instructions on performing these tasks, refer to wimpspo and wdinstsp in the IBM® Tivoli Configuration Manager, Reference Manual for Software Distribution, and the IBM Tivoli Configuration Manager, User's Guide for Software Distribution.


    The following are examples of the settings required to perform a fresh installation of an agent on Windows® and UNIX® workstations. See Table 12 for a description of the parameters.

    The following Windows example describes an installation with the user <TWS_user> and the endpoint Tivoli_TWS_WINDOWS.

    wdinstsp -f -uy -D install_dir="C:\ibm\TWS\twsuser\TWS" -D tws_user="twsuser" -D password="twspasswd" -D company="company_name" -D this_cpu="CPU_name" -D master_cpu="MTMDM" -D tcp_port="33311" -D domain="domain_name" -n "FP_TWS_WINDOWS_twsuser." "C:\Output\TWS_VLAST\WINDOWS\Tivoli_TWS_WINDOWS.SPB"

    The following UNIX example describes an installation with the user <TWS_user> and the endpoint Tivoli_TWS_LINUX_I386.

    wdinstsp -f -uy -D install_dir=/home/twsuser/TWS -D tws_user=twsuser -D company=company_name -D this_cpu=cpu_name -D master_cpu=MTMDM -D tcp_port=33311 -D serverName=server1 -n FP_TWS_WINDOWS_twsuser. /mnt/gsa/home/s/l/user1/web/public/SPB_INSTALL/LINUX_I386/Tivoli_TWS_LINUX_I386.SPB



    Groupthink : Two Party System as Polyarchy : Corruption of Regulators : Bureaucracies : Understanding Micromanagers and Control Freaks : Toxic Managers :   Harvard Mafia : Diplomatic Communication : Surviving a Bad Performance Review : Insufficient Retirement Funds as Immanent Problem of Neoliberal Regime : PseudoScience : Who Rules America : Neoliberalism  : The Iron Law of Oligarchy : Libertarian Philosophy


    War and Peace : Skeptical Finance : John Kenneth Galbraith :Talleyrand : Oscar Wilde : Otto Von Bismarck : Keynes : George Carlin : Skeptics : Propaganda  : SE quotes : Language Design and Programming Quotes : Random IT-related quotesSomerset Maugham : Marcus Aurelius : Kurt Vonnegut : Eric Hoffer : Winston Churchill : Napoleon Bonaparte : Ambrose BierceBernard Shaw : Mark Twain Quotes


    Vol 25, No.12 (December, 2013) Rational Fools vs. Efficient Crooks The efficient markets hypothesis : Political Skeptic Bulletin, 2013 : Unemployment Bulletin, 2010 :  Vol 23, No.10 (October, 2011) An observation about corporate security departments : Slightly Skeptical Euromaydan Chronicles, June 2014 : Greenspan legacy bulletin, 2008 : Vol 25, No.10 (October, 2013) Cryptolocker Trojan (Win32/Crilock.A) : Vol 25, No.08 (August, 2013) Cloud providers as intelligence collection hubs : Financial Humor Bulletin, 2010 : Inequality Bulletin, 2009 : Financial Humor Bulletin, 2008 : Copyleft Problems Bulletin, 2004 : Financial Humor Bulletin, 2011 : Energy Bulletin, 2010 : Malware Protection Bulletin, 2010 : Vol 26, No.1 (January, 2013) Object-Oriented Cult : Political Skeptic Bulletin, 2011 : Vol 23, No.11 (November, 2011) Softpanorama classification of sysadmin horror stories : Vol 25, No.05 (May, 2013) Corporate bullshit as a communication method  : Vol 25, No.06 (June, 2013) A Note on the Relationship of Brooks Law and Conway Law


    Fifty glorious years (1950-2000): the triumph of the US computer engineering : Donald Knuth : TAoCP and its Influence of Computer Science : Richard Stallman : Linus Torvalds  : Larry Wall  : John K. Ousterhout : CTSS : Multix OS Unix History : Unix shell history : VI editor : History of pipes concept : Solaris : MS DOSProgramming Languages History : PL/1 : Simula 67 : C : History of GCC developmentScripting Languages : Perl history   : OS History : Mail : DNS : SSH : CPU Instruction Sets : SPARC systems 1987-2006 : Norton Commander : Norton Utilities : Norton Ghost : Frontpage history : Malware Defense History : GNU Screen : OSS early history

    Classic books:

    The Peter Principle : Parkinson Law : 1984 : The Mythical Man-MonthHow to Solve It by George Polya : The Art of Computer Programming : The Elements of Programming Style : The Unix Hater’s Handbook : The Jargon file : The True Believer : Programming Pearls : The Good Soldier Svejk : The Power Elite

    Most popular humor pages:

    Manifest of the Softpanorama IT Slacker Society : Ten Commandments of the IT Slackers Society : Computer Humor Collection : BSD Logo Story : The Cuckoo's Egg : IT Slang : C++ Humor : ARE YOU A BBS ADDICT? : The Perl Purity Test : Object oriented programmers of all nations : Financial Humor : Financial Humor Bulletin, 2008 : Financial Humor Bulletin, 2010 : The Most Comprehensive Collection of Editor-related Humor : Programming Language Humor : Goldman Sachs related humor : Greenspan humor : C Humor : Scripting Humor : Real Programmers Humor : Web Humor : GPL-related Humor : OFM Humor : Politically Incorrect Humor : IDS Humor : "Linux Sucks" Humor : Russian Musical Humor : Best Russian Programmer Humor : Microsoft plans to buy Catholic Church : Richard Stallman Related Humor : Admin Humor : Perl-related Humor : Linus Torvalds Related humor : PseudoScience Related Humor : Networking Humor : Shell Humor : Financial Humor Bulletin, 2011 : Financial Humor Bulletin, 2012 : Financial Humor Bulletin, 2013 : Java Humor : Software Engineering Humor : Sun Solaris Related Humor : Education Humor : IBM Humor : Assembler-related Humor : VIM Humor : Computer Viruses Humor : Bright tomorrow is rescheduled to a day after tomorrow : Classic Computer Humor

    The Last but not Least Technology is dominated by two types of people: those who understand what they do not manage and those who manage what they do not understand ~Archibald Putt. Ph.D

    Copyright © 1996-2021 by Softpanorama Society. was initially created as a service to the (now defunct) UN Sustainable Development Networking Programme (SDNP) without any remuneration. This document is an industrial compilation designed and created exclusively for educational use and is distributed under the Softpanorama Content License. Original materials copyright belong to respective owners. Quotes are made for educational purposes only in compliance with the fair use doctrine.

    FAIR USE NOTICE This site contains copyrighted material the use of which has not always been specifically authorized by the copyright owner. We are making such material available to advance understanding of computer science, IT technology, economic, scientific, and social issues. We believe this constitutes a 'fair use' of any such copyrighted material as provided by section 107 of the US Copyright Law according to which such material can be distributed without profit exclusively for research and educational purposes.

    This is a Spartan WHYFF (We Help You For Free) site written by people for whom English is not a native language. Grammar and spelling errors should be expected. The site contain some broken links as it develops like a living tree...

    You can use PayPal to to buy a cup of coffee for authors of this site


    The statements, views and opinions presented on this web page are those of the author (or referenced source) and are not endorsed by, nor do they necessarily reflect, the opinions of the Softpanorama society. We do not warrant the correctness of the information provided or its fitness for any purpose. The site uses AdSense so you need to be aware of Google privacy policy. You you do not want to be tracked by Google please disable Javascript for this site. This site is perfectly usable without Javascript.

    Last modified: March 12, 2019