setup command

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 [-passwordFile filename]]

Parameters

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

-help
Displays this usage information and then exits.
-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 display 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. Runs the prerequisites check but does not run 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 cause 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: FAILED and WARNING messages during the prerequisites check 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 is displayed 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. You are prompted to create a password when the installation program starts, unless you use the -passwordFile option to provide the password. 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.
-passwordFile
Specifies a file that contains a password to be used for this installation session. The file name can be specified as a full or relative path. The file must contain only the password on the first line. The password can be any string of alphanumeric characters. The password can include white space characters. You use this option with the -secure option to skip the password prompt.

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

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 after the prerequisites check without installing the software.

./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