IBM Support

How to Update Your IBM Cognos TM1 Performance Modeler / Cognos Insight Provisioning Agent - TM1 10.2.X

Fix readme


Abstract

Please ensure that you have already reviewed all of the relevant detail on the following page before you proceed:

IBM Cognos TM1 SSL Expiration - Updater Kits - Landing Page
http://www-01.ibm.com/support/docview.wss?uid=swg21991790

This Technote applies to all versions of TM1 10.2 and TM1 10.2.2, except for TM1 10.2 Fixpack 2 on UNIX.

Content

BEFORE YOU BEGIN:
-The provisioning agent is part of the TM1 Application Portal (PMPSVC). When a user installs/opens Performance Modeler or Cognos Insight using the icons from within the PMPSVC portal - a version check occurs. During this check, if the server contains an updated version of the Performance Modeler or Cognos Insight client - users will automatically receive the updates.

-This updater specifically updates the Provisioning Agent on the TM1 Application Portal to ensure that users who launch Performance Modeler or Cognos Insight obtain the new certificates automatically.

-If your TM1 Application Server (PMPSVC) web application is hosted on a different application server than the bundled Tomcat Application server, you will need to recreate your PMPSVC WAR file, and redeploy it to your application server.

-If your TM1 Application Server (PMPSVC) web application uses a different JRE than what is provided by default, ensure that you update the RunSSLProvInst.bat file to point to your JRE path. (UNIX Users will need to do this as TM1 on UNIX does not ship with a JRE).

INSTALLATION STEPS:

  1. The following steps do not necessarily require that your TM1 Application Server be stopped, however it is recommended that you perform these steps when the server is stopped / while you are applying the rest of the certificate changes for the TM1 Application Server ( using the manual steps via http://www-01.ibm.com/support/docview.wss?uid=swg21991653 )
  2. Download/obtain the TM1RCPSSLProvInst updater from the following location:
  3. You should have the following files:
    • TM1RCPSSLProvInst.jar
    • RunSSLProvInst.bat
  4. Copy the two files above to your <tm1_install_dir>\tm1_64\ directory
  5. If your TM1 Application Server resides on WINDOWS
    • Open Windows Command Prompt as an Administrator, and navigate to <tm1_install_dir>\tm1_64\
    • Execute the following command to update the Provisioning Agent:
      • RunSSLProvInst.bat

        You may also run the application in Test Mode (the script will run however changes will not be made). To run the application in Test Mode use RunSSLProvInst.bat -t
  6. If your TM1 Application Server resides on UNIX
    • Navigate to <tm1_install_dir>/tm1_64/
    • Execute the following command to update the Provisioning Agent:
      • $JAVA_HOME/bin/java -jar TM1RCPSSLProvInst.jar

        Where $JAVA_HOME is the same $JAVA_HOME you would use to run/start your TM1 Application Service.
After the above steps have been followed, users who launch IBM Cognos TM1 Performance Modeler / Cognos Insight from the TM1 Application Portal will automatically receive the new SSL Certificates.

Document information

More support for: Cognos TM1
TM1

Software version: 10.2, 10.2.2

Operating system(s): AIX, Linux, Windows

Software edition: All Editions

Reference #: 1992411

Modified date: 01 November 2016


Translate this page: