IBM Support

How to manually reset deployed TM1 Applications

Troubleshooting


Problem

In cases where an application cannot be redeployed or rights can no longer be saved the following process can be used to reset deployed application. The TM1 model contains dimensions and cubes with names starting with }tp_ that correspond to the deployed applications. This process will force these cubes and dimension to be recreated. Problems with application deployment and applying application rights can be caused by missing or incorrectly defined }tp_ objects in the TM1 model.

Resolving The Problem


1 - Export the application(s) from the TM1 Applications web portal. If it's not possible to export the applications then it may be possible to use the .model, .admin, and .security files from the ..\tm1_64\webapps\pmpsvc\WEB-INF\applications directory to manually create an application export file. Rename these files as following:

<application_id>.model -> app.definition
<application_id>.admin -> app.admin
<application_id>.security -> app.security

To determine the application id for a specific application examine the URL when browsing to the application workflow web page.



After renaming this files place them into a single application.zip file. We can later use this file to import the application.

2 - Stop the IBM Cognos TM1 Applications service

3 - Remove (without deleting) any .model, .admin, and .security files from the ..\tm1_64\webapps\pmpsvc\WEB-INF\applications directory

4 - If the TM1 server uses CAM security then we must also remove links to previously deployed applications from the IBM Cognos TM1 Applications - My Applications folder in Cognos Connections Public Folders. If CAM security is not used skip this step.

5 - Using TM1 Architect run the }tp_admin_delete_all Ti process (you may need to enable the option to display control objects). This process is run with the default parameters. Please note that this Ti process remove all objects from the TM1 model used by TM1 Applications for all applications.

6 - Using TM1 Architect check for rules on the }CubeSecurity and }DimensionSecurity cubes. Comment out any rules on these cubes by adding the comment symbol # in front of the rule and save. These rules only need to be disabled during the application deployment or import process.

7 - Start the IBM Cognos TM1 Applications service

8 - Open a new web browser session and browse to the IBM Cognos TM1 Applications web portal (e.g tm1web:9510/pmpsvc). The process of browsing to this web portal will recreate some Ti processes in the TM1 model that were removed by the }tp_admin_delete_all process.

9 - Import the application from the application.zip file. Optionally the application can be recreated and deployed from Performance Modeler.

10 - Enable any rules of the }CubeSecurity and }DimensionSecurity cube that were disabled in step 6

[{"Product":{"code":"SS9RXT","label":"Cognos TM1"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"TM1 Contributor","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.2;10.2.2","Edition":"All Editions","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
15 June 2018

UID

swg21696743