IBM Cognos TM1 10.2.2.5 (10.2.2 Fix Pack 5) provides important corrections for Cognos TM1 10.2.2.0.
This fix pack provides important product corrections to Cognos TM1 10.2.2.0, and should be applied to all installations at your earliest convenience. It includes all previous fix packs for Cognos TM1 10.2.2.
Additional information can be found in the Release notes.
This fix pack also includes IBM Cognos TM1 Pattern (released with Cognos TM1 10.2.2 FP1) for use with IBM PureApplication Systems. No changes have been made to Cognos TM1 Pattern. It is made available with this Fix Pack for convenience.
For information about how to install IBM Cognos TM1 Pattern, see the IBM Cognos TM1 Pattern Installation and Administration Guide.
This fix pack requires that Cognos TM1 10.2.2.0, 10.2.2.1, 10.2.2.2, 10.2.2.3 or 10.2.4 is already installed.
This fix pack includes Cognos TM1 10.2.2.1 (10.2.2 FP1), Cognos TM1 10.2.2.2 (10.2.2 FP2), Cognos TM1 10.2.2.3 (10.2.2 FP3) and Cognos TM1 10.2.2.4 (10.2.2 FP4) fixes.
This fix pack also includes interim fixes issued to date and may be installed over any previous interim fixes applied to Cognos TM1 10.2.2.0.
1. Back up data and configuration files.
Note: This installation automatically creates a backup for you. Previous installations prompted to ask if you wanted to create a backup before proceeding with the installation.
For more information, see Backing up data and configuration files for Cognos TM1 in the IBM Cognos TM1 10.2.2.0 Installation and Configuration Guide.
2. Stop all TM1 services.
Important: All related TM1 services must be stopped before installing this fix pack.
a. Open Cognos Configuration.
b. Stop all of the following services (right-click and select Stop):
- · TM1 Application Server
· TM1 Admin Server
· All instances of the TM1 server service
Note: Stopping the TM1 Application Server also stops other TM1 components that are installed on the same computer, including Cognos TM1 Applications, Cognos TM1 Web, and Cognos TM1 Operations Console. This step also stops the support services that allow Cognos TM1 to communicate with Cognos TM1 Mobile Contributor and IBM Cognos Analysis for Microsoft Excel.
d. If you are using IBM Cognos Business Intelligence (BI) security with Cognos TM1 Applications, stop the IBM Cognos BI service.
e. If you are running any Cognos TM1 services that were not initially configured and started through Cognos Configuration, stop those services in the Windows services console.
3. Run the Cognos TM1 10.2.2.5 (FP5) installation.
Note: On Microsoft Windows systems, a warning dialog appears if any related applications and/or services are running. You can click Continue and the installation will attempt to stop the TM1 Application Server service. Or, you can exit the installation and manually stop the services. On UNIX, Linux, and AIX systems, this warning dialog does not display and you must manually close any related applications and/or services before running the installation.
The installation process performs the following actions for the TM1 Web configuration file.
· Copies your pre-existing tm1web_config.xml file back into the updated TM1 Web configuration folder.
<TM1 installation directory>\webapps\tm1web\WEB-INF\configuration
· Installs a new TM1 Web example configuration file, named tm1web_config.xml.new, into the TM1 Web configuration folder. This new configuration file contains entries for new TM1 Web parameters. Please refer to product documentation for more information.
4. If prompted, restart your computer to complete the installation.
5. After the TM1 10.2.2.5 installation completes,
a. Delete the config.ini file, which can be found <TM1 install>\tomcat\work\Catalina\localhost\pmhub\eclipse\configuration.
This is required when using TM1 Operations Console, Cognos Analysis for Microsoft Excel® or Cognos TM1 Mobile Contributor.
b. Open Cognos Configuration.
c. When you first open Cognos Configuration after applying FP5, a message displays that the configuration files have been upgraded. Click OK to continue.
d. Right-click on the TM1 Application Server and select Start to restart the service.
e. If you are prompted to save configuration settings, be sure to click Yes.
This will refresh the Apache Tomcat web server to use the updated TM1 files and folders.
6. If you are using any Cognos TM1 web-based components, such as Cognos TM1 Web or Cognos TM1 Applications, it is recommended to clear the web browser cache on any computers that access these components.
It is recommended to install the latest fix pack available for Cognos TM1 10.2.2.
24 February 2020