News
Abstract
In IBM® Cognos® TM1® 10.2.0 it is possible to automate certain operations related to TM1 Applications by using the TM1 Application Maintenance utility. This utility is the file named app_maintenance.bat located under the following path in a default installation: <install dir>\webapps\pmpsvc\WEB-INF\tools.
This document describes a number of enhancements to this utility in Cognos TM1 10.2.0 Fix Pack (FP1).
Content
As of Cognos TM1 10.2.0 FP1, when users import rights using the TM1 Application Maintenance utility, they now have the option to merge rights rather than just replacing rights. The option to merge rather than replace has always been available when importing rights from the TM1 Applications portal interface.
The syntax for importing rights in TM1 10.2.0 takes the following form, as shown in this example for a TM1 server that uses Cognos security for authentication:
app_maintenance.bat -serviceurl localhost:9510 –username admin -userpwd password –CAMnamespace namespace –applicationid {32123…2323} –op importrights –rightsfile C:\rights.txt
This example statement replaces existing rights in an application with the rights from the rights.txt file. As of TM1 10.2.0 FP1 you can now merge rights by adding the following syntax at the end of the above statement:
-merge
By adding “-merge”, existing rights in an application are maintained while any new rights are appended.
It is also possible to reference the Application name in the TM1 Application Maintenance utility, rather than the Application GUID. For example:
app_maintenance.bat -serviceurl localhost:9510 –username admin -userpwd password –CAMnamespace namespace –applicationid Plan_Sample –op importrights –rightsfile C:\rights.txt
Also, as of TM1 10.2.0 FP1 you can now import rights from comma separated (.csv) files and not just tab delimited (.txt) files. After the file is selected, the TM1 Application Server automatically detects the delimiter being used so there is no need to specify a file type. This feature applies to the importing of Rights in the TM1 Applications portal as well as using the TM1 Application Maintenance utility.
Authentication
Note that there is a constraint concerning the use of the TM1 Application Maintenance utility with certain authentication modes: the utility will not work when using Cognos security for authentication, and when Single Sign-On is used. This constraint has applied since the utility was released, and still applies in TM1 10.2.2. The utility will work if Cognos security ('CAM authentication') is used without Single Sign-On being applied.
Related Information
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg21655825