Configure HTTP manually for Cognos BI Server

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

We can configure HTTP by adding a component to the Cognos BI Server’s cogstartup.xml file and then customizing it for the deployment.

See Cognos information center.

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/CognosBI/configuration

   • Windows: C:\IBM\Cognos\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 the 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.myco.com:80/cognos/servlet/dispatch/ext</crn:item>
   </crn:value>
   </crn:parameter>
   
   <crn:parameter name="sdk">
   <crn:value xsi:type="xsd:anyURI">http://cognos.myco.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 hosting 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.

Parent topic:
Configure Cognos BI Server to use HTTP