Cognos ReportNetTM Installation and Configuration Guide

Chapter 7: Advanced Configuration Options
Preparing Your Environment If ReportNet Previously Used Tomcat
If you previously configured ReportNet to run in your environment using Tomcat, the default
servlet container, and now plan to use WebSphere or WebLogic, you must:
❑ stop the Cognos ReportNet service
❑ delete any existing cryptographic keys before you configure the alternative application
server
❑ unregister dispatchers that are no longer used after you configure ReportNet to run on
WebSphere or WebLogic
Delete Cryptographic Keys
Before you configure ReportNet to use a third-party application server, ensure that any
cryptographic keys that were previously created are deleted. This ensures that the correct
security and Java environment is used.
Remove Dispatchers
Steps
1. Stop the Cognos ReportNet service using Cognos Configuration.
2. Save and close Cognos Configuration.
3. Back up the contents of the following directories:
• crn_location/configuration/csk
• crn_location/configuration/encryptkeypair
• crn_location/configuration/signkeypair
4. Ensure that the startup configuration does not contain encrypted passwords:
• If timestamped versions of the crnstartup.xml files are available in the
crn_location/configuration directory, rename the crnstartup_timestamp.xml file with the
earliest timestamp to crnstartup.xml.
Note: To allow you to undo some configuration changes, ReportNet creates a
timestamped version of crnstartup.xml before applying any changes to the file. The file
with the earliest timestamp should be the original version of the file and does not
contain encrypted passwords.
• If the timestamped versions of the files are not available, in Cognos Configuration,
re-enter the passwords for the following resources or components, if they exist: Content
Manager database, the Notification database, the Notification mail server, log database,
and your LDAP authentication source.
5. Delete the csk, encryptkeypair, and signkeypair directories.
After you start the application server, remove ReportNet services that have been previously
registered and that are no longer used.
To access the server administration tool, you must have execute permissions for the
Administration secured function.
Steps
1. Open the ReportNet portal.
2. On the portal toolbar, click Server Administration.
3. Click the Monitor tab.
4. Under Type, click Dispatchers.
A list of dispatchers appears.
5. Select the check box for the dispatcher you want to unregister and, on the toolbar, click the
unregister button.
Tip: You can also unregister dispatchers by clicking More in the Actions column.
A message confirms the action.
6. Click OK.
86 Cognos ReportNet TM