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]] [-https <port number>]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) orsilent
. - -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
oren_US
French fr
orfr_FR
German de
orde_DE
Italian it
orit_IT
Japanese ja
orja_JP
Korean ko
orko_KR
Portuguese (Brazilian) pt_BR
Spanish es
ores_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.
- -https <port number>
- Optional: The -https parameter can be used to control the port on which the browser connects to the GUI. The default port used by the installation program is 8443. If the port 8443 is in use, the installation program works upwards to find the first available port that can be used. Instead of the installation program choosing a port, this parameter can be used to indicate that a specific port is used (ensure that the port is available).
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 check 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 check 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