Configuring HTTP manually for Cognos® Transformer

If your IBM® Cognos® Business Intelligence server runs on IBM® AIX® or Linux and does not provide a graphical user interface, you can configure HTTP settings manually.

About this task

You can configure HTTP by adding a component to the Cognos® Transformer’s cogstartup.xml file and then customizing it for your deployment.

For more information, see the Cognos® information center.


  1. On the computer where you installed Cognos® Transformer, navigate to the /configuration directory within the installation location of the Transformer component (specified by the cognos.transformer.install.path property in the file); for example:
    • IBM® AIX® or Linux: /opt/IBM/Cognos/Transformer/configuration
    • Microsoft Windows: C:\Program Files (x86)\IBM\Cognos\Transformer\configuration
  2. Make a backup copy of the cogstartup.xml file.
  3. Open the working copy of the cogstartup.xml file for editing.
  4. In the file, locate the following parameters and update their URI port references from 90xx to port 80:

    In this file, the URLs must be updated to point to the HTTP server's host name and port number. The port number must be included even if it's the standard port 80.

    <crn:parameter name=

    • gateway
    • sdk

    After your changes, those parameters should look like the ones that follow:

     <crn:parameter name="gateway">
    <crn:value xsi:type="xsd:anyURI"></crn:value>
    <crn:parameter name="sdk">
    <crn:value xsi:type="xsd:anyURI"></crn:value>
  5. Save and close the file.
  6. Validate the modified file: by running the following command: ./ -config
    1. Set the path as shown for your operating system:
      • AIX®: LIBPATH=Cognos_BI_Server_install_path/bin64
      • Linux: LD_LIBRARY_PATH=Cognos_BI_Server_install_path/bin64
      • Windows: PATH=Cognos_BI_Server_install_path/bin64;%PATH%
    2. Set JAVA_HOME to the WAS_install_path/java directory.
    3. Run the configuration script:
      • AIX® or Linux: ./ -config
      • Windows: cogconfig.bat -config
    4. Check the Cognos_Transformer_install_path/logs/cogconfig_response.csv file for a success message.

    You do not need to restart the Transformer component.

What to do next

Verify that Cognos is mapped to the IBM HTTP Server URLs in LotusConnections-config.xml. For more information, see Updating IBM Connections to use the HTTP server.