To use IBM Cognos product documentation, you must enable JavaScript in your browser.

Configuring IBM Cognos 8 for an Application Server other than Tomcat

IBM Cognos 8 installs and uses Tomcat as the application server by default. You can choose to run IBM Cognos 8 within another supported server instead:

To ensure your product works properly, apply all minimum required operating system patches and use only the versions of other software that are supported for an IBM Cognos product.

To review an up-to-date list of environments supported by IBM Cognos products, such as operating systems, patches, browsers, Web servers, directory servers, database servers, and application servers, visit the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html).

It is important to note that the Linux operating system is available in a number of distributions and supports a number of hardware platforms. Ensure that the operating system and hardware combination you are using is a supported combination.

You can choose to run the IBM Cognos Servlet Gateway on a supported application server instead of using a Web server . When using the servlet gateway, your environment does not require a Web server. The application server and the servlet gateway replace the functions provided by the Web server and other IBM Cognos gateways. IBM Cognos 8 must be installed and running prior to configuring and deploying the IBM Cognos Servlet Gateway.

If you are upgrading from ReportNet to IBM Cognos 8, see Upgrade to IBM Cognos 8 in an Application Server Environment.

If you are upgrading from Metrics Manager to IBM Cognos 8 Metrics Manager, see Upgrade from Metrics Manager to IBM Cognos 8 in an Application Server Environment.

For information about configuring a multi-server distributed installation of IBM Cognos 8 in an application server environment, contact the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html).

To set up IBM Cognos 8 to run on your application server, do the following:

      

Create a separate JVM instance, if necessary.

      

Check that IBM Cognos components are properly set up.

      

Back up any existing IBM Cognos data and encryption keys, if required.

      

Set environment variables.

      

Update the Java environment.

      

Configure IBM Cognos components to run within the application server.

      

Identifying the JDK for WebLogic 9 on AIX, if necessary.

      

Change the application server startup script, if necessary.

      

Configure application server properties and deploy IBM Cognos 8.

      

Enable SSL, if required.

      

Configure the web server.

      

Unregister dispatchers that are no longer used.

      

Import any backed up content store data.

After setting up IBM Cognos 8 to run on your application server, you can perform some additional configuration tasks to customize the behavior of IBM Cognos components to better suit your reporting environment .

Tip: Do not use install paths that contain spaces for the application server or IBM Cognos 8. Spaces interfere with the internal scripts and command parameters. If you must use an install path that includes spaces, use the 8.3 DOS naming convention when referring to these locations.