Dec 5, 2015
Enable TM1 Web Logging to Pulse v5.x
Pulse can be integrated with TM1 Web to allow the usage of web sheets and cube views to be logged to TM1. To enable this integration you need to follow the steps below.
Follow the steps in the following article if your Pulse version is v6.x:
NOTE: It is recommended that you enable TM1 Web logging out of hours as user sessions may be terminated resulting in lost work.
TM1 Web Is Installed Side-By-Side with TM1
It is very straight forward to add the required files to TM1 Web when it is installed on the same server as TM1:
Log into Pulse
Go to Administration -> Configuration
Check the box Insert Web Logging Script
TM1 Web Installed on a Separate Server
Because TM1 Web is on a different server you need to manually integrate the relevant Pulse files. The setup is slightly different depending on the version of TM1 Web you are using 10.1 or before (IIS/.NET) or 10.2 or greater (Tomcat/Java).
10.1 or Before (IIS/.NET)
Copy the PulseLog.aspx file from <Pulse Install Location>ResourcesTM1WebDotNetPulseLog.aspx to <TM1 Web Location>PulseLog.aspx
Copy the pulse.js file from <Pulse Install Location>ResourcesTM1WebDotNetpulse.js to <TM1 Web Location>scriptspulse.js
Open PulseLog.aspx file in Notepad
Enter the name of the server that is hosting the Pulse server in the pulseServerAddress variable, for example:
string pulseServerAddress = null;
becomes (double quotes around the server name)
string pulseServerAddress = “SYDTM101”;
If you are using SSL on the Pulse server (this is NOT on by default) change the pulseSSL to true:
If you have change the web port for Pulse from the default 8099 you need to enter your port number in the pulsePortNo setting:
int pulsePortNo = 8099;
Save the PulseLog.aspx page, you may need to save it to the Desktop and then copy the file to the directory due to Windows UAC restrictions.
Open the TM1WebTop.aspx file in Notepad
Find the HTML element </HTML>, it should be at the bottom of the file.
Insert above this line the following code:
<script language=”javascript” src=”scripts/pulse.js”></script>
Save the TM1WebTop.aspx, at this point any users logged in will have their session terminated.
TM1 10.2 (Tomcat/Java)
The default location for TM1Web is: C:Program Filesibmcognostm1_64webappstm1web
Copy the pulseLog.jsp file from <Pulse Install Location>ResourcesTM1WebJavapulseLog.jsp to <TM1 Web Location>pulseLog.jsp
Copy the pulse.js file from <Pulse Install Location>ResourcesTM1WebJavapulse.js to <TM1 Web Location>pulse.js
Open pulseLog.jsp file in Notepad
Enter the name of the server that is hosting the Pulse server in the pulseServerAddress variable, for example:
String pulseServerAddress = “localhost”;
becomes
String pulseServerAddress = “SYDTM101”;
If you are using SSL on the Pulse server (this is NOT on by default) change the pulseSSL to true, you will also need to change the port number. The default SSL port number is 8093.
If you have change the web port for Pulse from the default 8099 you need to enter your port number in the pulsePortNo setting.
Save the pulseLog.jsp page, you may need to save it to the Desktop and then copy the file to the directory due to Windows UAC restrictions.
Open the home.jsp file in Notepad
Find the HTML element, it should be towards the top of the file:
<script language=”javascript” src=”scripts/dojo/dojo.js” type=”text/javascript”></script>
Insert below this line the following code:
<script language=”javascript” src=”pulse.js” type=”text/javascript”></script>
Save the home.jsp.
Repeat steps 9 to 12 with applications.jsp file
Repeat steps 9 to 12 with UrlApi.jsp file
Restart the IBM Cognos TM1 Application Server Windows service.
Note: If the script line is not inserted in the correct location defined above, the TM1 Web logging might not work on every browser.
IBM Planning Analytics (TM1 11)
The default location for TM1Web is: C:Program Filesibmcognostm1_64webappstm1web
Copy the pulseLog.jsp file from <Pulse Install Location>ResourcesTM1WebJavapulseLog.jsp to <TM1 Web Location>pulseLog.jsp
Copy the pulse11.js file from <Pulse Install Location>ResourcesTM1WebJavapulse11.js to <TM1 Web Location>pulse11.js
Rename pulse11.js to pulse.js
Open pulseLog.jsp file in Notepad
Enter the name of the server that is hosting the Pulse server in the pulseServerAddress variable, for example:
String pulseServerAddress = “localhost”;
becomes
String pulseServerAddress = “SYDTM101”;
If you are using SSL on the Pulse server (this is NOT on by default) change the pulseSSL to true, you will also need to change the port number. The default SSL port number is 8093.
If you have change the web port for Pulse from the default 8099 you need to enter your port number in the pulsePortNo setting.
Save the pulseLog.jsp page, you may need to save it to the Desktop and then copy the file to the directory due to Windows UAC restrictions.
Open the home.jsp file in Notepad
Find the HTML element, it should be towards the top of the file:
<link href=”scripts/tm1web/themes/flat/flat.css” rel=”stylesheet” />
Insert below this line the following code:
<script language=”javascript” src=”pulse.js” type=”text/javascript”></script>
Save the home.jsp.
Repeat steps 9 to 12 with applications.jsp file
Repeat steps 9 to 12 with UrlApi.jsp file
Restart the IBM Cognos TM1 Windows service.
Note: If the script line is not inserted in the correct location defined above, the TM1 Web logging might not work on every browser.