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` The log file, cogconfig.log, will be created by default without the -log option in the `cognos_location`/logs directory.
`-d`	Enables debug logging in the log file. You need to use it in conjunction with the -log option. The log file, cogconfig.log, will be created by default. You can use the -d option without using -log option.
`-config`	Saves the IBM Cognos Configuration in silent mode. Loads property values specified in the cogstartup.xml file into IBM Cognos Configuration, then saves it in silent mode without starting the services. `./cogconfig.sh -config` `cogconfig.bat -config`

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.