Monday, September 12, 2005

TIER Setup : Command Line Parameters

Setup Command Line Parameters

The TIER Setup program accepts optional command line parameters.
These can be useful to system administrators, and to other programs calling the Setup program.

But you may not need this if you use the TIER Server auto update feature with a TIER Startup folder on a network path,
and by configuring TIER to use the Sartup.ini file from that path to auto update to any new version.

/SILENT
/VERYSILENT
Instructs Setup to be silent or very silent.
When Setup is silent the wizard and the background window are not displayed but the installation progress window is.
When a setup is very silent this installation progress window is not displayed.
Everything else is normal so for example error messages during installation are displayed.

If a restart is necessary and the '/NORESTART' command isn't used and Setup is silent,
it will display a Reboot now? message box. If it's very silent it will reboot without asking.

/SUPPRESSMSGBOXES
Instructs Setup to suppress message boxes.
Only has an effect when combined with '/SILENT' and '/VERYSILENT'.
The default response in situations where there's a choice is:
-Yes in a 'Keep newer file?' situation.
-No in a 'File exists, confirm overwrite.' situation.
-Abort in Abort/Retry situations.
-Cancel in Retry/Cancel situations.
-Yes (=continue) in a DiskSpaceWarning/DirExists/DirDoesntExist/NoUninstallWarning/ExitSetupMessage/ConfirmUninstall situation.
-Yes (=restart) in a FinishedRestartMessage/UninstalledAndNeedsRestart situation.

5 message boxes are not suppressible:
-The About Setup message box.
-The Exit Setup? message box.
-The FileNotInDir2 message box displayed when Setup requires a new disk to be inserted and the disk was not found.
-Any (error) message box displayed before Setup (or Uninstall) could read the command line parameters.
-Any message box displayed by [Code] support function MsgBox.

/LOG
Causes Setup to create a log file in the user's TEMP directory detailing file installation and file run/execute actions taken during the installation process.
This can be a helpful debugging aid. For example, if you suspect a file isn't being replaced when you believe it should be (or vice versa),
the log file will tell you if the file was really skipped, and why.

The log file is created with a unique name based on the current date. (It will not overwrite or append to existing files.)
The information contained in the log file is technical in nature and therefore not intended to be understandable by end users.

/LOG="filename"
Same as /LOG, except it allows you to specify a fixed path/filename to use for the log file.
If a file with the specified name already exists it will be overwritten.
If the file cannot be created, Setup will abort with an error message.

/NOCANCEL
Prevents the user from cancelling during the installation process, by disabling the Cancel button and ignoring clicks on the close button.
Useful along with '/SILENT' or '/VERYSILENT'.

/NORESTART
Instructs Setup not to reboot even if it's necessary.
But, if setup is rebooting to replace old files that are currently in use, it will never get a chance to replace those old files.
In that case, those files will only get replaced whenever user reboots next time.

/RESTARTEXITCODE=exit code
Specifies the custom exit code that Setup is to return when a restart is needed. Useful along with '/NORESTART'. Also see Setup Exit Codes.

/LOADINF="filename"
Instructs Setup to load the settings from the specified file after having checked the command line.
This file can be prepared using the '/SAVEINF=' command as explained below.
Don't forget to use quotes if the filename contains spaces.

/SAVEINF="filename"
Instructs Setup to save installation settings to the specified file.
Don't forget to use quotes if the filename contains spaces.

/DIR="x:\dirname"
Overrides the default directory name displayed on the Select Destination Location wizard page.
A fully qualified pathname must be specified.
Note: By default, Tier installs to "C:\Program Files\Sequest Technologies\Tier".
You may better leave this as is.

/GROUP="folder name"
Overrides the default folder name displayed on the Select Start Menu Folder wizard page.

/NOICONS
Instructs Setup to initially check the Don't create any icons check box on the Select Start Menu Folder wizard page.

/COMPONENTS="comma separated list of component names"
Overrides the default components settings.
Using this command line parameter causes Setup to automatically select a custom type.

/TASKS="comma separated list of task names"
Specifies a list of tasks that should be initially selected or deselected.
To deselect a task, prefix its name with a "!" character.
Only the specified tasks (and their children) will be selected; the rest will be deselected.
Use the '/MERGETASKS' parameter instead if you want to keep the default set of tasks and only select/deselect some of them.

Examples:
Deselect all tasks, then select the "desktopicon" and "fileassoc" tasks:

/TASKS="desktopicon,fileassoc"
Deselect all tasks, then select a parent task item, but exclude one of its children:

/TASKS="parent,!parent\child"

/MERGETASKS="comma separated list of task names"
Like the /TASKS parameter, except the specified tasks will be merged with the set of tasks that would have otherwise been selected by default.
If UsePreviousTasks is set to yes, the specified tasks will be selected/deselected after any previous tasks are restored.

Examples:
Keep the default set of selected tasks, but additionally select the "desktopicon" and "fileassoc" tasks:
/MERGETASKS="desktopicon,fileassoc"
Keep the default set of selected tasks, but deselect the "desktopicon" task:
/MERGETASKS="!desktopicon"

/PASSWORD=password
Specifies the password to use. But TIER Setups do not use any passwords at this time.