IBM Support

TM1 10.2.2 Fix Pack 5 - New Tm1s.cfg parameter, CreateNewCAMClients

Product Documentation


Abstract

IBM Cognos TM1 10.2.2 Fix Pack 5 introduces a new parameter, CreateNewCAMClients, for the TM1 server configuration file (Tm1s.cfg).

Content

The CreateNewCAMClients TM1 server configuration parameter determines how the TM1 server handles an attempt to log on to the server with CAM credentials in the absence of a corresponding TM1 client.

CreateNewCAMClients is an optional configuration parameter. It is also a dynamic parameter; adding or modifying this parameter in Tm1s. cfg does not require a server restart.

When


CreateNewCAMClients=T
and a logon is attempted with a valid set of CAM credentials, but a corresponding TM1 client does not exist, the TM1 client is created during the logon. This is the default behavior when CreateNewCAMClients is not set in the Tm1s.cfg file.

When
CreateNewCAMClients=F
and a logon is attempted with a valid set of CAM credentials, but a corresponding TM1 client does not exist, the TM1 client is not created and the logon is rejected. Through the C API, the error code is SystemServerClientNotFound. Through the HTTP endpoint, a 401 Unauthorized error is returned, with authentication information dependent on server configuration settings.

Additionally, when the logon is rejected a log message is printed to the CAMSecurity.ClientCreation logger at the WARN level, if this level of logging is enabled. The log message includes the text "CAM Client not found, and not created due to CreateNewCAMClients config setting"

[{"Product":{"code":"SS9RXT","label":"Cognos TM1"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"TM1 Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"10.2.2","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
17 June 2018

UID

swg27047657