IBM Support

How to upgrade your version of Cognos Analytics

Question & Answer


How do we upgrade our Cognos Analytics Environment to a higher release?


You can upgrade your version of Cognos Analytics by performing an "over the top" installation. This is the default upgrade method and the simplest and easiest way to upgrade Cognos Analytics. All components are upgraded to a newer version using the same configuration details, ports, themes and extensions as your previous installation.

This document will describe how to perform an "over the top" upgrade.

Backup your Environment

Before you start it is important to make a full backup of your Cognos Environment on all servers.

- Content Store - Using your Database Management Tools while the system is offline, Please make a Full Back up of your Content Store.
- In Cognos Administration do a Full Content Store Export Deployment.

Minimize upgrade duration

During installation, the [Cognos Install]\deployment and the [Cognos Install]\data\search folders will be moved twice, which can cause the installer to appear as though it has stopped working. As these folders are often very large, it is advisable to move them to a location outside the Cognos Analytics installation folder prior to applying the update, then move them back after the update has completed, prior to restarting Cognos Analytics.

Temporarily disable virus scanners or anti-malware products

During installation, many files will be updated and moved. Real-time virus scanners and anti-malware products (including Windows Defender) can hold files in a locked state which causes the installer to appear as though it has stopped working. Also, when upgrading outside of business hours, it is possible that a scheduled scan may occur during the installation, which can also have this effect. It is advisable to temporarily disable these products in the Cognos Analytics environment for the duration of the installation process in order to minimise installation delays

Preserving Customized Files

The Cognos Analytics upgrade process automatically preserves your configuration data when upgrading. However if you have customized your environment you will need to check the documentation to ensure that the files and directories you have customized are going to be preserved. (11.0.x) (11.1.x)

If they are not listed then back them up manually.

In version 11.0.6 onwards it is possible to specify exactly which files and directories are preserved using the preserve.txt file. Further details on this are in the link above.


Download the version of Cognos Analytics you would like to install. For 11.1 it is necessary to download both the installation wizard and the accompanying zip file.

Ensure that you upgrade all Cognos Analytics components in your distribution. This includes all Cognos Servers - (Dispatchers, Content Managers, Optional Gateways) plus all client components such as Framework Manager and Dynamic Cube Designer. Remember that some servers may have server components and client components in different locations on the same server.

Steps For all components:

1. Stop the Cognos Analytics Service and close down Cognos Configuration. If you have installed an optional Gateway, please stop the Apache or IIS webserver services.

2. Launch the downloaded installation file and follow the wizard.

3. Choose your Language and click Next.

4. Choose What you want to install - for an upgrade this will be IBM Cognos Analytics click Next.

5. Choose to Accept the license and click Next.

6. Choose the location. This must be the location of your Cognos Analytics instance that you would like to upgrade and also the shortcut folder name. Click Next.

7. Click Yes to confirm you are Installing in the same location and are overwriting a previous installation.

8. Click Install at the summary screen.

9. When complete click Done to complete the upgrade.

10. Open Cognos Configuration - you will be prompted that older versions of Configuration files were found and configuration files have been upgrade to the latest version. click OK and Save your configuration.

11. Repeat the steps for all instances in your distributed environment before starting the Cognos Analytics Services and start the webserver

You have now successfully upgraded your Cognos Analytics environment.

Note: If you are using Unix or Linux without a graphical user interface, you may need to upgrade via a silent install method.
More information can be found in the related links section below.

Verifying the upgrade

To verify that the upgrade worked successfully go to the root of the Cognos Analytics install and open the cmplst.txt file for each of the components and verify that the kit_version has changed.

[{"Product":{"code":"SSTSF6","label":"IBM Cognos Analytics"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Administration and Configuration v11x","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.0","Edition":"All Editions","Line of Business":{"code":"LOB10","label":"Data and AI"}},{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSTSF6","label":"IBM Cognos Analytics"},"Component":"Administration and Configuration","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.1","Edition":"All Editions","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
18 August 2023