Configuring Cognos TM1 Applications to use Cognos Business Intelligence Security

1. Locate the bi_interop.zip file that is provided with the Cognos TM1 installation in the following location.

   Cognos TM1 location\bi_interop\

2. Extract and merge the content of the bi_interop.zip file into the root directory of your existing Cognos BI installation.

   For example: C:\Program Files\IBM\cognos\c10_64\

   Note: The bi_interop.zip file contains a directory structure that merges files into the \templates and \webcontent subdirectories.
3. To manually extract and copy the files to your Cognos BI installation, copy the files as follows:

   If you are using a distributed Cognos BI server environment, copy these files to the computer that is running the Cognos BI Application tier or Gateway tier as follows.

   planning.html

   Copy planning.html to C10 Install Dir\webcontent where the Cognos BI Gateway is installed.

   icon_active_application.gif

   Copy icon_active_application.gif to C10 Install Dir\webcontent\ps\portal\images where the Cognos BI Gateway is installed.

   variables_plan.xml

   Copy variables_plan.xml to C10 Install Dir\templates\ps\portal wherever the presentation service (Application tier) is running in a Cognos BI server.

   Note: These files are also installed with newer Cognos BI installations. If the files exist on your Cognos BI server, then you only need to edit them as explained in these steps.

1. Open the planning.html file and locate the following lines:

   // Update the following to point to the location of the planning service(s)

   var planningServices = ["http://machine.company.com:9510"];

2. Set the planningServices parameter to the location and port number for the Cognos TM1 Application Server.

   var planningServices = ["http://web_server_address:port_number"];

   Replace web_server_address with the fully qualified domain name (FQDN) for the computer where the Cognos TM1 Application Server is running. For example, myhost.example.com

   • If you are running the Cognos TM1 Application Server with the Apache Tomcat that is provided with the Cognos TM1 installation:

     var planningServices = ["http://web_server_address:9510"];

   • If you are running the Cognos TM1 Application Server with your own web application server, use the location and port number for that system.
   Tip: If you are using the same Cognos BI server to authenticate different instances of Cognos TM1 Applications that are running on multiple computers, use a comma-separated list with the fully qualified domain name (FQDN) for each computer. For example:

   var planningServices = ["http://machine1.example.com:port_number","http://machine2.example.com:port_number"];

   Tip: If the Cognos TM1 Application Server is running on a web server that belongs to multiple domains, use a comma-separated list to enter the fully qualified domain name for each domain. For example:

   var planningServices = ["http://computer_A.domain_1:port_number","http://computer_A.domain_2:port_number","http://computer_A.domain_3:port_number"];

3. Save and close the planning.html file.

For details, see Configuring session timeout values for Cognos TM1 Applications and Cognos BI Security.

1. Open Cognos TM1 Applications using the format of the following link:

   http://web_server_name:port_number/pmpsvc

   For example: http://localhost:9510/pmpsvc

2. Log in and open the Cognos TM1 Applications Configuration page:
   • If you are running Cognos TM1 Applications for the first time, the Configuration page opens after you log in.
   • If you already configured Cognos TM1 Applications, open the Configuration page by clicking the Administer IBM Cognos TM1 Applications icon on the toolbar of the TM1 Applications portal page.
3. On the TM1 Applications Configuration page, enter values for the following Cognos TM1 and Cognos BI parameters:
   • Enter values in the TM1 Admin Host and Server Name fields and configure the options for the data contribution clients that you want to use. For details, see Configuring the server and client environment for Cognos TM1 Applications.
   • Set the IBM Cognos Gateway URI parameter. For example:

     http://CognosServerName/ibmcognos/cgi-bin/cognos.cgi

   • Set the IBM Cognos Dispatcher URI parameter. For example:

     http://CognosServerName:9300/p2pd/servlet/dispatch

     Replace CognosServerName with the name of the system where the Cognos BI web server is running.

If you see the following error, review your settings for the planningServices parameter in the planning.html file on the Cognos BI server.

The planning service parameter was not specified or is not one of the configured locations