How To
Summary
From version 10.4.2 onwards, IBM Cognos Controller has a new feature which allows customers to render standard reports via the new 'Embedded Report Library' engine.
This means that they no longer need to install/configure/use Cognos Analytics (CA) for standard reports.
- However, many customers may still want to use CA for other functionality such as Cognos/CAM authentication.
How can a customer reconfigure IBM Cognos Controller to use the new standard report engine ("Embedded Report Library")?
Objective
Historically, Controller's "Standard Reports" have been rendered by the Cognos Analytics (or BI) functionality called 'Cognos Viewer'.
- Therefore, when a standard report is run, it appears in a window similar to this:
From Controller 10.4.2 onwards, customers can choose to still use the same/old method (above), where reports are rendered in CA.
- Alternatively they can optionally choose to use the new 'Embedded Report Library' functionality, so the reports will appear like this:
Environment
IBM Cognos Controller 10.4.2 (or later).
Steps
The following steps assume using a single all-in-one application server, running IBM Cognos Controller 10.4.2, installed to the default location, using the default TCP ports:
1. Make sure that the Windows service 'IBM Cognos Controller Reports' has already been successfully installed
2. Browse to the folder: C:\Program Files\IBM\cognos\ccr_64\ControllerProxyServer
3. As a precaution, create a backup copy of web.config
4. Open the file web.config inside notepad
5. Search for the entry: <appSettings>
6. Underneath that line, add an entry similar to:
<add key="ccrReports" value="http://myservername.mycompany.com:9082/fcm.reports/report" />
For example:
7. Save changes
8. Browse to the folder: C:\Program Files\ibm\cognos\ccr_64\fcmweb\wlp\etc\
9. As a precaution, create a backup copy of server.env
10. Open the file server.env inside notepad
11. Add the following line and save changes. The default location for Java home is: C:/Program Files/IBM/cognos/ccr_64/fcmweb/jre
JAVA_HOME=C:/Program Files/IBM/cognos/ccr_64/fcmweb/jre
For example:
12. Make sure that the Windows service 'IBM Cognos Controller Reports' is re-started
NOTE: If you did not install Cognos Analytics because your are NOT using it as an authentication source in addition to not using it as a Report Server, please skip steps 13 through 17 and go directly to step 18.
13. Launch ‘controller configuration’
14. Open section ‘Report Server’
15. Modify the value of ‘Report server’ from the default (http://localhost/ibmcognos/cgi-bin/cognos.cgi) to use the real name of the Server, for example: http://myservername/ibmcognos/cgi-bin/cognos.cgi
16. Modify the value of ‘Dispatcher URI’ from the default (http://localhost:9300/p2pd/servlet/dispatch) to use the real name of the Server: http://myservername:9300/p2pd/servlet/dispatch
17. Save changes.
18. Test the IBM Cognos Controller 'Embedded Report Library'
For example, the simplest report to run is:
- Click "Maintain - Rights - Reports"
- Tick the option "Single User" and choose the user ID 'ADM'
- Click 'Preview'
Related Information
Document Location
Worldwide
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"Component":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.4.2","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]
Was this topic helpful?
Document Information
Modified date:
23 July 2021
UID
ibm11489047