wserver

-a server_name

Specifies the name of the Tivoli server. You can specify either the local host name or a remote host name. The default is the local host name. On systems with host names longer than eight characters, the hostname command returns unknown. This option lets you fix that behavior.

Note

If you are installing on the local host and specifying a fully qualified host name, the appropriate remote access must be enabled by updating the local /.rhosts file.

-c cdrom_path

Specifies the path to the CD-ROM image.

-d

Sets the installation variable (install_variable) to its default value. This flag is used for only the command-line only version. This option is required unless you select between each and every one of the options and environment variables.

-p path_prefix[!]

Attaches the specified path prefix to the beginning of the default installation paths. If the optional exclamation mark (!) is present, path_prefix is prepended to only the last component of the default installation paths. For example, the default installation path for the binaries is /usr/local/Tivoli/bin. If you specify -p /Tivoli, the installation path would be /Tivoli/usr/local/Tivoli/bin. If you specify -p /Tivoli!, the path would be /Tivoli/bin.

-P

Specifies the use of a global root password instead of trusted host access. This option is used only when installing on a remote host.

install_variable=value

Specifies variables that control the installation. The variables can be set or the defaulted used on the command line. If you are using the X11 version, you can change these values during the installation. When installing from the command line, the only way to set these values is to pass them on the command line. Use the installation variables to specify the required information or to override default information.

Note

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

Several of the installation variables specify the directories where the Tivoli server is installed. If a directory already contains files from a previous installation, the command does not recopy the files. You can force any of these directories to be reinstalled by entering the ! character after the specified directory. The following are the installation variables related to directories:

BIN=binaries_dir: Overrides the default installation path (/usr/local/Tivoli/bin) for Tivoli Management Framework binaries.
LIB=libraries_dir: Overrides the default installation path (/usr/local/Tivoli/lib) for Tivoli Management Framework libraries.
ALIDB=server_database_dir: Overrides the default installation path (/var/spool/Tivoli) for Tivoli Management Framework server database.
MAN=manpage_dir: Overrides the default installation path (/usr/local/Tivoli/man) for Tivoli Management Framework manual pages.
APPD=X11_dir: Overrides the default installation path (/usr/lib/X11/app-defaults) for the X11 application defaults.
CAT=message_catalog_dir: Overrides the default installation path (/usr/local/Tivoli/msg_cat) for Tivoli Management Framework message catalogs.

The following are other useful installation variables:

@EL@=None | Simple | DES: Defines the encryption level to be used when installing the server. The default level is Simple.
@ForceBind@=yes | no: Forces communication connections to bind to a single Internet Protocol (IP) address. This option is used in certain high availability or failover configurations where multiple object dispatchers reside at different IP addresses on a single physical system.
AutoStart=0 | 1: Indicates whether the Tivoli daemon should be started at system boot time. By default, the daemon is not started.
CreatePaths=0 | 1: Indicates whether to create (1) the specified directories if they do not already exist. By default, the directories are created. It is considered an error if a directory that you specified with install_variable does not exist.
IP=install_password: Sets the installation password. By default, there is no password. This password is the installation password when you install Tivoli Management Framework on clients, the default seed when you are using encryption, and the interregion password when you are connecting Tivoli regions using encryption.
LK=license_key: Specifies the license key. This value specified for this installation variable is ignored.
RN=region_name: Overrides the default policy region name. The default policy region name can be changed later.
SetPort=0 | 1: Indicates whether to configure the remote start capability of the Tivoli daemon. By default, this capability is not configured.

Authorization

Root access on the system being installed.

Files

/tmp/tivoli.sinstall: Contains verbose debugging information from the latest installation attempt.
/tmp/install.cfg.error /tmp/install.cfg.output: Transient file created during the initialization of the Tivoli management region server database. After initialization, if there are no errors, these files are removed.
/etc/Tivoli/setup_env.sh: A file that can be sourced in from Bourne shell compatible shells after installation that contains useful shell environment variables.
/etc/Tivoli/setup_env.csh: A file that can be sourced in from C shell compatible shells after installation that contains useful shell environment variables.

Environment Variables

A number of environment variables have installation implications:

DISPLAY: Specifies the X11 display to be used for installation.
DOGUI: If set to something other than the value of the$DISPLAY variable, the command line version is used.
EtcTivoli: The default is the /etc/Tivoli directory. Do not override.
BINDIR: If you do not want to run this command from the install_dir directory (the directory where you ran the wpreinst.sh command or the directory where you un-tarred the file0.tar file) you can set this variable to your install_dir directory.
o_dispatch: The default port is 94. Do not override.
SAVE_CFG_FILES: The debugging files used during initialization of the Tivoli server, /tmp/install.cfg.output and /tmp/install/cfg.error, are removed after a successful installation. If you want to keep them, you can set this variable to a nonnull value.

Note

When you install Tivoli Management Framework on a UNIX operating system, the /tmp/.tivoli directory is created. This directory contains files that are required by the object dispatcher process. You should not delete this directory or any of its contents unless explicitly directed to by your Tivoli support provider. You should also ensure that regularly scheduled disk clean-up jobs (cron or Tivoli jobs) do not remove this directory or its contents.

To use a different directory, you must set an environment variable in both the object dispatcher and the shell. After installing Tivoli Management Framework, perform the following steps to set the necessary environment variables:

Create a directory. This directory must have at least public read and write permissions. However, define full permissions and set the sticky bit to ensure that users cannot modify files that they do not own.
Set the environment variable in the object dispatcher:
1. Enter the following command:
```
odadmin environ get > envfile
```
2. Add the following line to the envfile file and save it:
```
TIVOLI_COMM_DIR=new_directory_name
```
3. Enter the following command:
```
odadmin environ set < envfile
```
Edit the Tivoli-provided setup_env.csh, setup_env.sh, and oserv.rc files in the /etc/Tivoli directory to set the TIVOLI_COMM_DIR variable.
For HP-UX and Solaris systems, add the following line to the file that starts the object dispatcher:
```
TIVOLI_COMM_DIR=new_directory_name
```
Insert the line near where the other environment variables are set, in a location that runs before the object dispatcher is started. The following list contains the file that needs to be changed on each operating system:
- For HP-UX operating systems: /sbin/init.d/Tivoli
- For Solaris operating environments: /etc/rc3.d/S99Tivoli
Shut down the object dispatcher by entering the following command:
```
odadmin shutdown all
```
Restart the object dispatcher on the Tivoli server by entering the following command:
```
odadmin reexec 1
```
Restart the object dispatcher on the managed nodes by entering the following command:
```
odadmin reexec clients
```

Examples

The following examples show command line installations. The DOGUI environment variable is set to no. The X11 version of installation is similar.

The following example installs the Tivoli server on the local machine. The complete path to the CD-ROM image is /cdrom/cdrom0. The binaries are installed in /Tivoli/bin. The libraries are installed in /Tivoli/lib. The server database is installed in /Tivoli/database. The manpages are installed in /Tivoli/man. The X11 defaults are installed in /Tivoli/X11. The message catalogs are installed in /Tivoli/cat.. A default policy region is created with the name NoonTide-Region. The Tivoli daemon automatically starts at system boot. The remote start capability of the Tivoli daemon is configured. The specified directories are created if they do not exist. The installation password is set to Tivoli4Ever. The default encryption level is not used.
```
./wserver -c /cdrom/cdrom0 BIN=Tivoli/bin \
LIB=Tivoli/lib ALIDB=/Tivoli/database MAN=/Tivoli/man \
APPD=/Tivoli/X11 CAT=/Tivoli/cat RN=NoonTide-Region \
AutoStart=1 SetPort=1 CreatePaths=1 IP=Tivoli4Ever
```
Note
To reinstall this Tivoli server, force the installation to overwrite the directory containing the Tivoli database (ALIDB=!). You can optionally overwrite any other directories. Use the ! character to force the installation to overwrite directories that already exist. The following example reinstalls the Tivoli server installed with the preceding command, overwriting each directory:
```
./wserver -c /cdrom/cdrom0 \
BIN=! LIB=! ALIDB=! MAN=! APPD=! CAT=! \
RN=NoonTide-Region AutoStart=1 \
SetPort=1 CreatePaths=1 IP=Tivoli4Ever
```
The following example installs the Tivoli server on the local machine. The complete path to the CD-ROM image is /cdrom. The binaries are installed in /Tivoli/bin. The libraries are installed in /Tivoli/lib. The server database is installed in /Tivoli/database. The manpages are installed in /Tivoli/man. A default policy region is created with the name NoonTide.
```
wserver -c /cdrom -d -p /Tivoli! ALIDB=/database \
RN=NoonTide
```
The following example installs the Tivoli server on the local machine. The complete path to the CD-ROM image is /cdrom. The binaries are installed in /Tivoli/bin. The libraries are installed in /Tivoli/lib. The server database is installed in /Tivoli/database. The manpages are installed in /Tivoli/man. A default policy region is created with the name NoonTide.
```
wserver -c /cdrom BIN=/Tivoli/bin LIB=/Tivoli/lib \
ALIDB=/Tivoli/database MAN=/Tivoli/man RN=NoonTide
```
The following example installs the Tivoli server on the local machine. The complete path to the CD-ROM image is /cdrom. Everything (binaries, libraries, and so on) is installed in the default locations under the user-specified directory /Tivoli.
```
wserver -c /cdrom -d
```
The following example installs the Tivoli server on cook, a remote machine. The complete path to the CD-ROM image is /cdrom, and this path must be reachable from both the local machine and the remote machine. The user is prompted to enter the root password on cook. Everything (binaries, libraries, and so on) is installed in the default locations.
```
wserver -c /cdrom -P -d -a cook
```

wserver

Syntax

Description

Options

Authorization

Files

Environment Variables

Examples

See Also