IBM Support

Documentation correction -

Release Notes


Abstract

The documentation for configuring Cognos TM1 Web to use Cognos security incorrectly identifies the destination diretory for the tm1web.html fileConfiguring Cognos TM1 Web to use Cognos security

Content

The procedure in Configuring Cognos TM1 Web to use Cognos security instructs you to copy and paste the tm1.html file into the <Cognos_install_location>\webcontent\tm1\web.

This is incorrect. The tm1.html file should be pasted into the <Cognos_install_location>\webcontent\bi\tm1\web directory.

The corrected documentation appears below:


Configuring Cognos TM1 Web to use Cognos security

Follow these steps to configure IBM® Cognos® TM1® Web to use IBM Cognos authentication security.

Note: If you applied a Cognos Analytics updater kit to your Analytics installation, you might need to make specific updates to the tm1web.html file.

The tm1web.html file supports Cognos TM1 Web to use IBM Cognos authentication security. However, it does not get updated when you apply a Cognos Analytics updater kit. Instead, an updated file that is called tm1web.html.new is
placed in the same Cognos Analytics ...\webcontent\tm1\web directory as the original file. Use the newer version of tm1web.html and update it with any changes you made in the original tm1web.html file.

1. Locate and extract the following Cognos TM1 Web gateway files in your Cognos TM1 Web installation directory.

variables_TM1.xml
This file is located in templates\ps\portal.

tm1web.html
This file is located in webcontent\tm1\web.

These files are compressed into the bi_interop.zip file here:
\<TM1 installation loaction>\bi_interop\

For example:

C:\Program Files\IBM\cognos\tm1_64\bi_interop\

2. Copy the files to your IBM Cognos Analytics installation.

variables_TM1.xml

Copy this file to <Cognos location>\templates\ps\portal on every server where the TM1 Web Tier is running on your IBM Cognos Analytics system.

tm1web.html

Copy this file to <Cognos location>\webcontent\bi\tm1\web on every server where the Cognos Analytics Gateway is running on your IBM Cognos Analytics system.

3. Edit the tm1web.html file to point to where Cognos TM1 Web is running.
var tm1webServices = ["http://SystemName:PortNumber&quot;];

For example:
var tm1webServices = ["http://mysystem:9510"];

[{"Product":{"code":"SS9RXT","label":"Cognos TM1"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"TM1 Web","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.2;10.2.2","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}},{"Product":{"code":"SSD29G","label":"IBM Planning Analytics"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":" ","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
17 June 2018

UID

swg27050643