Setting up IIS and Cognos Analytics when upgrading from version 11.0.3 to 11.0.4 or higher

Applies to version 11.0.4 and subsequent versions unless specifically overridden

Before you begin

This topic assumes you have a version 11.0.3 environment working, that you have IIS set up, and that you have single signon working.

About this task

In this topic, the following assumptions are made:
  • IIS server name: iis-host
  • IIS port #: 80
  • IIS virtual directory name: ibmcognos
  • Cognos Analytics server name: ca-host
  • Cognos Analytics port #: 9300

Procedure

  1. Backup your 11.0.3 content store.
  2. Install version 11.0.4 on top of your version 11.0.3 installation. As necessary, do this on your Data tier, Application tier, and your Gateway tier machines.
  3. Before starting the Cognos Analytics services, make the following changes to the environment.
    1. Remove this entry from install_location\wlp\usr\servers\cognosserver\server.xml file (on the Data and Application tier): <jndiEntry jndiName="glass/sso/login" value="/ibmcognos/cgi-bin/cognosisapi.dll"/>
    2. Examine the default.htm and index.html in gateway_install_location/webcontent folder. Make sure that this line <meta http-equiv="refresh" content="0; URL=bi/"> includes the following slash (/) on the URL=bi/ attribute.
    3. Launch Cognos Configuration on the Gateway tier. Modify the Environment > Gateway Settings > Dispatcher URIs for gateway to use following format: http://<apptier_host>:<apptier_port>/bi/v1/disp
    4. Launch Cognos Configuration on the Data and Application tiers. Change the Environment > Gateway Settings that apply.
      • Gateway URI: http(s)://iis-host:80/ibmcognos/bi/v1/disp

        This is the URL for disconnected content such as links in PDFs, Excel, and Active Reports. It is also used in links sent via email.

      • Dispatcher URIs for gateway: http(s)://ca-host:9300/bi/v1/disp

        This is the list of URIs the Cognos ISAPI code connects to when forwarding requests. Multiple entries are used for failover. Include all relevant Cognos Analytics application servers.

      • Dispatcher URI for external applications: http(s)://ca-host:9300/bi/v1/disp

        External applications such as Framework manager connect on this URL to perform SDK operations.

    5. Please follow the procedures in Configuring IIS in Cognos Analytics 11.0.3 to reconfigure IIS.
  4. Start the services in this order: 1) Data tier, 2) Application tier, 3) Gateway tier and IIS.