Product:
Cognos Tm1 version 9.5.2
Cognos BI version 10.1

Symptom:
When user try to surf to TM1 contributor website get following error message:
The planning service parameter was not specified or is not one of the configured locations

Background:
Installed on 3 Microsoft Windows 2008 R2 servers with Cognos BI 10.1 64 bit report services on one server and the Cognos BI 10.1 32 bit Gateway functions on a separate server and Cognos TM1 9.5.2 on another server.

The following steps are done:

A TM1 application is created and setup with IntegratedSecurityMode=5 in the tm1s.cfg file
(This give that we use the Cognos BI authentication manager (CAM) for the TM1 application)
TM1 contributor is setup in an own TOMCAT instance (in folder D:\tomcat6).
TM1 portlet are installed the Cognos BI report server.
Installation of portlets will create the variables_tm1.xml in folder d:\Program Files\ibm\cognos\c10_64\templates\ps\portal on the Cognos BI server.
The file variables_tm1.xml is updated with the URL to the TM1 server as shown below

<CRNenv>

<urls>

<url is-regex=”true”>http://srv001/TM1Web/TM1WebLogin.aspx</url>

<url is-regex=”true”>http://srv001/TM1Web/TM1WebLoginHandler.aspx</url>

<url is-regex=”true”>http://srv001/TM1Web/TM1WebMain.aspx</url>

<url is-regex=”true”>http://srv001.work.domain.lan/TM1Web/TM1WebLogin.aspx</url>

<url is-regex=”true”>http://srv001.work.domain.lan/TM1Web/TM1WebLoginHandler.aspx</url>

<url is-regex=”true”>http://srv001.work.domain.lan/TM1Web/TM1WebMain.aspx</url>

</urls>

<cookies>

<param name=”cam_passport”/>

</cookies>

</CRNenv>

Any extra and should be removed from the sample file, and then the file is saved without the sample extension, to be named variables_TM1.xml

The variables_plan.xml file is copied untouch from folder D:\Program Files\Cognos\TM1\Cadmin\gateway on TM1 server to folder D:\Program Files\ibm\cognos\c10_64\templates\ps\portal on the Cognos BI report server.

The planning.html file is copied from folder D:\Program Files\Cognos\TM1\Cadmin\gateway on the TM1 server to folder d:\Program Files (x86)\ibm\cognos\c10\webcontent\ on the Cognos BI gateway server.

The icon_active_application.gif file is copied from the D:\Program Files\Cognos\TM1\Cadmin\gateway folder on the TM1 server to the
D:\Program Files (x86)\ibm\cognos\c10\webcontent\ps\portal\images folder on the Cognos BI gateway server.

This is the icon for the published TM1 Contributor application in Cognos Connection folder “IBM Cognos TM1 Contributor Applications”.

Solution:
Open the planning.html file in notepad from folder C:\Program Files (x86)\ibm\cognos\c10\webcontent on the Cognos BI gateway server.

Change line
// Update the following to point to the location of the planning service(s)
var planningServices = [“http://localhost:8080”];
to
var planningServices = [“http://SRV001.work.company.lan:8080”];

So you use the FQDN that is for the TM1 server where you have installed Tomcat and TM1 Contributor.
Save file and test again.

Workaround:
A not supported workaround is to change the planning.html to an older version.
If you have Cognos TM1 version 9.5.1 – you can copy that planning.html file from the D:\Program Files\Cognos\TM1\Cadmin\gateway folder – to the new installed Cognos BI server, and replace the planning.html file.
Then you use the not so secure planning.html file that was part of Cognos TM1 version 9.5.1.

This should you not do – it is not supported by Cognos.

Product:
Cognos TM1 version 9.5.1

This is a few old recommended actions to do at all Cognos TM1 installations.

1) Same folder structure in test and productions servers:
Recommended that you on the TM1 server create a folder named: tm1servers
Below that folder create a folder for each TM1 server you want to create;
• C:\tm1servers\tm1planning
• C:\tm1servers\tm1controller

By keeping the folder structure same on all TM1 servers it is easy to move scripts between the servers.

2) Create a separate folder for log files:
Below your TM1 folder for you custom TM1 server create a log folder named: LogFiles
Updatera din tm1s.cfg file med raden;
LoggingDirectory=C:\tm1servers\tm1planning\LogFiles

3) Create a separate folder for data files:
Below your TM1 folder for you custom TM1 server create a log folder named: DataFiles
Updatera din tm1s.cfg file med raden;
DataBaseDirectory=C:\tm1servers\tm1planning\DataFiles

To the data folder you should also create a copy of the tm1s.cfg file and place there as “copy of tm1s.cfg” file.

4) Create a script that saves the TM1 data to disc every day:

Go into TM1 Architect program as administrator.
Expand the TM1 application and go to processes tab.
Right click and select “create new process”
Go to the Advance tab
Go to the Prolog tab
Enter a blank row
Enter the statement
Savedataall;
Enter a blank row

Should look like this in prolog:
#****Begin: Generated Statements***
#****End: Generated Statements****
savedataall;

Click on the SAVE icon and name the solution to be SAVEDATA
Go to the Schedule tab
Click in “Schedule this Process as a Chore Named:”
Enter the name SAVEDATA
Enter 1 for run every 1 Days.
Check the local time to show 23:00:00
(this will make it to run every night)
Click on the SAVE icon

Select FILE – EXIT in Turbo Integrator to get back to TM1 Architect.
Then you should now have a process named SAVEDATA
And that chores named SAVEDATA.
Best to also create a TI process that copy the data folder to a different location as a backup.

5) Change the timeout for the TM1web:
On the TM1 server with IIS 6 from Windows 2003
Go to folder C:\Inetpub\wwwroot\TM1Web
Open web.config in notepad
Search for

Below system.web and before the line of <!—DYNAMIC DEBUG….. enter this line

Save and close the web.config file.
Restart the TM1 server and check that all is working.

Product:
Cognos Controller FAP version 8.5.1
Microsoft Windows 2008 server

Symptom:
When doing a IP (initial publish) for datamart in FAP get error “Could not login to TM1, host …. Server name: …. User name: …

If you have the mouse pointer over the error message a screen tip will say
SystemServerConnectionFailed

Cause:
FAP service can not connect to the TM1 server on port 5495 and 12345 (or what port you have setup for TM1 server)

Port number is defined in the tm1s.cfg file at line PortNumber=12366

Possible Solution:
Open the needed ports in the Windows Firewall on the TM1 server.

Product:
Cognos Planning version 8.4.1

Symptom:
The handles are not expandable inside the Cognos Planning Contributor client.

Cause:
Rich Client Contributor front-end have the expand/collapse (plus/minus) handles for hierarchies.

This is controlled by this Hierarchical Dimensions in Analyst

For a dimension to be shown as a hierarchy in Analyst, the following requirements need to be met:
• The dimension must not be a time dimension.
• The dimension’s items must all be detail or simple sums.
• Do not use weighted or time averages.
• Do not use the Force to Zero calculation option.
• Priorities can only be 0 or 10.
• Do not use any formatting.

Solution:
Recreate your Cognos Planning application to only use above allowed values / properties.

Product:
TM1web version 9.5.1
Windows 2003 or 2008 x64 version

Symptom:
User attempts to export to PDF from TM1Web and receives an error.

Message:
Export in process, Please wait…
‘PDFcamp Printer’ was not installed properly

Cause:
PDF camp Printer was not installed properly – it needs to be default printer for that windows account that runs the TM1 Excel Service.

Solution:
Make sure that the PDFcamp Printer is set as default and then restart the TM1ExcelService, even if the printer was set as default.
If this does not resolve it, uninstall PDFCamp by using the 64-bit uninstaller executable at \bin\PDFcamp\unpdfxp64.exe
Then reinstall the PDFcamp Printer using the installer executable at \bin\PDFcamp\setupx64.exe.
Set the PDFcamp Printer as default and restart the TM1ExcelService again.

Product:
Cognos BI 10.1.1
Windows 2008 R2

Symptom:
Error message when you import a report into Microsoft Excel.

Problem:
M:OperationFailed :PRS-REQ-0760 The operation “/” “” “xts.run is invalid

Solution:
Ensure that allowPathInfo=”true” as set in the IIS web.config file for cognos.cgi or cognosisapi.dll in you \cgi-bin\ folder on the Cognos BI gateway server.

The allowPathInfo=”true” parameter will allow the IBM Cognos for Microsoft Office to work.

Note:
If you get the error COC-ERR-2005 then you have missed the ” ” around true in allowPathInfo=”true”.

Product:
TM1 9.5.1 Contributor

Symptom:
Can not log into TM1 Contributor

Problem:
When logging into TM1 Contributor with integrated CAM authentication, after putting in your credentials you receive the following error: PRS-PRH-0221 The Portal/variables_plan.xml could not be opened.

Cause:
Two main reasons can be the source of this error:
1- The appropriate files have not been moved to the proper directory.
2- In a distributed environment, the files from the CAdmin folder in the TM1 installation directory are on the wrong server.

Resolving the problem
In a distributed Cognos environment where the Gateway and Application servers are on different machines:

1- Ensure that the pmpsvc.war file is on the C8\webapps folder on the Application servers.

2- Ensure that the planning.html, variables_plan.xml, and the icon_active_application.gif are in the C8\webcontent, C8\templates\ps\portal and C8\webcontent\ps\portal\images respectively on the Gateway server.

These files can be found under the TM1 install directory in the \Cadmin and \Cadmin\gateway folders.

NOTE:
If the gateway and dispatcher are on different servers, copy the variables_plan.xml to the dispatcher server.

3- Also, it is occasionally required that the CAMPortalVariableFile parameter in the tm1s.cfg file be changed from:
CAMPortalVariableFile=templates\ps\portal\variables_TM1.xml
to:
CAMPortalVariableFile=portal\variables_TM1.xml

Restart the TM1 server to activate the change in parameters.

Product:
Cognos Controller 8.5.1

Symptom:
Error message when running Optimize of database inside Cognos Controller Client.

Message:
Error occurred at removal of temporary VFP files. VFP DLL file missing.

Cause:
The password for the service account that runs Cognos Controller COM+ was changed.

But only the IBMCOGNOSCONTROLLER part was updated from the Cognos Controller Configuration program.
The separate IBMCOGNOSVFP part is not updated automatic.

Solution:
Login to the Cognos Controller Server
Go to Control panel – Administrative Tools – Component services
Expand the COM+ applications until you see two entry’s that begin with IBMCOGNOS….
Right Click on the IBMCOGNOSVFP and select properties
Select the Identity tab
Change the username and password to the correct one at “This user”.
Click OK
Restart the COM plus service.
Restart the COGNOS CONTROLLER BATCH SERVICE.
Try again to run optimize of the database.

Above is not on all Cognos Controller installations. Common is that you have only one IBMCOGNOSCONTROLLER com application.

Product:
Cognos Controller 8.5.1
Windows 2008 R2 Server

Symptom:
Change to Cognos 8 authentication in Cognos 8 Controller configuration, from Native authentication does not change it for the users.

Problem:
Controller users still get login dialog to enter username and password

Solution:
On the Windows 2008 server you must start Controller Configuration program by right click and select RUN AS ADMINISTRATOR to allow the changes to be saved.

You do not get a error, but the switch to Cognos 8 is not registered by Windows. Most changes are in newer Windows version not stored correct if you not run the Configuration program as a administrator.

Start Controller Configuration program with Run as Administrator, and change selected authentications method to Cognos 8
Click save.

Let the user try again.

Product:
Cognos Controller 10.1
Microsoft Windows 2008 R2

Symptom:
When you click on Report Server inside Cognos 8 Controller Configuration you get a Security alert message. Before you had installed SSL certificate and changed the Cognos Configuration to use HTTPS for Cognos Gateway and changed the Controller Configuration for Report Server and Client Distribution Server Configuration.

Error Message:
Revocation information for the security certificate for this site is not available. Do you want to proceed?
Yes – No – View

Cause:
Controller Configuration program ( e.g. IE ) can not access the certificate authority to valid the certificate. Can be because it is a private created certificate from a private CA.

Solution:
On the server ( and on clients ) go into Internet Explorer
Select Tools menu
Select Internet Options
Select Advance tab
remove check mark for “Check for server certificate revocation”
click ok
close internet explorer

Start Cognos Controller Configuration program again, and the message is gone.