Cognos Controller 8.5.1
Microsoft Windows 2008 R2 server

When you start the Cognos Controller client from the link in Cognos Connection you get a error message.

Error message:
System.NullreferenceException: Object reference not set to an instance of an object.
at Cognos.Controller.AppContext.InitConfig()

Possible Solution:
Logon to the Cognos Controller server as administrator

Open folder C:\Windows\System32\inetsrv\config
Open file “ApplicationHost.config”
Click Save

Restart the IIS server and test again

Cognos Controller 10.1 (32 bit)
Microsoft Windows 2008 R2 (64 bit)
Microsoft Excel 2010 (32 bit)

Get error message when you start excel from inside Cognos Controller 10 client on the server.
Cognos Controller is installed on a Microsoft Windows 2008 R2 server, and you test the Controller client by starting ccr.exe from the D:\Program Files (x86)\ibm\cognos\c10\webcontent\ccr folder.

Error message:
IBM Cognos Controller Link
Exception has been thrown by the target of an invocation.

Possible Cause:
Excel reads from the ccr.exe.config file to find the way to the Cognos Controller files.
The file will have this row if it is not working:

File ccr.exe.config, that excel is using, is found in folder C:\Users\username\AppData\Roaming\Cognos\ccr

If changed to this it will work

Instead of test Cognos Controller by starting the ccr.exe direct, you should install Cognos Controller client on the server.

Ensure you have Microsoft Excel installed on the server
Ensure you have Adobe Reader installed on the server
Ensure you have Net framework 3.5 installed on the server
Ensure you have User Account Control Settings to lowest value

Copy the excel.exe.config file to the same folder as excel.exe
Run a batch file to set trust to the controller server in net framework 2.00
Ensure that the controller server name is in trusted zone in Internet Explorer on the server.

Run CCRLocalClient.msi from folder D:\Program Files (x86)\ibm\cognos\c10\webcontent\ccr
to install the client.

Select Typical and enter the following for the WSSUrl

Enter the following for the HelpUrl

Leave “CacheDir” blank and press next.

After installation, you start Cognos Controller Client from the Start menu.

Replace servername above with your name of your Cognos Controller server.
More information about how to install the Controller client can be found here:

Cognos Controller 8.5.1
Windows 2008 Server R2

When you run F9 in excel report you get a error message during the “Calling RunReport” process. You have activated Enhanced report optimization by doing this in the excel sheet:
1. Select cell A1 on the first sheet of the workbook.
2. Go to the menu Insert / Name / Define
3. Type in the name Optimise2 and click Add and then OK
4. Save the report
When you next run or refresh the report, ERO is used.

Error message:
Standard Error
Number: 5
FrangoDirect. ExcelLinkD. FetchValuesBulk # ControllerProxyClient
Description: The underlying connection was closed. An unexpected error occurred on a receive.

You have create the share \\servername\ero$ on the application server and given everyone full rights on the share.

You have enter the correct values in controller configuration for ERO, as this:
File mode: File Copy
Server: applicationservername
Share: ero$
(and left the rest of the fields blank)

But you have not given the SQL service account access rights to the NTFS.

Right click on the ERO folder
Select Properties
Select Security tab
Click EDIT to change permissions
Click ADD
enter the name of the service account (e.g. domain\username) and click CHECK NAMES
Click OK
Mark Allow – Modify check box
Click OK

Cognos Controller version 8.5.1

The Enhanced Reporting Optimization (ERO) does not work anymore, but it has before upgrade to new version of Cognos Controller.

Can be that you have changed the name of the controller database from Default to default.

The settings for ERO are stored in the Windows Registry on the Controller Application Server.
Under a registry key for each database name, defined in Controller Configuration.
When you create new database – you must remember to setup the ERO values for the new database.

Start Regedit on the Cognos Controller server
Ensure that the values under ey;
[HKEY_LOCAL_MACHINE\SOFTWARE\VB and VBA Program Settings\FrangoController\Shares\default]

Are correct for ;

Check that each key for each database are correct.

Cognos Controller 8.5.1 service pack

After upgrade to a new version of Cognos Controller you get a error when you run Database Conversion Utility to upgrade the database to the latest version.

You get message:
Current dbversion.txt missing – unable to proceed with conversion.

Ensure that the DBCONV.EXE program is in the C8 folder, where the needed support files are located.

Copy the DBCONV.EXE program to the C8 folder – if it is not located in this folder.

A reinstall of Cognos Controller would also place the files in correct folders.

Cognos Controller 10.1
Microsoft Windows 2008 R2 server

When try to convert a older cognos controller database, you get a error when you run the DbConv program from the folder D:\Program Files (x86)\ibm\cognos\c10\legacy.

Error Message:
DbConv Error
ERROR 429 (Hex 1AD):
ActiveX component can’t create object

Database Upgrade is aborted due to error in processing Step 755.
Error – 429 ActiveX component can’t create object
Current DB Version is 754

During the install of Cognos Controller 10.1 on the Microsoft Windows 2008 R2 server some files was not correct registered.


1. Logon to the Controller application server as an administrator
2. Launch Windows Explorer, and navigate to the folder: C:\Windows\SysWOW64\common
3. Right-click on the file “Xceedzip.dll” and choose “properties”. Check the file size. It should be approximately 278 KB. If it is 0 Kb then the file is corrupt and will need to be replaced.
4. Navigate to the folder: \Common (this can be: D:\Program Files (x86)\ibm\cognos\c10\common)
5. Right-click on the file “FrCrypto.dll” and choose “properties”. Check the file size. It should be approximately 29 KB. If it is 0 Kb then the file is corrupt and will need to be replaced.
6. Launch a command prompt by clicking “Start” – “Run” and then typing in “CMD”
7. Change directory using: cd C:\Windows\SysWOW64\common
8. Register the file using: regsvr32.exe xceedzip.dll
9. Change directory to the c8\common folder (for example using: cd “D:\Program Files (x86)\ibm\cognos\c10\common”)
10. Register the file using: regsvr32.exe FrCrypto.dll

Cognos Controller 10.1
Microsoft Windows 2008 R2

Open Cognos Controller Configuration hang when you select the Report Server section.
In some cases you get a error message.
You can only kill the Controller Configuration program from Windows Task Manager, and when you go into Controller Configuration again it will hang.

Error message:
File Download
Do you want to save this file, or find a program online to open it?
Name: cognosisapi.xts&h_CAM_action=logon
Type: Unknown File Type, 252KB
From: servername

You have changed the Controller Configuration to use cognosisapi.dll but not changed on the Windows 2008 iis to handle isapi for cognos controller. You need to change the IIS settings before you change in Controller Configuration.

Can also happens when you enter a none valid Report Server URL in Controller Configuration.

1) In IIS select the server node, then double-click ISAPI and CGI Restrictions in the right pane, Under Actions on the right hand screen select Edit Feature Settings and make sure Allow unspecified ISAPI modules is selected.
In the Left Connection pane select the cgi-bin virtual directory, then double-click Handler Mappings in the right pane.
In the Actions pane click Add Module Mapping, the settings should be similar to:

Request path: cognosisapi.dll
Module: IsapiModule
Executable (optional): C:\Program Files (x86)\ibm\cognos\c10\cgi-bin\cognosisapi.dll
Name: ISAPI-cognos

Click OK and Yes to allow this ISAPI extension

2) If running 64-bit In iis under Application Pools, select your application pool for the ibmcognos virtual directories i.e. DefaultAppPool, on the right-hand side click Set Application Pool Defaults and change Enable 32-Bit Applications to True

3) Edit the file /c10/cgi-bin/web.config and add:
to the following entry:

To become:

4) Restart iis

5) In Cognos Configuration under Environment change Gateway URI to reference cognosisapi.dll instead

(Leave Cognos Configuration open for the moment)

In the /webcontent directory, edit the index.htm and default.htm files and change

In Cognos Configuration save you settings and restart the services.

6) In Controller Configuration under Report server change Report server to cognosisapi.dll instead of cognos.cgi

When the user surf to http://servername/ibmcognos, will cognosisapi.dll be used as default.

Cognos Controller 10.1
Microsoft Windows 2008 R2

When starting Cognos Controller client, it will hang and not show up.

This happens on a client computer (citrix server) that run a 64 bit operation system.

Possible error:
Microsoft IE Execute shell
Microsoft IE Execute shell has encountered a problem and needs to close.
We are sorry for the inconvenience.

Cognos Controller is a 32 bit application, and will not execute in a 64 bit Internet Explorer.

Possible Solution:
Set the Client computer (citrix server) to process all NET framework code as 32 bit.

start cmd by select “run as administrator” from start menu on client computer.
go to c: drive
change to folder with command: cd %windir%\Microsoft.NET\Framework64\v2.0.50727
Enter command: Ldr64.exe setwow

More information:
On Windows 2008 R2 server when running Controller Configuration, you must right click the program and select Run as Administrator.

Ensure that the client have trust to the Cognos Controller server.
Check by running CASPOL -LG from the Microsoft.NET\Framework\v2.0.50727 folder on the client. This will list the servers that the NET framework client trust.

When you run the caspol command, you must start the command prompt/bat file by right clicking the program and selecting Run as Administrator.

start cmd run as administrator
cd C:\%windir%\Microsoft.NET\Framework\v2.0.50727
caspol -q -m -ag “All_Code” -url http:// SERVERNAME /* FullTrust -name “Controller_ SERVERNAME ” -d “Controller_ SERVERNAME ”

(replace SERVERNAME with the name of your server NetBios or FQDN depending what you have setup)
Run the CASPOL command once for FQDN and once for the NetBios Servername to ensure the clients access to the server.

Cognos Controller 10.1
Microsoft Windows 2008 R2

The Cognos Controller client freeze (hang) after you have selected the database to use. The login dialog is not showing up. There are no error messages in windows event log.

If you run Controller Client direct on the Controller Application server – it works fine.
But from all client computers the Controller Client will hang.

When Cognos Controller client start it will contact Cognos connection to check if it is there, even if you use native controller security. When report server setting is http://localhost/ibmcognos/cgi-bin/cognosisapi.dll , this will not work – Cognos connection can not be found on the local client.

You can sometimes get a Internet Explorer 404 error in Controller before the login dialog.

After you have applied the Cognos Controller hot fix, the settings in Controller configuration is reverted back to default values. Therefore the Report server value is localhost and not the server name.

Open Controller Configuration on your Controller server.
Go to the Report Server tab.
Change the url from localhost to the servername

Report server should be:

Dispatcher URI should be:

(change srv001 to your server name)

Click save and close.
Test again.

Cognos Controller 10.1
Microsoft Windows 2008 server

How automatic set the background picture in Cognos controller for all clients on a Citrix server?

Inside Cognos Controller client, you can define a BMP file to be used as background picture.
Recommended is to have a different background picture for your test environment.
To make Controller Client color different from the productions clients.

In Cognos Controller client go to
Maintain – Installation – Local Preferences
Here you can enter the key app_background
And a value that points to a local BMP file.

Local Preferences values are stored in the ccr.config file for each user in there windows profile.
You need to populate this file for each user when they logon to the Terminal Server.

On citrix server create a folder called d:\script
On citrix server create a BMP file and save it as c:\windows\background.bmp
On citrix server download AUTOIT3:EXE from
And place it in folder d:\script

Create a text file in folder d:\script named replaceccr.au3 with this content:

$TextFileName = @UserProfileDir & “\AppData\Roaming\Cognos\ccr\ccr.config”

$FindText = “”
$ReplaceText = ‘ ‘

$FileContents = FileRead($TextFileName)
$Check = StringInStr( $FileContents, “” )

if $Check = 0 Then

$FileContents = StringReplace($FileContents,$FindText,$ReplaceText)


Create a text file in folder d:\script named updateccr.cmd with this content:
d:\script\autoit3.exe d:\script\replaceccr.au3

In folder d:\script these files should now be:
Autoit3.exe = used to process au3 script files
Replaceccr.au3 = will check the users ccr.config file and add the “app_background” if it does not already have a “LocalPref” value.
Updateccr.cmd = file to run to active the script

You may then add the updateccr.cmd file to your C:\Windows\System32\usrlogon.cmd, to make it run when anyone logon to the Windows Server.

More information about Terminal Server logon script

More information about Autoit3: