Previous Topic: Verify the Client InstallationNext Topic: How to Prepare for the Agent Installation


How to Install the Client Silently

You can perform a manual unattended (silent) client installation using the command line. You can use the command line installation for first-time installations only, not upgrades.

Use the following syntax to perform an unattended installation of the client from the command line:

DVD-drive:\install-path\setup.exe /s /v"/qoption [property1=\"value\" property2=\"value\" property3=\"value\"...]"
install-path

Specifies one of the following directories on the installation media:

/s

Specifies a silent installation, requiring no response after the installation is started. If you do not specify the /s argument, dialogs will appear during the installation, requiring user response.

/v

Passes command line switches and values of public properties to msiexec.exe. Any quotation marks inside the value for the /v parameter must be preceded by a backward slash \ (\").

/qoption

Specifies the options for setting what kind of user interface (UI) appears during the installation, as follows:

q, qn

No UI.

qb

Basic UI. Use qb! to hide the Cancel button.

qr

Reduced UI with no modal dialog displayed at the end of the installation.

qf

Full UI with any authored FatalError, UserExit, or Exit modal dialogs at the end.

qn+

No UI except for a modal dialog displayed at the end.

qb+

Basic UI with a modal dialog displayed at the end. The modal dialog appears if the user cancels the installation. Use qb+! to hide the Cancel button.

qb-

Basic UI with no modal dialogs; qb+- is not a supported UI level. Use qb-! to hide the Cancel button.

qb+!, qb-!

Basic UI with or without the modal dialog displayed at the end. Hides the Cancel button. These options can also be entered qb!+ and qb!-.

Note: The ! option is available with Windows Installer version 2.0 and works only with basic UI. It is not valid with the full UI.

property1=\"value\" property2=\"value\" property3=\"value\"...

Specifies one or more of the installation public properties. If there are spaces within the value, enclose the value in quotation marks, which must be preceded by the backslash character, as shown in this statement. For example, INSTALLDIR=\"C:\program files\CA\" specifies a path name with spaces, and COMPANYNAME=\"Jones Consulting Firm\" specifies a company name with spaces.

To clear a public property using the command line, set its value to an empty string.

Statements include the following:

INSTALLDIR=\"directory\"

Specifies the target installation directory for the client.

USERNAME=\"name\"

Specifies the name of the user who will be using the client.

COMPANYNAME=\"name\"

Specifies the name of the company for which the user works.

ALLUSERS=\"value\"

If this installation is for the current user only, do not set this property from the command line or set its value to an empty string.

1 makes the client available to all users who use this computer.

2 makes the client available to the current user only if the current user does not have admin rights; otherwise, install to all users.

ADDLOCAL=\"value\"

Specifies a list of features delimited by commas that are to be installed locally. The following lists the available features. Items marked with an asterisk (*) are always installed if ADDLOCAL or ADDSOURCE is not specified. However, if ADDLOCAL or ADDSOURCE is specified, you specify individually each feature that you want to install from the following lists. The feature names are case-sensitive. Use only a comma (no space) to separate the features.

  • For client installation-Administrator*, Workbench*, Documentation*, CommandLine*, Windows Shell Extensions (HarWin).
  • For Workbench only installation-Workbench*, Documentation*, CommandLine*, Windows Shell Extensions (HarWin).

Note: Use the feature name as Client64 instead of Workbench, for 64 bit client installation and workbench installations only.

ADDSOURCE=\"value\"

Specifies a list of features delimited by commas that are to be installed to run from the source. Typically, you use the ADDSOURCE parameter to install the client on a network. The same values and rules for specifying values that apply to the previous parameter (ADDLOCAL) also apply to ADDSOURCE.

INSTALLPECTONETWORK=\"Yes|No\"

Specify Yes to install PEC on the network or specify No to install PEC on the local computer. The default value is Yes.

This variable takes effect for network installations only; that is, if ADDSOURCE is specified.

/l \"path-name\log-file-name.log\"

The lowercase L operand creates the log file named log-file-name.log in the location you specify (path-name). The log file records all installation actions and any errors encountered during the installation process. For example, the following command specifies that the log file client.log be created in the C:\scm Downloads directory:

setup.exe /s /v"/l \"C:\scm Downloads\client.log\"

Important! If the computer needs to be restarted after a silent installation, Windows Installer restarts the computer with no warning.