winstall [-c source_dir] [-s server] [-i product] [-y] [install_variables] [-n | managed_node...]

The winstall command installs a Tivoli Enterprise product from the command line when invoked on the Tivoli region. Before installing any product, this command identifies the actions that are performed during the installation.

-c source_dir

Specifies the complete path to the directory containing the installation image. For source_dir, you can specify either the fully qualified path (for example /cdrom) or the source host and the path in the format source_host:path (for example oak:/cdrom).

-i product

Specifies the product index file from which the product is installed. Index files have an .IND extension.

-n

Installs the product on all managed nodes that do not currently have the product installed. This option is ignored when managed_node is specified.

-s server

Specifies the managed node to use as the installation server. If not specified, the server is the Tivoli server.

-y

Installs the product without requesting confirmation.

install_variables

Specifies product-specific keyword=value pairs. For details, see ***.

Note

Type the names of the installation options exactly as specified in the product documentation. Installation options are case sensitive.

managed_node

Specifies the managed nodes on which to install this Tivoli Enterprise product. You can specify multiple managed nodes. If you do not specify a managed node, the product is installed on all managed nodes in this Tivoli region.

You specify values for installation variables on the command line to control the installation. If a Tivoli Enterprise product has installation variables, you can view the index file for that product for its definitive list of installation variables. Use these variables to specify required and optional options as well as to override default installation information.

You can use installation variables to specify the directories where a Tivoli Enterprise product is to be installed. Specify these directories when you install Tivoli Management Framework; other Tivoli products use the same directories as Tivoli Management Framework. If a directory already contains the files, the files are not reinstalled. You can, however, force any of these directories to be overwritten by entering an exclamation mark (!) as the value for the specified directory. For example, to reinstall the binaries, you would enter BIN=! instead of entering the entire path to the binaries directory. This override feature applies to all installation variables.

The following are the variables related to installation directories:

BIN=binaries_dir

Overrides the default installation path for the product binaries (/usr/local/Tivoli/bin).

LIB=libraries_dir

Overrides the default installation path for the product libraries (/usr/local/Tivoli/lib).

DB=client_database

Overrides the default installation path for the product client database (/var/spool/Tivoli).

MAN=manpage

Overrides the default installation path for the product man pages (/usr/local/Tivoli/man).

CAT=message_catalog

Overrides the default installation path for the product message catalogs (/usr/local/Tivoli/msg_cat).

The following is another useful variable:

@CreatePaths@=0 | 1

Indicates whether to create (1) or not to create (0) any specified directory if it does not already exist. By default, directories are not created. You will receive an error message if a specified directory does not exist.

Requires install_product or senior in the Tivoli region

1. The following example installs Tivoli User Administration on all managed nodes in the Tivoli region, where the path to the installation image is /cdrom, and the product index file is ADMIN.

   winstall -c /cdrom -i ADMIN

2. The following example installs Tivoli Software Distribution on managed nodes dan and barney, where the path to the installation image is /dev0/cdrom, and the product index file is COURIER:

   winstall -c /dev0/cdrom -i COURIER dan barney

3. The following example reinstalls Tivoli User Administration on managed node petra, overwriting existing files in the binary directory, where the path to the installation image is /cdrom and the product index file is ADMIN:

   winstall -c /cdrom -i ADMIN BIN=! petra

wclient, wpatch, wserver