Installing 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.

This file contains the applications for the Cognos portlets, one for IBM® Cognos Navigator, IBM Cognos Search, and IBM Cognos Viewer, one for IBM Cognos Extended Applications, and one for IBM Cognos Metric List, IBM Cognos History Chart, IBM Cognos Impact Diagram, and IBM Cognos Custom Diagram.

Before you begin

To install the portlet applications file, you must be logged on to the portal with administrator privileges, and be able to access the CognosBIPortlets.war file from your file system or network file system. If the Portal Services installation is not within your network access, you must manually move the CognosBIPortlets.war file to an accessible location.

The portlet applications file can be installed only once. However, it can be updated when required.

Procedure

  1. From the portal main menu, click Administration > Portlet Management > Web Modules, and then click Install.
    Tip: To update the CognosBIPortlets.war file, click Web Modules, select the file name, and click the update web module button Update web module icon.
  2. Click the Browse button, and, in the c10_location\cps\ibm\portlets directory, select the CognosBIPortlets.war file.
  3. Click Next.
  4. Click Finish.

    A message confirms that the portlets were successfully installed.

  5. Open the WebSphere administration console. Under applications, select Enterprise Applications and find the Cognos portlets application.
  6. Go to Security role to user/group mapping and map the role with the name All Role to all authenticated users.