Cognos 10 Framework Manager Tutorial



In this article, we will learn How to install the IBM Cognos Framework Manager (FM) on Windows.

We will discuss the following key points

  1. Users: For which users, we need to install the Framework Manager.
  2. Prerequisite: Need to fulfill all the prerequisites before installing the Framework Manager on Windows.
  3. Installation Steps: Step-by-Step guide to install the IBM Cognos Framework Manager on Windows.


1. Users

In the IBM Cognos Business Intelligence world, we have two types of users. Business users (or clients) and Developers. In developers, we included all the users such as admin, authors, and others. Business users are only interested in the facts, figures, and analysis. They don’t want to know How data imported, transformed and used within reports. It is not important to install Framework manager for business users. In some special scenarios, we can install the framework manager in the client’s system. A developer or FM modeler required framework manager access. A developer required framework manager access for data modeling. It is mandatory for a developer to install the IBM Cognos Framework Manager. If a user needs the framework manager for data modeling, then we need to install it for that user. Simple, if it required, then only install it. It is a client tool for data modeling. For business users, we may skip it.

It is important to remember without a framework manager package we can’t create a report. Applicable for the Cognos Version 10 and lower. We can create a report with a blank package. To use the report studio, we required a valid FM package published on the IBM Cognos connection. Without it, we can’t open the report studio. You can ignore IBM Cognos 10.2.2 Data Set.

2. Prerequisite

To install IBM Cognos Framework Manager, we need to check the following key points.


To install any software on the Windows Machine we required admin privileges. Without admin privileges, we can’t install any Software’s. With privileges, we have the following two scenarios.

    1. Without Admin Privileges: 

If you don’t have the admin privileges, we need to ask an admin to install the IBM Cognos Framework Manager. If the admin will install it, you need to inform the admin to install it outside the “Program Files” folder. Why? Program Files is a protected folder. After installing the Framework Manager, we need to configure it. The configuration file is available in the Cognos installation directory. If they install it inside the “Program Files” folder, then we can’t edit the configuration file. It is important to install the FM outside the “Program Files”. We recommended installing it in C:\Cognos or X:\Cognos directory. Here X is any available directory.

   2. Admin Privileges:

If you have admin privileges you can install it anywhere.

Why configuration is important?

To answer the above question, please refer to the following image.

The IBM Cognos Framework Manager is the Windows-based client application. As per the architecture diagram, a client must need proper communication between a web server and the application server. Without the proper communication between a web server and the application server, we can’t use it. In the configuration, we need to provide a valid gateway URL and the dispatcher URL.

How to find the Gateway URI and the Dispatcher URI?

To know the correct Gateway URI and the Dispatcher URI we need to communicate with the IBM Cognos admin. Gateway URI and the Dispatcher URI may change based on the Cognos Server and the Application Server installation. Following are the default format for the Gateway URI and the Dispatcher URI.

Sample Gateway URI: http://localhost:80/ibmcognos/cgi-bin/cognos.cgi

Sample Dispatcher URI: http://localhost:9300/p2pd/servlet/dispatch

Software and Hardware Need

Operating System: Windows. (The IBM Cognos Framework Manager is only available for Windows)

RAM: At least 512 MB. Recommended 1 GB. (RAM and Hard disk need are not very huge for Framework Manager.)

Disk: 500 MB or More free space.

Other: Microsoft Data Access Component (MDAC) 2.6 or later for use with product samples. (We may need to install Data Access components in some special scenarios.)

Install Framework Manager

Following are the installation steps for the IBM Cognos Framework Manager.

Step 1: Install “7 Zip”, or “WinRAR”. If the installation file is available in a “tar.gz” format, then we need to extract it first. We can either use the “7 Zip” or “WinRAR” to extract the tar.gz file. Extract the installation file.

Step2: Open the installation folder. In our machine installation files are available in “C:\Data\fm_10.2.2_win_ml”. Open the folder. Inside the folder, we can find the setup file. The final setup file on our system is “C:\Data\fm_10.2.2_win_ml\win32\issetup.exe”

Step3: Double click on the setup file to start the IBM Cognos Framework Manager installation wizard. If the user account controller, ask for your permission click the “Yes” button.

Step 4: If the installation started, you can see the Welcome Window. Here we need to select the language. For us, we selected English and then clicked on the Next button.

Step 5: On the next window we need to read and agree with the IBM Cognos Terms and Condition. Read it and then click on the “I Agree” button. Finally, click on the “Next” button.

Step 6: Next, we need to select the installation location. As we discussed earlier in this article, if you have admin privileges, install it anywhere. Else install FM outside the “Program Files” folder. We selected “C:\ibm\cognos\c10”. Select the correct installation location and then click on the “Next” button. If the selected location does not exist, then the installer displays a dialog box to create the directory during the installation. Click on the “Yes” button.

Step 7: Next, we need to select the components need to be installed. We selected everything. We only have two options. One is the Framework Manager. Second is Map Manager. Select the components and click on the next button.

Step 8: On the next window we need to select the shortcut folder name. We use “IBM Cognos 10 FM”. If you are planning to use a different shortcut name, then the same name will be visible in the start menu after the installation. We also have the checkbox to control the visibility for the start menu shortcut. If you want to visible it only for you then, you can uncheck the checkbox “Make the checkbox visible to all users”. Once done, click on the “Next” button.

Step 9: Installation Summary, we are almost done with all the installation options. Here you can find all the option selected by you. If you are fine with the installation options, proceed to the IBM Cognos Framework manager installation. If you need to change anything use the “Back” button to go back to the respective installation windows and change the options. We are fine with our installation summary to Click on the “Next” button to start the installation.

Step 10: Installation progress. Wait for the installation to finish. Once the installation is finished, it will redirect you to the finished window.

Step 11: Installation is complete. Here we have two buttons. The first button is to open the transformed log. If you want to check it, click on the button. Next, button is to check the error log. If your installation fails due to some reason, you can refer the error log for the error message. In our system it is installed. Next, we need to configure the framework manager. On the same window, we have a checkbox to launch the IBM Cognos Configuration Manager. If you need to configure the FM, you need to check the checkbox and then click on the “Finish” button. For this article, we will click on the finish button without enabling the same checkbox. Why? We need to show you How to launch the Framework Manager and the Configuration Manager. Click on the finish button to close the Installation wizard.

Congratulation, you installed the IBM Cognos Framework Manager on your Windows machine.

IBM Cognos Framework Manager installation completes on Windows machine. In our next article, we will learn How to launch IBM Cognos Framework Manager and Configuration Manager?

Leave A Comment

Please login to post your valuable comments.