IBM Support

How to Update Your Performance Modeler / Cognos Insight Client Installations - ALL VERSIONS

Fix Readme


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

IBM Cognos TM1 SSL Expiration - Manual Fix Approach - Landing Page


To update your IBM Cognos TM1 Performance Modeler / IBM Cognos Insight installation, the below steps can be followed:

  1. Download the updated TM1 SSL Certificates from the following location:
  2. Extract the downloaded file/archive and extract it to any directory. For the purpose of this document, our files will be extracted in to C:\NewSSLCerts\
  3. After extracting the files, look inside of your extracted folder C:\NewSSLCerts\ . The following files should be present.
    • applixca.der
    • applixca.pem
    • applixcacrl.p7b
    • applixcacrl.pem
    • tm1admsvrcert.pem
    • tm1store
    • tm1svrcert.pem
  4. In your Windows Start menu, find and right-click your IBM Cognos TM1 Performance Modeler / Cognos Insight shortcut and click 'Open File Location'

    **If you are using IBM Cognos TM1 10.1.0 or TM1 10.1.1 Performance Modeler / Cognos Insight, they do not contain shortcuts in the Start menu by default. If you are not sure where Performance Modeler/Cognos Insight had been installed, you will need to launch Performance Modeler and then open Task Manager on your computer. With Task Manager open, look for the ModelingMDT process - on the Processes tab. Right click the ModelingMDT process and select 'Open File Location'
  5. 'C:\Users\username\AppData\Roaming\IBM\Cognos Performance Modeler\' directory.
  6. From within the directory just opened, use the Windows Search utility to find all folders named 'ssl'. If the folder name is ssl, then the steps below apply. The points below are only examples of folders that may exist. The primary objective for this step is to use your Windows search and find any, all, every ssl folder in this path - and update it accordingly.
    *Depending on your installation, you may have MULTIPLE directories. For example, if you have two versions of TM1 you use in your environment - you will likely have two unique versions of Performance Modeler that will require SSL file updates
    • An example SSL folder location would look like the following: C:\Users\username\AppData\Local\Programs\IBM\Cognos TM1 Performance Modeler\bins\bin_10.2.5240.84\tm1\bin\ssl
    • As well as: C:\Users\username\AppData\Local\Programs\IBM\Cognos TM1 Performance Modeler\bins\bin_10.2.5240.84\tm1\bin\tm1api101\ssl
    • And: C:\Users\username\AppData\Local\Programs\IBM\Cognos TM1 Performance Modeler\bins\bin_10.2.5240.84\tm1\bin\tm1api102\ssl
  7. Back up one of the SSL Folders to ensure that you have the original keys, just in case. This is more specific to a scenario in which you are simply testing this procedure - before rolling out to the masses.
  8. Copy the contents of the folder you extracted earlier C:\NewSSLCerts\ , and place them inside of ALL \ssl\ folder found in your Performance Modeler or Cognos Insight installation directory. During this process, you will be required to REPLACE all conflicting files as we must replace the old certificate files with new ones.

    At this stage, (and assuming your IBM Cognos TM1 Server components have been set up correctly and are running) - you should be able to confirm that you are able to successfully use IBM Cognos TM1 Performance Modeler and/or Cognos Insight.

Related Information

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

Document Information

Modified date:
15 June 2018