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
- 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
- Make a backup copy of the cogstartup.xml file.
- Open the working copy of the cogstartup.xml file
for editing.
- 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>
- Save and close the file.
- Validate the modified file:
- Set
JAVA_HOME
to the WAS_install_path/java directory.
- Run the configuration script:
- AIX or Linux:
./cogconfig.sh -config
- Windows:
cogconfig.bat
-config
- Check the Cognos_BI_Server_install_path/logs/cogconfig_response.csv file
for a success message.
- Restart the Cognos server:
- Stop the IBM WebSphere® Application Server
that hosts the Cognos server.
- 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
- Start WebSphere Application
Server.
- Start the Cognos server.