========================================================================
Support Note: 12
Product:      The Operations Pack (TOP)
Version:      All versions
Title:        Silent Installation of TOP
Created:      16 May 2006
Updated:      -

Copyright 2006 Gresham Software Labs Pty Ltd



---------------------------
Support for Silent Installs
---------------------------
Gresham use the WISE Install building product for TOP. To run an
install in silent mode the command line flag /s is used. All defaults
are then used to perform the install, unless the defaults are over-ridden
by environment variables.

Example
-------
This is the content of a batch (.bat) file to install TOP silently:

 set TOPINSTALL=full
 set TOPInstallDir=c:\temp\top
 set TOPBackup=YES
 set TOPIce=No
 set TOPShortcuts=MENU
 set TOPUser=Current
 set TOPMgrShortcuts=PATHSPOOL
 setup.exe /s



This assumes that the current directory contains the installation file
which is named "setup.exe". A detailed description of the environment
variables used to control the installation follows.

Environment Variables
=====================
Some customisation of the installation is possible through the following
environment variables. Environment variables are created and set using the
DOS set command. The syntax for the set command is:

set variable=value

Variables names and values are case-insensitive.


TOPInstall

The variable TOPInstall must be specified if any environment variables
are to be processed as parameters. The value passed to it must be one of

FULL -  Install full TOP product
SPOOL - Only install Spooler Manager component


TOPInstallDir

The variable TOPInstallDir can be used to specify an alternative
directory to install TOP to. If the final level of the directory
path doesn't exist, then it will be created.


TOPBackup

The variable TOPBackup controls whether or not a copy of replaced
files is to be saved. The value must be one of

YES - save replaced files
NO -  don't save replaced files


TOPIce

The variable TOPIce controls whether the installation configures
TOP to support the ACI ICE product. The value must be one of

YES - provide support for ICE
NO -  don't provide support for ICE


TOPUser

The variable TOPUser controls whiach workstation users application
shortcuts are installed for. The value must be one of

CURRENT -  Make shortcuts visible to current windows user only
ALL -      Make shortcuts visible to all windows user


TOPShortcuts

The variable TOPShortcuts controls what shortcuts are installed on
the workstation to provide access to TOP. The options are

DESKTOP -  create a shortcut on the desktop
PROGRAMS - create a shortcut in the Start Menu programs list
MENU -     create a shortcut directly on the start menu

The value can be a concatenation of one or more of the options
available, for example MENUPROGRAMS, if the shortcut is to be in
more than one place.


TOPMgrShortcuts

The variable TOPMgrShortcuts controls whether shortcuts are created
for the individual manager applets. The options are

SPOOL -  create shortcuts for the Spooler Manager
PATH -   create shortcuts for the Pathway Manager
COMMS -  create shortcuts for the Communications Manager
USER -   create shortcuts for the User Manager

The value can be a concatenation of one or more of the options
available, for example SPOOLCOMMS, if more than one shortcut is required.


TOPDoJRE

The variable TOPDoJRE controls whether the install runs the Java Run-time
Environment (JRE) installer if an install is required. This variable is
required because the JRE installer used by TOP install (JRE 1.3.1) cannot
run in silent-mode.

If no JRE is installed then TOP will have complete functionality except for
the built-in terminal emulators, which won't work. Administrators can
subsequently run a silent install of the JRE using the version appropriate
for their environment independently to rectify this.

YES - JRE 1.3.1 installation allowed
       (requires user interaction)
NO -  No JRE 1.3.1 installation is run