Product:
Cognos Planning 10.1.1
Windows 2008 R2 server

Symptom:
Error message when starting up Cognos Analyst or Cognos Planning Administration Console.

Error message:
An error has occured while starting IBM Cognos Planning – Administrator.

Main form failed to initialize.

Error Details:
Could not logon. Please ensure you can access Cognos Connection using the Gateway URI specified in Cognos Configuration.

Possible Solution:

Change to not use FQDN in Cognos Configuration, and use only server name in environment tab.
(above will work if you are on the Cognos Planning server itself)

Change from http://servername.domain.org:80/ibmcognos to http://servername:80/ibmcognos
in cognos configuration on all existing places.

or add the Cognos URL FQDN to your Internet Explorer local intranet zone.

select internet options
select security
select local intranet
click on sites
click on advanced
enter the web site e.g. http://servername.domain.org/ibmcognos
click add
click close
click OK
click OK

Close Internet Explorer and test again to login.

Product:

Cognos Planning 10.1.1

Windows 2008 R2 server

Symptom:

Error when starting the Cognos Planning Analyst on a 64 bit server.

Cognos Planning Analyst only works for the account that was used during installation.

Error Message:

A Fatal Error has occured in the startup section of the application.

The application will be terminated.

 

Please report the following information:

Function name: SystemIniGet

Namespace: #._US

=============================

RegOpenKeyA returned a nonzero error code

SystemIniGet[10]Hkey,,0 MyOpenKey Key

 

Solution:

You need to update the current users registry with some values.

 

In notepad you need to create two text files with similar content as below:

—————–File 1—————————————————-

Windows Registry Editor Version 5.00

 

[HKEY_CURRENT_USER\Software\Cognos]

“Analyst”=”d:\\cognos\\c10\\bin\\”

 

—————–File 2—————————————————–

Windows Registry Editor Version 5.00

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101]

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst]

“-“=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\Analysthelp]

@=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\AnalystMessageLibs]

@=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\BX]

@=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\Compatibility]

@=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\CP]

“CubeStackBytes”=”1024”

“DataMacros”=”0”

“EditMacros”=”0”

“MaxTranscriptBytes”=”400”

“MaxViewCells”=”10”

“NotEnoughMemFlag”=”Yes”

“StackBytes”=”1024″

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\Custom]

@=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\Main]

“DefaultUser”=”Admin”

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\MRU]

@=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\Settings]

“LastLib”=”0”

“Position”=”23 0”

“Size”=”840 1260”

“State”=”Maximised”

“Language”=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Analyst\StartUp]

@=””

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Contributor]

 

[HKEY_CURRENT_USER\Software\IBM\Cognos\Planning101\Contributor\Settings]

“Language”=””

——————————————————————————

Name the files with REG endings and then you can click on them to install the values.

 

At below site you have complete instructions on how to do it:

https://www-304.ibm.com/support/docview.wss?mynp=OCSSPN2D&mync=R&uid=swg21472649&myns=swgimgmt

 

(Only edit the Windows registry if you know what you are doing.)

Product:
Cognos Controller 10.1.405
Windows 2008 R2 server

Symptom:
Consolidation in Cognos controller does not work after update.
If you look in the help – system info dialog inside Cognos controller client you see version number:

IBM Cognos Controller version: 10.1.405
Integration version: 0.0.0

Cause:
When integration version is showing zeros, then some part of the Cognos Controller has not been installed correct.
Correct value for integration version should be: 10.1.416.

Possible Solution:
On the Cognos Controller Windows server:
Launch a command prompt by clicking “Start” – “Run” and then typing in “CMD”
Change directory using: cd C:\Windows\SysWOW64\common
Here is the file xceedzip, that maybe is not correct installed.
Register the file using: regsvr32.exe xceedzip.dll

Restart then the server.

Cognos Controller client version must be the same as the Cognos Controller version installed on the Application server.

More Information:
http://www-01.ibm.com/support/docview.wss?uid=swg21347488

http://www-01.ibm.com/support/docview.wss?uid=swg21394477

If you still have problems, remove the frangovfp com+ components and add them again.

Product:
Cognos Controller 10.1.405
Tm1 9.5.2
Windows 2008 R2 server

Symptom:
When doing a initial publish in Financial Analytics Publisher you get a error message that it can not login to the TM1 server cube.
This happen after you have upgrade Cognos Controller with a Fix Pack.

Error Message:
FAP Service Scheduler CRITICAL
Could not login to TM1, host: sr01639, server name: tm1fap, user name: AD\username

If you keep the mouse over the error message you will see this message:
com/cognos/ccf/c8itk/ITKProxyJNI.jnIsLoggedOn(J)Z

Cause:
When using Cognos Controller with Cognos BI CAM security to TM1 version 9.5.2 you need to use the correct c8itk4j.jar file.

Solution:
Stop the Cognos FAP service.
Go to folder D:\Program Files (x86)\ibm\cognos\c10\server\FAP\lib
Rename the file c8itk4j.jar to c8itk4j.jar.old
Copy the c8itk4j.jar file from folder D:\Program Files (x86)\ibm\cognos\c10\server\FAP\lib\TM1_9.5_CAM_compatibility
You should now have c8itk4j.jar filesize to be 22 KB.
Start the Cognos FAP service.

Go the the datamarts tab in Financial Analytic s Publisher and click start to test again.

Product:
Cognos Controller 8.5.1532 FAP
Windows 2008
Cognos TM1 9.5.2

Symptom:
During IP for Controller FAP you get a error message that the FAP service can not login to the TM1 application. When you change client id and restart the FAP service, you get not error message, the FAP service is only hanging.
If you reboot the physical server, the FAP service will try to login once, and then fail.
There are no “fatalerror.log” in the FAP service folder on the server.

Background:
You have changed to use CAM ID and SSO to access Cognos Controller.
The servers and the users are in different Windows domains with trust between.

Error message:
Severity: CRITICAL
Description: Could not login to TM1, host: SERVERNAME, server name: TM1 SERVER NAME, user name: admin

If you hold the mouse over the error message in FAP manager, you see the text:
SystemServerNotFound

Cause:
The windows account that run the IBM Cognos Controller FAP server must be a domain account in the same domain that the Cognos BI server authenticate against. You must be able to surf to http://servername/cognos8 from the server logged in as the service account, and SSO should work.

Solution:
Create a new windows service account in the domain that contains the users
Make that new windows service account local admin on the FAP server
Change the windows account that start the FAP service, to use the new service account.

You may need to enter the account with domain\name in the field for name to the FAP service to make it possible for the FAP service to use the account.

Start FAP service again and test if the FAP publish works now.

In FAP Manager for the connection edit, ensure you enter the client name and domain in same capital letters as used for the namespace id in cognos configuration. If the namespace ID is AD then you need to enter AD\username in the FAP manager for the TM1 connection.

Product:

Cognos BI 10.1.1

Symptom:

How do I change the Logo in Cognos Connection to be my company ?

Solution:

Download the company logo as a small GIF file.

In our example we call the company NIPPON, so save the gif file as NIPPON_logo.gif.

Go to your Cognos Gateway server, copy the folder \program files\ibm\cognos\c10_64\webcontent\skins\corporate and content to folder \program files\ibm\cognos\c10_64\webcontent\skins\NIPPON folder.

 

Place the NIPPON_logo.gif file in folder \program files\ibm\cognos\c10_64\webcontent\skins\NIPPON\branding.

 

Surf to your Cognos Connection.

Launch Cognos Administration.

Select Configuration tab.

Click on Styles (on the left side).

Click on the New Style icon (on the top right side).

Enter NIPPON as name and click next.

Enter NIPPON as Style resources location and click Finish.

 

Now you have your company NIPPON in the list of styles.

Click on icon for My area options (on the top right side).

Select My Preferences

From the drop down menu at Styles select your company NIPPON.

Click OK.

Click on HOME icon.

 

You account in Cognos Connection are now using the new style NIPPON.

But it look the same as corporate – because we have not changed anything.

 

Go to your Cognos BI report server.

Go to folder c:\program files\ibm\cognos\c10_64\templates\ps\portal

Make a backup copy of the file system.xml, name it system_org.xml.

Open your system.xml file in notepad.

Search for param name=”OEM”

 

………………………Below from original system.xml…………………….

 

<!– Custom OEM headers –>
<param name=”OEM”>
<!–
Specify custom Cognos Connection / Cognos Viewer left side header here in the form of XHTML snippets. Custom headers can be style-specific.
Example:
<customHeader showContext=”true” contextDelimiter=” – “>
<style styleFolderName=”corporate”>
<table style=”background-color:#ffffff”>
<tr>
<td><img src=”../skins/corporate/branding/my_logo.gif”/></td>
<td class=”headerTitle” style=”padding-right:2px;white-space:nowrap”> My company </td>
</tr>
</table>
</style>
<style styleFolderName=”classic”>
<table style=”background-color:#cccccc”>
<tr>
<td><img src=”../skins/classic/branding/my_logo.gif”/></td>
<td class=”headerTitle” style=”padding-right:2px;white-space:nowrap”> My company </td>
</tr>
</table>
</style>
</customHeader>

–>

</param>

……………………………………………………………………………..

Change above text to below instead;

<!– Custom OEM headers –>
<param name=”OEM”>
<customHeader showContext=”true” contextDelimiter=” – “>
<style styleFolderName=”NIPPON”>

<table style=”background-color:#fffff”>

<tr>

<td><img src=”../skins/NIPPON/branding/NIPPON_logo.gif”/></td>

<td class=”headerTitle” style=”padding-right:2px;white-space:nowrap”></td>

</tr>

</table>

</style>

 

</customHeader>

 

</param>

 

Save system.xml file in folder \program files\ibm\cognos\c10_64\templates\ps\portal\

Restart the IBM Cognos windows service on the Cognos BI report server.

 

Surf to Cognos Connection.

Go to my folders.

You should have the NIPPON logo in the top left corner.

Product:
Cognos BI 10.1.1
Windows 2008 R2

Symptom:
When you go to the administration dialog in Cognos Connection you get a error message.

Error message:
DPR-ERR-2088
The requested Server Group ” does not exist

Possible Cause:
One of the BI servers in the server group does not have all correct service set to true.
Check that the following IBM Cognos service are active:
Delivery service enabled
Event Management enabled
Presentation service enabled

Solution:
Open cognos configuration on the Cognos BI server
Check the cognos service – component properties
Set all component properties to true.
Save the configuration
Start the service
Surf to cognos connection
Remove the server group name from the BI dispatchers

Product:
Cognos BI 10.1.1

Problem:
How to move security settings from dev to prod environments ?

Cause:
If you export a deployment package with only directory content “include Cognos groups and roles” and set to “replace existing entries”.
Access permissions are set to “include access permissions” and “apply to new and existing entries”
External namespaces are set to “include references to external namespaces”.
Then only User, Groups and Roles are moved in that package.
Settings for Capabilities and User Interface Profiles are not moved in that package.

If a user or groups does not exist in the new environments LDAP, then that user or group is removed from the Cognos group. It does not show up.

So you can move all user and groups settings between environments to update groups and rolls security, and this will remove any previous users in the Cognos groups. You must exist Cognos Connection and login in again to see the updates of security, after you have imported the security package.

Remember to unselect the “include data sources and connections” in your deployment or you may lose your connections with the data sources.

Solution:
You need to deploy the whole content store with users to get the Capabilities and User Interface Profiles settings to come over to the new environment.

In Cognos BI 10.1.1 the folder System Administrators are merged, so any users or groups in that folder are not removed. Hopefully this save you from locking your out of the Cognos system by mistake.

This move is only recommended to do once, because it overwrites all reports and data sources.

If you want some other way of handle update of security in Cognos BI, it is recommended to create your own program with help of the Cognos SDK.

http://www-01.ibm.com/support/docview.wss?uid=swg21335446

Product:

Cognos BI 10.1.1

Cognos TM1 9.5.2

Windows 2008 R2 Server

Symptom:

Some Cognos BI reports have stopped to work. They worked fine last month.

They give strange error about WebSphere, but this a Windows installation with default Cognos BI built-in tomcat engine.

Error Message:

CCL-BIT-0006

The connection closed before the request is processed. If you are using WebSphere Application Server, to reduce the frequency of this error, increase the Persistent Timeout parameter for the Web container transport chains in the administrative console. Increase the time in 10-15 second intervals until the error no longer or rarely occurs

 

Cause:

The error message is because the report process timeouts, but this can be of different issues.

In this case it is the TM1 application who disconnect the reports users process direct at start of the report.

If you time with a stop watch from you press RUN in the report after the prompt page, until the error message. If that is exactly 60 seconds, then it is Cognos BI that have time out.

 

You need to investigate further to find why the report does not work.

If the report is getting data from a TM1 cube, run the TM1TOP utility to that cube and monitor what happens when the report is run.

If you want to change the timeout value in Cognos BI – do this:

  1. Navigate to the <IBMCOGNOS home>/tomcat/conf directory
    2. Open server.xml
    3. Locate the following entry:

<!– Define a non-SSL Coyote HTTP/1.1 Connector on port 8080 –>
<Connector className=”org.apache.coyote.tomcat4.CoyoteConnector” port=”9300″ minProcessors=”5″ maxProcessors=”75″ enableLookups=”true” redirectPort=”9443″ acceptCount=”100″ debug=”0″ connectionTimeout=”60000″ useURIValidationHack=”false” disableUploadTimeout=”true”/>
<!– Note : To disable connection timeouts, set connectionTimeout value
to -1 –>

–or–

 

<!– A “Connector” represents an endpoint by which requests are received

and responses are returned. Documentation at :

Java HTTP Connector: /docs/config/http.html (blocking & non-blocking)

Java AJP  Connector: /docs/config/ajp.html

APR (HTTP/AJP) Connector: /docs/apr.html

Define a non-SSL HTTP/1.1 Connector on port 8080

–>

<Connector port=”9300″ protocol=”HTTP/1.1″

maxThreads=”500″

enableLookups=”true”

redirectPort=”9443″

acceptCount=”500″

debug=”0″

connectionTimeout=”60000″

disableUploadTimeout=”true”

maxHttpHeaderSize=”16384″/>

—————————–

  1. Change the connectionTimeout value from 60000 to xxxxxx (in milliseconds)
    5. Save server.xml
    6. Restart Cognos BI service

If the TM1 cube is feed with data from Cognos Controller, any change to dimensions/accounts will be transferred over to the TM1 cube. If a report is built with the dimension name in Cognos Report Studio – that report will not know of the change of dimensions name, and stop working.

 

When the Cognos BI report ask for a field that does not exist, the TM1 Application disconnects the connection. And the Cognos BI Report will timeout.

 

Solution:

Run the report for different months – does it work for older months?

Make a copy of the Cognos BI report.

Remove parts of the Cognos BI report and run it again.

Repeat above until you find the part that is making the report not to work.

Check that value in the TM1 cube.

Have it changed since last month ?

 

Rebuild the report to contain correct fields/dimensions names.

Product:

IBM Cognos BI 10.1.1 64 bit version.

Microsoft Windows 2008 R2 standard server

with 24 GB of RAM and total of 8 cpu cores

(with hyper treading on it looks like 16 cpu cores in windows task manager)

Symptom:

How do I improve the Windows server for my Cognos BI solution ?

In most cases the Microsoft Windows server default values will do fine, but for some heavy loaded Cognos BI system you can gain better effect with this values.

Recommendation:

Change the maximum memory in MB to 6000 for IBM Cognos Configuration Resource Properties. This is found in Cognos Configuration on the BI server.

Standard value is 768, but on a 64 Bit Windows server with more memory this should be increased.  But not above total memory in server. The new Cognos BI 10.1.1 uses more memory for the JAVA and DQM functions than earlier versions. Also the new Cognos BI 10.1.1 64 bit version can handle more memory. By default, the IBM Cognos service is configured to use minimal memory resources to optimize startup time.

 

The value Set the maximum memory used by the JVM.

Usually, the memory is set by adding or changing the initial and maximum Java heap size.

 

The JAVA heap size used by the Query service is set from cognos connection admin portal now.

Go to Administer Cognos Content

Go to configuration – dispatcher

Click on the dispatcher e.g. server name in the list

Click on the MORE for the Query service

Click on set properties

Click on settings

Change the value for JVM heap size limit for the query service (MB) to 4096.

Click OK

 

Logging

Logging for a production environment needs to be set to Basic level.

Check this by go to cognos connection

Launch Cognos Administration

Click on configuration and on dispatcher

Click on MORE for the BI server you want to check

Click on set properties

Click on settings

Change category to logging

Check that all values are set to BASIC

 

Ensure that there is no mark for:

Audit the native query for batch report service

Audit the native query for report service

 

After you changed any value click OK to save the change.

 

TCPIP ports

The following registry keys need to be set on all Windows Server that host Cognos BI components. These will increase the number of available sockets, as well as reduce the time for the Windows OS to free sockets up, once they are not in use anymore.

After the change a reboot is required for the Windows server.

 

Path: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\Tcpip\Parameters

 

Add key: MaxUserPort

use Dword

Set Decimal to 65536

 

Add key: TcpTimedWaitDelay

use Dword

Set Decimal to 30

 

Only change in registry if you know how to do it with the REGEDIT program.

 

Add the following CM advanced parameter to Content Manager:

CAMSEARCHDEFERREDLOCKING = true

This parameter will ensure that not the whole authentication namespace gets locked by 1 user when it comes to complex, long running queries against the authentication source.

 

Surf to Cognos Connection

Launch Cognos Administration

Click on status and on system

Click on CM server

Click on the CM server dispatcher to get a list of all services

Click on arrow for ContentManagerServer and select set properties

Click on settings

Click on EDIT for Environment  Advanced settings

Mark Override the settings acquired from the parent entry

Now you get a grid to enter new values.

Enter CAMSEARCHDEFERREDLOCKING in left column.

Enter True in right column.

Click OK.

Click OK


Cognos TOMCAT

Making sure that Tomcat does not run out of threads under load.

open up the following file in notepad:

<c10 location>\tomcat\conf\server.xml

Look for the following line:

<Connector port=”9300″ protocol=”HTTP/1.1″

maxThreads=”500″

enableLookups=”true”

redirectPort=”9443″

acceptCount=”500″

debug=”0″

connectionTimeout=”60000″

disableUploadTimeout=”true”

maxHttpHeaderSize=”16384″/>

 

Change it as follows:

<Connector port=”9300″ protocol=”HTTP/1.1″

maxThreads=”1000″

enableLookups=”true”

redirectPort=”9443″

acceptCount=”1000″

debug=”0″

connectionTimeout=”60000″

disableUploadTimeout=”true”

maxHttpHeaderSize=”16384″/>

 

maxThreads=”1000″ and acceptCount=”1000″ is increased on system for many users.

Save the file and restart the Cognos BI service to make the changes take affect.

 

Report processes

Change Number of report processes / low affinity connections in cognos connection to use more of the hardware with Cognos BI. Recommendation is to lower Number of low affinity connections for the report service during peak period to 2 from default 4.

Tule of thumb:

2 report processes per core, with 2 low affinity each = 16 processes * 2 low affinity = 32 low affinity in total.

On a combined GW / report server, reduce this to 1 process per core, with 2 low affinity each = 8 processes * 2 low affinity = 16 low affinity in total.

For our exampel server with 8 cpu cores then the settings should be on a pure report server, set the number of processes to 16, and the number of low affinity connections to 2.

On a combined GW / report server with 8 cpu cores, set the number of processes to 8, and the number of low affinity connections to 2.

 

So you need to increase the value for “Maximum number of processes for the report service during peak period” in most modern servers.

Go to Cognos Connection

Click on status and on system

Click on BI report server

Click on arrow for the BI server and select set properties

Click on settings

Change category to tuning

Go to “Maximum number of processes for the report service during peak period”

by click on the arrow in top right of screen.

Set Maximum number of processes for the report service during peak period

to 16.

Above you find “Number of low affinity connections for the report service during peak period”

Set Number of low affinity connections for the report service during peak period

to 2.

Click OK

 

On the first page for category tuning settings:

Go to “Queue time limit of the report service (seconds)”

Change the value for Queue time limit of the report service (seconds)

from 240 to 360, to allow more time to collect data from data layer to the report.

Click OK

Do not change the other values for non-peak period from default settings.

 

Do the same changes for all the Cognos BI servers.