Changing the Gateway

To improve Web server performance, you can configure Cognos 8 to use alternate gateways that replace the default CGI program. You can use one of the following gateways:

Microsoft Internet Application Programming Interface (ISAPI) for Microsoft Internet Information Services on Windows
Apache Web Server module
Servlet Gateway Java application for application servers

There is no additional Web server configuration required to use ISAPI.To access Cognos 8 components using ISAPI, in Cognos Configuration, change the cognos.cgi portion of the Gateway URI property to cognosisapi.dll. Then specify the ISAPI URI, http://host_name/cognos8/isapi, in your browser.

Before you change the gateway, we recommend that you first ensure that the default CGI gateway and your configuration work in your environment.

Configure the Gateway for Cognos Apache Web Server Module

Cognos 8 provides two Apache modules. The Cognos Apache module requires Apache Server 1.3.x and the Cognos Apache 2 module requires Apache Server 2.0.x.

Steps

Stop Apache Web Server.
Append the c8_location/cgi-bin directory to the appropriate environment variable:
On HP-UX PA-RISC, do the following:
- Ensure that the LD_PRELOAD environment variable contains /usr/lib/libcl.2.
- For Apache 1.3, set the COG_CGIBIN_DIR environment variable to c8_location/cgi-bin.
Go to the Apache_installation/conf directory.
Open the httpd.conf file in an editor.

Add the following to the end of the load module list:

LoadModule cognos_module "c8_location/cgi-bin/module_name"

where module_name is as follows:

Operating system	Apache 1.3 module	Apache 2.0 module
Windows	mod_cognos.dll	mod2_cognos.dll
Solaris, AIX	mod_cognos.so	mod2_cognos.so
HP-UX PA-RISC	mod_cognos.sl	mod2_cognos.sl
HP-UX IA, Linux	(not supported)	mod2_cognos.s0

For Apache 1.3, add the following to the end of the add module list:
AddModule mod_cognos.cpp

Add the following to the aliases section:

ScriptAlias /cognos8/cgi-bin "c8_location/cgi-bin"

Alias /cognos8 "c8_location/webcontent"

<Directory "c8_location/webcontent">

Options Indexes MultiViews

</Directory>

The <Directory> directive is optional.

Tip: Ensure that you define the cognos8/cgi-bin alias before the cognos8 alias.

Add the following to the server status reports section:

<Location /cognos8/cgi-bin/cognos_module>

  SetHandler cognos-handler

</Location>

To enable the gateway diagnostic page, add the following to the server status reports section:
```
<Location /cognos8/cgi-bin/diag_cognos_module>
```
```
  SetHandler cognos-handler
```
```
</Location>
```
The diag_ string is required.
For Apache 1.3, on Windows, Solaris, and AIX, add the following to the user directory section:
```
<IfModule mod_cognos.cpp>
```
```
  CGIBinDir "c8_location/cgi-bin"
```
```
</IfModule>
```

For Apache 2.0, add the following to the user directory section:

<IfModule mod_cognos.c>

  CGIBinDir "c8_location/cgi-bin"

</IfModule>

Save and close the file.
For Apache 2.0, on HP-UX, enable searching for LD_LIBRARY_PATH by running the following command in the Apache_installation/bin directory:
chatr +s enable +b enable httpd
Start Apache Web Server.
In Cognos Configuration, configure the Gateway URI property to use the apache_mod gateway:
http://host_name:port/cognos8/cgi-bin/filename
where filename matches the name that you used in step 9.

Configure the Servlet Gateway

If you configure the Cognos Servlet Gateway to run on a supported application server, your environment does not require a Web server. The application server and the Cognos Servlet Gateway replace the functions provided by a Web server and other Cognos gateways.

Before you build and deploy the Cognos Servlet Gateway, ensure the following:

The application server is installed and running on each computer where the servlet gateway is to be installed.
Cognos 8 Gateway components are installed on the same system as the application server.
The Cognos 8 dispatcher and Content Manager components are installed and running in the environment.
The application server user account has full access permissions for the Cognos installation.
We recommend that you create a new UNIX or Linux group named cognos8. This group must contain the user that starts the application server and the user that owns the Cognos files. Change the group ownership of the Cognos files to the cognos8 group, and change the file permissions for all Cognos files to GROUP READABLE/WRITABLE/EXECUTABLE. For simplicity, you can also use the application server user account to install and run Cognos components.

To set up the Cognos Servlet Gateway to run on your application server, do the following:

	Create a separate JVM instance, if necessary. If you plan to run Cognos 8 and the Cognos Servlet Gateway on the same application server, the servlet gateway must be deployed to a separate JVM instance.
	Check that Cognos components are properly set up.
	Set environment variables.
	Update the Java environment.
	Configure Cognos Servlet Gateway to run on the application server.
	Change the application server startup script, if necessary.
	Change the Cognos dispatcher properties file, if using Oracle Application Server.
	Configure application server properties and deploy Cognos Servlet Gateway.
	Enable SSL, if required.
	Configure the Web server.

You can then access Cognos 8 components using the Cognos Servlet Gateway, by entering the gateway URI. For example,

http[s]:host_name:port/ServletGateway

The Cognos Servlet Gateway URI is case-sensitive.