setup command syntax

You use the setup command to run the IBM® InfoSphere® Information Server installation program.

Command syntax

setup [-help] [-uimode mode] [-rsp rspfile] [-reportOnly | -force] [-reportFile rptfile] [-language languagecode] [-verbose] [-secure]

Parameters

Entering the setup command without parameters causes the installation program to start in graphical mode.

-help

Displays this usage information and then terminates.

-uiMode mode

Specifies the mode to run in. Valid values for mode can be graphical (default) or silent.

-rsp rspfile

Specifies the response file to use for this installation. For a silent mode installation, you must specify a response file by using this parameter. For a graphical mode installation, the settings in the response file that you specify appear in the wizard and you do not have to enter them again.

If you specify the -rsp parameter, the installation program runs in silent mode by default. To run in graphical mode with a response file, you must also specify the -uiMode graphical parameter.

-reportOnly

For a silent mode installation only. Performs the prerequisites check but does not perform the installation.

Use with the -reportFile parameter to store the results of the prerequisites check in a text file.

If this parameter is specified for a software removal, the parameter is ignored.

-force

Use this parameter to permit the installation program to continue even if the prerequisites checks fail.

In graphical mode, if -force is specified on the command line and a prerequisites check fails, an Ignore FAILED items and continue check box is shown in the window. To continue the installation, click this check box and then click Next. If -force is not specified, the check box is not shown and the Next button is disabled.

In silent mode, if -force is specified on the command line and a prerequisites check fails, the installation process continues. If -force is not specified, the installation process halts if prerequisites check tests fail.

Important: Prerequisites check FAILED and WARNING messages indicate items that might cause a failed installation or that might cause malfunctions in the installed software. Use the -force option only if directed by IBM Support.

-reportFile rptfile

For a silent mode installation only. Specifies a text file for the prerequisites check report.

If a reportFile value is not specified, the report is displayed to the console.

-language languagecode

Specifies the language that displays for the installation.

The following table lists valid language codes.

Table 1. Language codes
Language	Codes
Chinese (Simplified)	`zh_CN`
Chinese (Traditional)	`zh_TW`
English	`en` or `en_US`
French	`fr` or `fr_FR`
German	`de` or `de_DE`
Italian	`it` or `it_IT`
Japanese	`ja` or `ja_JP`
Korean	`ko` or `ko_KR`
Portuguese (Brazilian)	`pt_BR`
Spanish	`es` or `es_ES`

-verbose

Starts the installation session in trace mode. In this mode, log messages are displayed to the console and are also written to the log file. You can use this option in silent mode or graphical mode.

If you do not specify this parameter, log messages are written to the log file only.

-secure

For a graphical mode installation only. Prompts you to create a password when the installation program starts. The password is used to authenticate access to the installation program from the browser. The password can be any string of alphanumeric characters. The password can include white space characters.

Examples

The following command causes the installation program to prompt for a password and then start in graphical mode. The installation program uses the settings in the rsp.txt response file. It stores log messages in a log file.

./setup -secure -rsp rsp.txt -uiMode graphical

The following command causes the installation program to start in silent mode. The installation program uses the settings in the rsp.txt response file. It stores log messages in a log file. When the prerequisites checks run, results are stored in prq.txt. The installation program stops if a prerequisite check test fails.

./setup -rsp rsp.txt -reportFile prq.txt

./setup -rsp rsp.txt -reportFile prq.txt -reportOnly

The following command causes the installation program to start in silent mode. The installation program uses the settings in the rsp.txt response file. It stores log messages in a log file and also displays them to the console. When the prerequisites check runs, results are stored in prq.txt.

./setup -rsp rsp.txt -reportFile prq.txt -verbose