Integrating IBM Cognos 8 into IBM WebSphere Integrating IBM Cognos 8 into IBM WebSphere Portal 3. IBM

  • View
    0

  • Download
    0

Embed Size (px)

Text of Integrating IBM Cognos 8 into IBM WebSphere Integrating IBM Cognos 8 into IBM WebSphere Portal 3....

  • Proven Practice

    Integrating IBM Cognos 8 into IBM WebSphere Portal Product(s): IBM Cognos 8

    Area of Interest: Infrastructure

  • Integrating IBM Cognos 8 into IBM WebSphere Portal 2

    IBM Cognos Confidential Information

    Copyright Copyright © 2008 IBM Cognos ULC (formerly IBM Cognos Incorporated). IBM Cognos ULC is an IBM Company. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. IBM Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document. This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to the information contained in this document will be documented in subsequent editions. This document contains proprietary information of IBM Cognos. All rights are reserved. No part of this document may be copied, photocopied, reproduced, stored in a retrieval system, transmitted in any form or by any means, or translated into another language without the prior written consent of IBM Cognos. IBM Cognos and the IBM Cognos logo are trademarks of IBM Cognos ULC (formerly IBM Cognos Incorporated) in the United States and/or other countries. IBM and the IBM logo are trademarks of International Business Machines Corporation in the United States, or other countries, or both. All other names are trademarks or registered trademarks of their respective companies. Information about IBM Cognos products can be found at www.IBM Cognos.com This document is maintained by the Best Practices, Product and Technology team. You can send comments, suggestions, and additions to cscogpp@ca.ibm.com .

    mailto:cscogpp@ca.ibm.com

  • Integrating IBM Cognos 8 into IBM WebSphere Portal 3

    IBM Cognos Confidential Information

    Contents 1 INTRODUCTION............................................................................................ 4 PART 1 – IBM COGNOS’ INTEGRATION INTO IBM WEBSPHERE PORTAL................ 5 IBM COGNOS PORTLETS IN IBM WEBSPHERE ............................................................................5 IBM COGNOS PORTLET FEATURES...........................................................................................6 PORTAL CONFORMANCE........................................................................................................7 PART 2 – INSTALL AND CONFIGURE IBM COGNOS 8 PORTLETS IN IBM WEBSPHERE PORTAL..................................................................................................................... 8 INSTALLING THE IBM COGNOS PORTLET IN IBM WEBSPHERE PORTAL ..............................................8 INITIAL CONFIGURATION .................................................................................................... 11 VIEWING PORTLETS ON A PAGE ............................................................................................ 12 DISTRIBUTED ENVIRONMENTS .............................................................................................. 14 PART 3 – ENABLING SINGLE SIGNON.................................................................... 15 OVERVIEW...................................................................................................................... 15 PREREQUISITES, NAMESPACE SETTINGS, AND CONFIGURATION...................................................... 16 SETTING UP SHARED SECRET FOR SSO .................................................................................. 21 ALTERNATIVE METHODS FOR SSO (ASIDE FROM SHARED SECRET) ................................................. 26 PART 4: TROUBLESHOOTING ................................................................................. 29 ERRORS WHEN ANONYMOUS ACCESS IS TO SET TO “TRUE” IN IBM COGNOS CONFIGURATION ................ 29 ERRORS WITH SINGLE SIGNON ............................................................................................. 33 THE CONNECTION SERVER URI ............................................................................................ 37

  • Integrating IBM Cognos 8 into IBM WebSphere Portal 4

    IBM Cognos Confidential Information

    1 Introduction

    This document provides step-by-step instructions on how to enable install and configure

    IBM Cognos 8 BI portlets within IBM WebSphere Portal 5.x. This document contains

    detailed information about how to enable Single Signon (SSO) and the relevant

    troubleshooting steps required to isolate and resolve the issue.

    This document is divided into four main sections:

    1. Overview of IBM Cognos’ Portlets

    2. Installing and Configuring the IBM Cognos 8 BI Portlets

    3. Enabling Single Signon between IBM Cognos and WebSphere Portal

    4. Troubleshooting issues relating to the IBM Cognos portlets

    Although this document was written specifically for configuring SSO between WebSphere

    Portal 5.1 and IBM Cognos 8 MR2, many of the same principles apply to previous and latest

    versions of both WebSphere and IBM Cognos.

  • Integrating IBM Cognos 8 into IBM WebSphere Portal 5

    IBM Cognos Confidential Information

    Part 1 – IBM Cognos’ Integration into IBM WebSphere Portal

    IBM Cognos Portlets in IBM WebSphere

    IBM Cognos 8 provides five out-of-the-box portlets for consumer functionality:

    IBM Cognos Navigator – Allows users to browse through IBM Cognos content and

    folders and run reports and pages. Within the Navigator, users can choose the

    appropriate action and destination when selecting an object (i.e. launch in new window,

    other portlet, etc.).

    IBM Cognos Search – Allows users to search through IBM Cognos content for relevant

    objects (i.e. reports, pages, folders, etc.). The IBM Cognos Search portlet support both

    the regular IBM Cognos string search and the full indexed IBM Cognos GO! Search.

    Similar with the Navigator, with Search, users can choose the appropriate action and

    destination when selecting an object (i.e. launch in new window, other portlet, etc.)

    IBM Cognos Viewer – Allows users to view reports and pages. Users can specify the

    column size of this portlets as well as the default actions.

    IBM Cognos Metrics Watchlist – Allows users to view the Metrics stored in their

    Metrics Manager watchlist. Within this portlet, users can specify the Metrics package

    they would like to view.

    IBM Cognos Extended Applications – Allows developers to build their own portlets

    to consume in a third-party Portal. With the IBM Cognos SDK, three open-source

    sample portlets are provided (Navigator, Search, and Viewer) along with their source

    code. Developers can then modify the source code to create their own unique portlets

    to meet their exact business requirements.

  • Integrating IBM Cognos 8 into IBM WebSphere Portal 6

    IBM Cognos

    Navigato r

    IBM Cognos Metrics

    Watchlist

    IBM Cognos Viewer

    IBM Cognos Search

    IBM Cognos Portlet Features

    Portlet-to-portlet communication – This feature allows users to select an object in

    the Navigator or Search portlet and have this object rendered in the IBM Cognos Viewer

    portlet.

    Customization and personalization – IBM Cognos portlets can be customized to

    provide a slightly different look-and-feel. For example, default reports and folders can

    be specified – reducing the amount of clicks necessary for the user to view a report.

    Additionally with the Navigator and Search, options can be specified to show more or

    less information and actions for each user.

    Extensibility through the SDK – The Extended Applications portlet allows users to

    build their own portlet using existing open sourced samples. This is ideal for users to

    build powerful portlets to meet their custom business logic and requirements.

    WSRP Support – The IBM Cognos portlets conform to the WSRP standard and use this

    standard protocol when communicating with the IBM Cognos 8 server.

    IBM Cognos Confidential Information

  • Integrating IBM Cognos 8 into IBM WebSphere Portal 7

    IBM Cognos Confidential Information

    “Ready for IBM WebSphere Portal” Certification – With each major release, IBM

    Cognos’ portlets regularly obtain the rigorous IBM certification to be deemed “Ready for

    IBM WebSphere Portal”.

    Portal Conformance

    IBM Cognos has a long history of support with IBM WebSphere Portal. Contained below are

    the certified versions of IBM WebSphere Portal for each major version of IBM Cognos BI.

    IBM Cognos Version IBM WebSphere Portal Version

    IBM Cognos Series 7 IBM WebSphere Portal 4.2

    IBM WebSphere Portal 5.x

    IBM Cognos ReportNet IBM WebSphere Portal 4.2

    IBM WebSphere Portal 5.x

    IBM Cognos 8.1 IBM WebSphere Portal 5.x

    IBM Cognos 8.2 IBM WebSphere Portal 5.x

    IBM WebSphere Portal 6.0

  • Integrating IBM Cognos 8 into IBM WebSphere Portal 8

    Part 2 – Install and Configure IBM Cognos 8 Portlets in IBM WebSphere Portal

    Installing the IBM Cognos Portlet in IBM WebSphere Portal

    IBM Cognos 8 contains deployment f