IBM Support

How to configure IBM Cognos Controller to use the 'Cognos Controller Embedded Report Library' (IBM Cognos Controller Reports) standard report engine (via "ccrReports")

How To


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")?


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:
image 2276
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:
image 2302


IBM Cognos Controller 10.4.2 (or later).


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
image 2277
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="" />
For example:
image 2301
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:
image 11017
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'

Document Location


[{"Business Unit":{"code":"BU053","label":"Cloud \u0026 Data Platform"},"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"}}]

Document Information

Modified date:
23 July 2021