To use Cognos product documentation, you must enable JavaScript in your browser.

Install Framework Manager 

You can install Framework Manager, the metadata modeling tool for Cognos 8 for reporting, on the same computer as other Cognos 8 components, or on a different computer. All required files are copied to one computer. Default settings are used for the configuration. You can change these default settings if necessary, or if you install Framework Manager on a separate computer from Cognos 8.

If you are upgrading Framework Manager from an older version, you must first uninstall the older version of Framework Manager .

Before you install Framework Manager, we recommend that you close all programs that are currently running to ensure that the installation program copies all the required files to your computer.

Also, ensure that you have administrator privileges for the Windows computer you are installing on. If you are not an administrator, ask your system administrator to add you to the Administrator group on your computer. Administrator privileges are also required for the account that is used to run Framework Manager.

We recommend that you install and configure all Cognos 8 server components before you install Framework Manager.

If you are installing the modeling tool in the same directory as Cognos 8 and do not stop the Cognos 8 services, you are prompted to do so during the installation.

System Requirements for Framework Manager

Before you install Framework Manager, ensure that the Windows computer meets Cognos 8 software and hardware requirements. The size of your models determines the hardware requirements, such as disk space.

The following table lists the minimum hardware and software requirements to run Framework Manager.

Requirement

Specification

Operating system

Windows

RAM

Minimum: 512 MB

Recommended: 1 GB

Disk space

Minimum: 500 MB of free space on the drive that contains the temporary directory used by Cognos 8

Database

Database client software installed on the same computer as Framework Manager (Oracle, DB2, or Sybase only)

Database connectivity set up

Other

Microsoft Data Access Component (MDAC) 2.6 or later for use with product samples

Steps
  1. If you use an Oracle database as a data source for your reports, set the NLS_LANG environment variable by typing the following command on each computer where Framework Manager and the Application Tier Components are installed:

    NLS_LANG = language_territory.character_set

    For example, NLS_LANG = JAPANESE_JAPAN.UTF8

    The value of the variable determines the locale-dependent behavior of Cognos 8. Error messages, sort order, date, time, monetary, numeric, and calendar conventions automatically adapt to the native language and locale.

    If the Application Tier Components are installed on a UNIX computer, the NLS_LANG variable must be set up for the user who owns and starts the Cognos 8 service.

  2. If you are installing in a directory with other Cognos 8 components, stop the Cognos 8 service.

  3. Insert the CD for Framework Manager.

    The Welcome page of the installation wizard should appear.

    If no Welcome page appears, in the win32 directory on the CD, double-click the issetup.exe file.

  4. Select the language to use for the installation.

    The language that you select determines the language of the user interface. You can change the language to any of the installed languages after installation.

  5. Follow the directions in the installation wizard to copy the required files to your computer.

    If you are installing Cognos 8 on a computer that already has ReportNet, and you want to keep ReportNet running, you must install Cognos 8 in a different directory.

    If you are installing in a directory that contains other Cognos 8 components, you are prompted for the location of a directory in which to store backup copies of the files that will be overwritten.

  6. In the Finish page of the installation wizard,

  7. Click Finish.

    Use the Windows Start menu to start Cognos Configuration from the shortcut folder.

To ensure the security and integrity of Cognos 8, it is important to protect the installation directory from unauthorized or inappropriate access.

If you use Oracle, DB2, or Sybase as the database server for the content store in a distributed installation, you must now install the database client software on the same computer where you installed Framework Manager.

After you install Framework Manager on your Windows computer, some configuration tasks may be required to ensure that it works in your reporting environment .

Default Settings for Framework Manager 

The following table lists the default settings for the Cognos 8 ports and URIs that are used by Framework Manager. After installation, you can use the configuration tool to change the settings. You can also change them by editing the cogstartup.xml file in the c8_location\configuration directory.

Component

Default

Description

Gateway

http://localhost:80/ cognos8/cgi-bin/ cognos.cgi

The URI to the Cognos 8 gateway

Dispatcher URI for external applications

http://localhost:9300/ p2pd/servlet/dispatch

The URI to the dispatcher

Log Server Port

9362

The port used by the local log server