IBM Cognos Configuration command-line options

Use command-line options with the configuration command to modify the behavior of IBM® Cognos® Configuration when it starts.
Table 1. Command line options and descriptions

Option

Descriptions

-h

Displays commands for IBM Cognos Configuration.

-s

Runs IBM Cognos Configuration in silent mode.

Uses property values specified in the cogstartup.xml file to configure installed components and then starts all services.

./cogconfig.sh -s

cogconfig.bat -s

-stop

Stops all IBM Cognos services.

./cogconfig.sh -stop

cogconfig.bat -stop

-startupfile path/filename.xml

Runs IBM Cognos Configuration using a file other than the cogstartup.xml file in the install_location/configuration directory.

-test

Uses property values specified in the cogstartup.xml file to test configuration settings.

./cogconfig.sh -test

cogconfig.bat -test

-notest

Starts IBM Cognos Configuration with the automatic testing tasks disabled.

./cogconfig.sh -notest

cogconfig.bat -notest

This option should not be used for the first time you start the product or if you are making configuration changes.

-utf8

Saves the configuration in UTF-8 encoding.

./cogconfig.sh -s -utf8

cogconfig.bat -s -utf8

-l language ID

Runs IBM Cognos Configuration using the language specified by the language identifier.

To run the configuration tool in silent mode using Simplified Chinese

./cogconfig.sh -l zh-cn

cogconfig.bat -l zh-cn

-e filename.xml

Exports the current configuration settings to the specified file.

./cogconfig.sh -e filename.xml

cogconfig.bat -e filename.xml

-log

Creates a cogconfig.timestamp.log error log file in the cognos_location/logs directory.

./cogconfig.sh -log

cogconfig.bat -log

You can use more than one command-line option at a time. For example, you can run IBM Cognos Configuration in silent mode and send all error messages to a log file.