Cognos ReportNetTM Installation and Configuration Guide

Chapter 7: Advanced Configuration Options
Configuring ReportNet to Use An Alternative Application
Server
Instead of using Tomcat, the default servlet container included with ReportNet, you can
configure ReportNet to use either a WebSphere or a WebLogic application server. This optional
configuration may be appropriate if you want to use an existing application server
implementation. It may provide greater flexibility for supporting additional applications.
Before you configure ReportNet to use an alternative application server, do the following:
❑ Install ReportNet and select the components that will run on each computer.
❑ If required, the Oracle and DB2 clients must be installed and set up prior to running
ReportNet. The appropriate environment variables must be set prior to starting the
application server.
For information about setting up the database client on UNIX, see "Set Up the Database
Client for the Content Store Database" (p. 23), or on Windows, see "Set Up the Database
Client for the Content Store Database" (p. 30).
❑ Install the application server or identify an existing application server that you can use for
ReportNet.
❑ If you have WebLogic 6.1 SP4 or WebLogic 7.0 SP2, add the chunking patch to the
WebLogic installation.
• For WebLogic 6.1 SP4, add CR102751_61sp4.jar to WebLogic_location
/wlserver6.1/lib, or upgrade to SP5.
• For WebLogic 7.0 SP2, add CR100172_70sp2.jar to
WebLogic_location/weblogic700/common/lib.
This patch corrects a servlet container issue where HTTP chunked requests are not
handled properly.
Tip: To obtain the required chunking patch for the servlet container issue, contact BEA
support.
❑ On UNIX, to avoid file permission conflicts, create a new UNIX group. You could call this
group reportnet. This group must contain the user that starts WebSphere or WebLogic and
the user that owns the ReportNet files. Change the group ownership of the ReportNet files
to the reportnet group and change the file permissions for all ReportNet files to GROUP
READABLE/WRITABLE/EXECUTABLE.
❑ If ReportNet was previously configured to use Tomcat, you must complete additional steps
to prepare the ReportNet installation (p. 86).
Configure ReportNet to Use a WebSphere Application Server
You can use a WebSphere application server instead of Tomcat, the default. The following steps
are based on a default WebSphere installation. You can also configure a customized
environment (p. 81).
Steps
1. If ReportNet was previously configured to use Tomcat, you must stop the ReportNet service
and then delete the cryptographic keys (p. 86).
2. On each computer that includes ReportNet and WebSphere, from the
crn_location/bi/jre1.3.1/lib/ext directory, copy the contents of the ext directory to
WebSphere_location/java/jre/lib/ext.
Important: Some or all of the jar files may already exist in the WebSphere ext directory. If
so, do not overwrite the WebSphere versions of the files.
78 Cognos ReportNet TM