Deploying Cognos Portlets to WebSphere Portal 6.0, 6.1, and 7.0

Before users can add Cognos® portlets to their portal pages, you must deploy the portlets to the portal server.

You can deploy the following portlets:

  • IBM® Cognos Content

    This group includes IBM Cognos Navigator, IBM Cognos Search, IBM Cognos Viewer.

  • IBM Cognos Extended Applications

    This group includes the IBM Cognos Extended Applications portlet.

  • IBM Cognos Metric Studio

    This group includes IBM Cognos Metric List, IBM Cognos History Chart, IBM Cognos Impact Diagram, and IBM Cognos Custom Diagram.

Before you begin

Before you start deploying the portlets, ensure that IBM Cognos Business Intelligence, including IBM Cognos Connection and Portal Services, is installed and configured.

For the IBM Cognos Extended Applications portlet, IBM Cognos Software Development Kit must be installed. If IBM Cognos Software Development Kit is not installed or not available, the portal administrator should disable the IBM Cognos Extended Applications portlet after the portlet applications file is installed.

For the IBM Cognos Metric Studio portlets, Metric Studio must be installed. If Metric Studio is not installed or not available, the portal administrator should disable the IBM Cognos Metric Studio portlets after the portlet applications file is installed.

You must first log on to the portal with administrator privileges.

The deployment process consists of the following tasks:

  • Installing the portlet applications file
  • Configuring the portlet applications
  • Configuring the portlet cache
  • Customizing the content of Cognos portlets

After you deploy the portlets, you can configure security for your WebSphere® Portal environment. For more information, see Configuring Security for Portal Services.

For more information, see the Installation and Configuration Guide.

Note: The tasks documented in this section may vary slightly for the different versions of WebSphere Portal.
  • Install the Portlet Applications File
    Before Cognos content can appear in any WebSphere page, you must install the portlet applications file CognosBIPortlets.war located in the c10_location\cps\ibm\portlets directory.
  • Configure the Portlet Applications
    Configure the portlet application to specify the signon mechanism and the address of the server component for Portal Services. This must be done for all sets of Cognos portlets: the IBM Cognos Content portlets, the IBM Cognos Extended Applications portlets, and the IBM Cognos Metric Studio portlets.
  • Configure the Portlet Cache
    Portal Services caches HTML markup fragments that are used to quickly regenerate recent views of portlet pages. These markup fragments are compressed and stored in the user's session object. You can configure the number of pages stored for each user's portlet.
  • Customize the Content of Cognos Portlets
    As an administrator, you can define the default content and appearance of portlets.
  • Special Considerations for WebSphere Portal 6.0 and 6.1
    In WebSphere version 6.0 and 6.1, administrators have two types of configuration levels for defining the appearance of portlets: Administrator and Shared.
Parent topic: Deploying Cognos Portlets to Other Portals