Setting Pulse with TM1 Security Mode 3
Setting Pulse with TM1 Security Mode 3
TM1 Security Mode 3 means TM1 uses CAM (Cognos Access Manager) as the authentication provider. In this mode, all user authentication is delegated to IBM Cognos, typically backed by Active Directory or LDAP. This article explains how to configure Pulse to work correctly with TM1 in Security Mode 3.
How Security Mode 3 Affects Pulse
When TM1 runs in Security Mode 3, the REST API requires a valid CAM Passport to authenticate. Pulse must obtain this passport before it can make REST API calls to the TM1 instance.
To do this, Pulse uses:
The Cognos Dispatcher URL to authenticate with CAM.
A TM1 admin user's CAM credentials (namespace, username, and password) configured in the Pulse instance settings.
Configuration Steps
Step 1 — Configure the Cognos Dispatcher in Pulse
Log in to Pulse as an Admin.
Go to Administration → Configuration.
Enter the Cognos Dispatcher URL (e.g.
http://cognosserver:9300/p2pd/servlet/dispatch).Click Save.
Step 2 — Configure TM1 Instance Credentials in Pulse
Go to Administration → Instance Settings.
Select the TM1 instance running in Security Mode 3.
Set the following fields:
CAM Namespace — The namespace configured in your Cognos environment (e.g.
LDAP,AD). This is case-sensitive.User Name — The TM1 admin username as it appears in CAM.
Password — The CAM password for this user.
Click Save.
Step 3 — Test the Connection
After saving the instance settings, go to Administration → Servers and verify the instance shows as connected and active.
CAM Passport Renewal
CAM passports expire after a period of inactivity. Pulse automatically renews the passport using the instance credentials. If you experience disconnections, check:
The
CAMKeepAliveIntervalsetting inPulse.cfg(default:5minutes):
[Monitoring]
CAMKeepAliveInterval = 5This setting controls how frequently Pulse fires a TI process to keep the CAM passport valid.
Finding the CAM Passport for Diagnostics
If you need to retrieve the current CAM Passport for troubleshooting, it can be found by examining the active session in TM1. See the Finding the CAM Passport article for detailed steps.
Common Issues
Issue | Resolution |
|---|---|
Instance shows offline | Verify CAM namespace (case-sensitive) and credentials in Instance Settings |
CAM passport expiry errors | Reduce |
Cognos Dispatcher not reachable | Confirm the URL is accessible from the Pulse server network |