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.