Installing ALM Cognos Connector

Rational® Reporting for Development Intelligence and Rational Insight® are no longer available. If you still want to use Cognos® reports, you must first install a stand-alone Cognos server. Then install ALM Cognos Connector to integrate your Cognos reports with your CLM server.

Before you begin

  1. The data warehouse must use IBM® Db2®, Microsoft SQL Server or Oracle for its database.
  2. Install and configure one of the following:

    Customers with a valid CLM license can obtain a copy of Cognos Business Intelligence to be used with the ALM Cognos Connector, by downloading Cognos Business Intelligence from Passport Advantage®. The license is however restricted to be used only with CLM 6.0.x, in a similar way to Rational Reporting for Development Intelligence

    Customers wanting to use Cognos Analytics 11 must purchase a license.

  3. (For Cognos Business Intelligence only) Deploy the Cognos application to WebSphere® Application Server. Ensure that you follow the instructions that apply to WebSphere Application Server.
    1. Open a command window and enter one of the following commands from the [WASInstalldir]\profiles\[server]\bin directory:
      • managesdk –enableProfileAll –sdkname 1.7_64 –enableServers
      • managesdk -enableProfile -profileName [yourProfileName] -sdkname 1.7_64 -enableServers 
    2. Verify your changes by running the following command:
      managesdk -listEnabledProfile -profileName [yourProfileName] -verbose
    Checkpoint: Task help topic. Ensure that the Cognos report server is running successfully by opening the following URL in a browser:http://[Cognos_BI_server]:[port number]/p2pd/servlet/dispatch, where [Cognos_BI_server] is the WebSphere Application Server profile where the IBM Cognos Business Intelligence application is deployed.
    Tip: The JAVA_HOME environment variable must point to the version of Java™ installed with the WebSphere Application Server where the Cognos application is deployed.
  4. Install the required version of Installation Manager. Downloads are available on Jazz™.net:

Installing with the Installation Manager repository

Before you begin

Install the required version of Installation Manager. Downloads are available on


  1. Download the Installation Manager repository location:
    1. In your browser, navigate to the Jazz Reporting Service downloads page.
    2. Select the version that you want to install.
    3. Switch to the All Downloads tab.
    4. Save the ALM Cognos Connector archive file to your system.
    5. Read and accept the license and click Download.
    6. Extract the archive file to a temporary location.
  2. Start Installation Manager and select File > Preferences > Repositories. The Preferences dialog opens.
  3. On the Repositories preferences page, click Add Repository. The Add Repository dialog opens. Click Browse to select repository.config from the temporary directory where you extracted the archive file. Click Open to select the file. Click OK to add the repository to the repositories list.
  4. Select the ALM Cognos Connector repository location, and then click OK to close the Preferences dialog.
  5. In Installation Manager click Install. Installation Manager will prompt to install using the repositories.
  6. In the Installation Packages page, select the IBM ALM Cognos Connector package, and then click Next.
  7. In the Validation Results page, read the information provided and complete any required prerequisite actions, and then click Next.
  8. Review the license agreement. If you agree to the terms, select I accept the terms in the license agreement, and then click Next.
  9. Specify the location where you want to install the package. Click Next.
  10. Select the languages that you want to install, and then click Next.
  11. Select the features that you want to install and click Next:
    • Cognos BI Integration: Select this option to work with Cognos reports.
    • XML Data Configuration Tool: Select this option if you want to customize your CLM XML data configuration files in order to perform advanced customization of your data collection.
    • Data Adapters: Select this option if you want to extract data from Rational ClearQuest®. The Rational ClearQuest data adapter provides the connectivity needed for an ETL operation to collect the data from a Rational ClearQuest server to the data warehouse.
  12. In the summary page, review the summary of the installation information, and then click Install.
  13. Click Finish.

What to do next

Now you can migrate your Cognos reports from Rational Reporting for Development Intelligence report server to the Cognos Business Intelligence server.

video icon Video channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community forums library

support icon Support

IBM Support Community
Deployment wiki