Cognos ReportNetTM Installation and Configuration Guide

Appendix A: Manually Configuring ReportNet
The console attached to the UNIX computer on which you are installing ReportNet may not
support a Java-based graphical user interface. You must
❑ manually change default configuration settings by editing the crnstartup.xml file, located in
the crn_location/configuration directory
❑ manually change language or currency support, or locale mapping by editing the
crnlocale.xml file, located in the crn_location/configuration directory
❑ apply the configuration and the locale settings to your computer by running Cognos
Configuration in silent mode
For all installations, some configuration tasks are required so that ReportNet works in your
environment. If you distribute ReportNet components across several computers, the order in
which you configure and start the computers is important.
Other configuration tasks are optional and depend on your reporting environment. You can
change the default behavior of ReportNet by editing the crnstartup.xml file to change property
values. You can also use sample files that enable ReportNet to use resources that already exist
in your environment.
Manually Change Default Configuration Settings
If the console attached to your UNIX computer does not support a Java-based graphical user
interface, you must edit the crnstartup.xml to configure ReportNet to work in your reporting
environment.
Before you edit the crnstartup.xml file, ensure that you
• make a backup copy
• create the content store on an available computer in your network (p. 19)
• review the configuration requirements for your installation type (p. 33)
If you want ReportNet to use a resource, such as an authentication provider that already exists
in your environment, you can add a component to your configuration. You do this by copying the
required XML code from the sample files into the crnstartup.xml file and then edit the values to
suit your environment.
Important: By default, the crnstartup.xml file is encoded using UTF-8. When you save the
crnstartup.xml file, ensure that you change the encoding of your user locale to match the
encoding used. The encoding of your user locale is set by your environment variables.
When you edit the crnstartup.xml file, remember that XML is case-sensitive. Case is important
in all uses of text, including element and attribute labels, elements and values.
Steps
1. Go to the crn_location/configuration directory.
2. Open the crnstartup.xml file in an editor.
3. Find the configuration setting you want to change by looking at the help and description
comments that appear before the start tag of the elements.
4. Change the value of the element to suit your environment.
Tip: Use the type attribute to help you determine the data type for the configuration
property.
5. Repeat steps 3 to 4 until the configuration values are appropriate your environment
6. Save and close the file
Installation and Configuration Guide 103