Cognos ReportNetTM Installation and Configuration Guide

Cognos ReportNetTM Installation and Configuration Guide Cognos ReportNetTM Installation and Configuration Guide

sharepoint.cabq.gov
from sharepoint.cabq.gov More from this publisher
20.07.2014 Views

Appendix A: Manually Configuring ReportNet 3. Add or modify the required element and attribute between the appropriate start and end tags. Type of Support Start Tag End Tag Language Content Locales Currency Product Locale Mapping Content Locale Mapping Fonts Tip: To remove support, delete the element. 4. Save and close the file. Tip: We recommend that use a validating XML editor to validate your changes against the rules in the crnstartup.xsd file, located in the crn_location/configuration. If you add a currency code that is not supported by Cognos, you must manually add it to the i18n_res.xml file in the crn_location/bin/ directory. Copy this file to each ReportNet computer in your installation. Run Cognos Configuration in Silent Mode Run Cognos Configuration in silent mode to apply the configuration settings on your computer if the console attached to your UNIX computer does not support a Java-based graphical user interface. Before you run the configuration tool in silent mode, you should use a validating XML editor to validate your changes against the rules in the crnstartup.xsd file, located in the crn_location/configuration. Steps 1. Ensure that the crnstartup.xml file in the crn_location/configuration directory on the local computer contains the property settings you want to use for your configuration. 2. Go to crn_location/bin. 3. Type the following configuration command ./crconfig.sh -s Tip: To view log messages that were generated files that were during an unattended configuration, see the crconfig_response.csv file in the crn_location/logs directory. Cognos Configuration applies the configuration settings specified in the local copy of crnstartup.xml, encrypts credentials, generates digital certificates, and if applicable, starts ReportNet service or process. 106 Cognos ReportNet TM

Appendix B: Troubleshooting Use this troubleshooting reference information and solutions as a resource to help you solve specific problems you may encounter during or after the installation of ReportNet components. Problems are characterized by their symptoms. Each symptom can be traced to one or more causes by using specific troubleshooting tools and techniques. After being identified, each problem can be fixed by implementing a series of actions. When you are troubleshooting, several files can help you: • The transfer log file This file records the activities that the installation wizard performed while transferring files. The transfer log file is located in the crn_location\instlog directory. The file name identifies the product name, version, and build number, and includes a time stamp. The following is an example of the file name format: tl-CRN-8-0-0-0-20021104_0942.txt • The transfer summary-error log file This file records the components you installed, disk space information, the selections you made in the transfer dialogs, and any errors the installation wizard encountered while transferring components. The transfer summary-error log file is located in the crn_location/instlog directory. The file name identifies the product name, version, and build number, and includes a time stamp. The following is an example of the file name format: tl-CRN-8-0-0-0-20021106_1122_summary-error.txt • The startup configuration file This file records your configuration choices each time you save your property settings. If you are unable to save your configuration, or are having problems you can revert to a previously saved configuration file. The backup configuration files are located in the crn_location/configuration directory. The following is an example of the file name format: crnstartup_200211231540.xml • The crnlocale.xml file This file records the configuration choices you make in Cognos Configuration for product and content locales, locale mapping, and currency support. If you experience problems with language support in the user interface or in reports, use these files to track your changes. The backup configuration files are located in the crn_location/configuration directory. The following is an example of the file name format: crnlocale_200211231540.xml • The default ReportNet log file named crnserver.log file, or other log files that you configure to receive log messages from the log server This file records information after you start the ReportNet service. Some log messages indicate problems. Most messages provide information only, but others can help you to diagnose problems in your run-time environment. • The cognos_uninst_log.htm file This file records the activities that the Uninstall wizard performed while uninstalling files. The log file is located in the Temp directory. You can use the log file to troubleshoot problems related to uninstalling ReportNet components. • The crconfig_response.csv file This file records the activities that Cognos Configuration performed while running in silent mode. This log file is located in the crn_location/logs directory. Another valuable troubleshooting tool is the Knowledge Base, which is available on the Cognos support site (http://suppport.cognos.com). The Knowledge Base is a database of problems and solutions for all Cognos products. Installation and Configuration Guide 107

Appendix A: Manually Configuring ReportNet<br />

3. Add or modify the required element <strong>and</strong> attribute between the appropriate start <strong>and</strong> end<br />

tags.<br />

Type of Support Start Tag End Tag<br />

Language <br />

Content Locales <br />

Currency <br />

Product Locale<br />

Mapping<br />

Content Locale<br />

Mapping<br />

<br />

<br />

<br />

<br />

Fonts <br />

Tip: To remove support, delete the element.<br />

4. Save <strong>and</strong> close the file.<br />

Tip: We recommend that use a validating XML editor to validate your changes against the rules<br />

in the crnstartup.xsd file, located in the crn_location/configuration.<br />

If you add a currency code that is not supported by <strong>Cognos</strong>, you must manually add it to the<br />

i18n_res.xml file in the crn_location/bin/ directory. Copy this file to each ReportNet computer in<br />

your installation.<br />

Run <strong>Cognos</strong> <strong>Configuration</strong> in Silent Mode<br />

Run <strong>Cognos</strong> <strong>Configuration</strong> in silent mode to apply the configuration settings on your computer if<br />

the console attached to your UNIX computer does not support a Java-based graphical user<br />

interface.<br />

Before you run the configuration tool in silent mode, you should use a validating XML editor to<br />

validate your changes against the rules in the crnstartup.xsd file, located in the<br />

crn_location/configuration.<br />

Steps<br />

1. Ensure that the crnstartup.xml file in the crn_location/configuration directory on the local<br />

computer contains the property settings you want to use for your configuration.<br />

2. Go to crn_location/bin.<br />

3. Type the following configuration comm<strong>and</strong><br />

./crconfig.sh -s<br />

Tip: To view log messages that were generated files that were during an unattended<br />

configuration, see the crconfig_response.csv file in the crn_location/logs directory.<br />

<strong>Cognos</strong> <strong>Configuration</strong> applies the configuration settings specified in the local copy of<br />

crnstartup.xml, encrypts credentials, generates digital certificates, <strong>and</strong> if applicable, starts<br />

ReportNet service or process.<br />

106 <strong>Cognos</strong> ReportNet TM

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!