Use a silent configuration

To use a silent configuration, you must export a configuration from an existing installation that has the same IBM® Cognos® Analytics components installed. You can then run IBM Cognos Configuration in silent mode.

The exported configuration contains the properties of the IBM Cognos Analytics components that you installed on one computer.

Before you begin

Ensure that the configuration settings on the computer where you are exporting the configuration are appropriate to use on another computer with the same installed components. For example, if you changed the host name portion of the Gateway URI property from localhost to an IP address or computer name, ensure this setting is appropriate for the new computer's configuration.

Procedure

  1. In IBM Cognos Configuration, from the File menu, click Export as.
  2. When prompted about exporting decrypted content, click Yes.
  3. If you want to export the current configuration to a different folder, in the Look in box, locate and open the folder.
  4. In the File name box, type a name for the configuration file.
  5. Click Save.
  6. Copy the exported configuration file to the install_location/configuration directory on the computer where you plan to use the unattended configuration.
  7. Rename the file to cogstartup.xml.
  8. Go to install_location/bin or install_location/bin64 directory.
  9. Type the following command:
    • On UNIX or Linux®, type

      ./cogconfig.sh -s

    • On Windows, type

      cogconfig.bat -s

    Tip: To view log messages that were generated during an unattended configuration, see the cogconfig_response.csv file in the install_location/uninstall/logs directory.

    You can check if the unattended configuration was successful by checking the return status. A value of zero (0) indicates success and all other values indicate that an error occurred.

Results

IBM Cognos Configuration applies the configuration settings specified in the cogstartup.xml file, encrypts credentials, generates digital certificates, and if applicable, starts IBM Cognos service or process.