20.07.2014 Views

Cognos ReportNetTM Installation and Configuration Guide

Cognos ReportNetTM Installation and Configuration Guide

Cognos ReportNetTM Installation and Configuration Guide

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Appendix B: Troubleshooting<br />

DPR-ERR-2022 <strong>and</strong> DPR-ERR-2058 Errors Appear in Web<br />

Browser When Starting the Web Portal<br />

After you start the services in <strong>Cognos</strong> <strong>Configuration</strong> <strong>and</strong> then try to open the portal, one of the<br />

following or similar messages may appear:<br />

DPR-ERR-2022 No response generated. This may be due to an incorrect configuration, a<br />

damaged installation, or the dispatcher not having finished initializing.<br />

DPR-ERR-2058 The dispatcher encountered an error while servicing a request. XTS h<strong>and</strong>ler<br />

must be initialized before being invoked.<br />

DPR-ERR-2058 The dispatcher cannot service the request at this time. The dispatcher is<br />

still initializing.<br />

This can occur if you try to open the portal before the ReportNet services are initialized.<br />

You can avoid these error messages. After you start the services in <strong>Cognos</strong> <strong>Configuration</strong> <strong>and</strong><br />

the configuration tool shows that the services are running, wait a few minutes for all services to<br />

start before you open the portal.<br />

Report Link in Email Notification Does Not Work<br />

If a report link in an email notification does not work, the Gateway URI may not be configured<br />

correctly.<br />

You must change the host name portion of the Gateway URI from localhost to either the IP<br />

address of the computer or the computer name. If the URL in the email contains localhost,<br />

remote users cannot open the report.<br />

Unable to Uninstall Another Version of ReportNet Service<br />

on Windows<br />

You install ReportNet, but another version of the ReportNet service continues to run.<br />

You can install more than one instance of ReportNet in different locations on the same<br />

computer. If the instances use the same ports, the <strong>Installation</strong> wizard may not upgrade the<br />

service correctly. <strong>Cognos</strong> <strong>Configuration</strong> upgrades to the most recently configured service for<br />

ReportNet. You must manually remove the service.<br />

To see if the correct ReportNet service is running, check the version number in the About<br />

window in <strong>Cognos</strong> <strong>Configuration</strong>.<br />

Steps<br />

1. Start <strong>Cognos</strong> <strong>Configuration</strong>.<br />

2. From the Action menu, click Stop.<br />

3. Open a Comm<strong>and</strong> Prompt window.<br />

4. Go to the crn_location/bin directory.<br />

5. Uninstall the service:<br />

• If you used the default name for the service, type<br />

cogbootstrapservice -u<br />

• If you specified another name, type<br />

cogbootstrapservice -u -name="crn_service_name"<br />

6. Close the Comm<strong>and</strong> Prompt window.<br />

7. Restart <strong>Cognos</strong> <strong>Configuration</strong> to upgrade to the correct service.<br />

114 <strong>Cognos</strong> ReportNet TM

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

Saved successfully!

Ooh no, something went wrong!