Configuring HTTP manually for Cognos BI Server

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 BI Server’s cogstartup.xml file and then customizing it for your deployment.

For more information, see the Cognos information center.

Procedure

  1. On the computer where you installed Cognos Business Intelligence, navigate to the /configuration directory within the installation location of the BI Server component (specified by the cognos.biserver.install.path property in the cognos-setup.properties file); for example:
    • AIX or Linux: /opt/IBM/Cognos/CognosBI/configuration
    • Microsoft™ Windows™: C:\Program Files\IBM\Cognos\CognosBI\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=

    • gatewayDispatcherURIList
    • sdk

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

    <crn:parameter name="gatewayDispatcherURIList" opaque="true">
<crn:value xsi:type="cfg:sortedArray">
<crn:item xsi:type="xsd:anyURI" order="0">http://cognos.example.com:80/cognos/servlet/dispatch/ext</crn:item>
</crn:value>
</crn:parameter>

<crn:parameter name="sdk">
<crn:value xsi:type="xsd:anyURI">http://cognos.example.com:80/cognos/servlet/dispatch</crn:value>
</crn:parameter>
  5. Save and close the file.
  6. Validate the modified file:
    1. Set JAVA_HOME to the WAS_install_path/java directory.
    2. Run the configuration script:
      • AIX or Linux: ./cogconfig.sh -config
      • Windows: cogconfig.bat -config
    3. Check the Cognos_BI_Server_install_path/logs/cogconfig_response.csv file for a success message.
  7. Restart the Cognos server:
    1. Stop the IBM WebSphere® Application Server that hosts the Cognos server.
    2. Wait at least 1 full minute to ensure that all Cognos processes have stopped:
      • AIX or Linux: cgsServer.sh and CAM_LPSvr processes
      • Windows: cgsLauncher.exe and CAM_LPSvr processes
    3. Start WebSphere Application Server.
    4. Start the Cognos server.