Updated for Planning Analytics 188.8.131.52. As of version 11 TM1 (Planning Analytics) is able to be upgraded in situ. In other words, you can upgrade Planning Analytics without removing the previous version, installing the new version directly over the top of an existing installation. All installation files are cumulative, so you could, in theory, jump from v 2.0.0 to v 2.0.7 if required (but I’d be really careful if you tried!).
Time needed: 1 hour.
Here are the steps for completing the upgrade of Planning Analytics (TM1):
- Download from Passport Advantage the new version of Planning Analytics
See this post for instructions on downloading from IBM
- Unzip the installation files into a convenient folder (two parts)
If you are using Windows, it is the file called “pa_versionnumber_l86-64_ml.tar.gz”, which breaks convention from the previous filenames of “TM1_winx64h_versionnumber_ml.tar.gz”. You need to unzip both the .gz and then when that is unzipped, unzip the .tar as well. You can delete the .gz and the .tar after the .tar is unzipped.
- Review the “What’s New” page on ibm.com
This can be a bit tedious, I know. But still, go check it. There might just be something there that might have bitten you on the bum!
- Save Data in each model.
You only really need to do this if you are not 100% confident that there is a regular SaveData TI running on a chore.
- Back up your TM1 models to a zip file.
You should already have a daily backup of your models. If you don’t, zip up the data folders of each model.
- Open Cognos Configuration for TM1 and do an export
Yes, I know you don’t really need to do this, but it might just be useful if for whatever reason the information gets lost!
- Copy the Planning Analytics Admin Agent bootstrap.properties file
If you are running the Planning Analytics Administration Agent, you need to stop the Planning Analytics Administration Agent service, then take a backup of your bootstrap.properties file. This is located at C:/Program Files/ibm/cognos/tm1_64/paa_agent/wlp/usr/servers/kate-agent/. This file stores your specific server-based information for configuring PAAA.
- Notify Users of Outage
Let users know that TM1 will be offline for an hour or so.
- Install as Administrator
From the unzipped location above, run as an Administrator “issetup.exe” from the “winx64h” folder.
If you have not stopped all the TM1/Planning Analytics services, you will get a warning like this:
If you get this, go to Windows Services and stop all the TM1 services:
- Continue with the TM1 Installer
- Location Warning
When you get the warning that you are installing Planning Analytics to the same location as a previous installation, accept the warning. This will replace the previous version of TM1.
- Continue with Installation
- Open Cognos Configuration and Restart Services
From inside TM1’s Cognos Configuration, restart the TM1 and TM1 Server Services.
- Test the Upgrade
Run your update processes and confirm that they all work as expected.
Open a couple of reports or forms and confirm they are ok.
Open PAW and confirm it is happy.
- Notify Users of Success
Advise users that TM1 is now available again and ask that they test it to confirm that all is ok.
You should also now upgrade Planning Analytics Spreadsheet Services. Please see this post for instructions on how to do that.
Finally, see this post to upgrade Planning Analytics for Excel (where you are beyond version 2.0.65)
Remember, if you need any help with upgrading TM1 or Planning Analytics, please give us a buzz!