Single server installation

Procedure to Install IBM® Cognos® Analytics in a single server environment. Use the installation wizard to select the server components that you want to install, and the location on your computer where you want to install them.

Important: You must specify fully qualified host names in the values for the following Cognos Configuration fields. Each value you specify must also appear in either the field Subject Alternative Name > DNS names or the field Subject Alternative Name > IP addresses.
  • Environment
    • Gateway URI
    • External dispatcher URI
    • Internal dispatcher URI
    • Dispatcher URI for external applications
    • Content Manager URIs
  • Environment > Configuration Group
    • Group contact host
    • Member coordination host
  • Security > Cryptography > Cognos
    • Server common name
    • Subject Alternative Name > DNS names
    • Subject Alternative Name > IP addresses

Before you begin

  1. Required :

    The content store is a database that Content Manager uses to store global configuration data, global settings (such as the language and currency formats shown in the user interface), connections to data sources, and product-specific content. You must use one of the supported enterprise-level databases as the content store in a production environment.

    See Content Store

  2. These configuration actions are critical to the success of your installation. Take these required actions after you install the components.

    See JDBC Drivers for Audit an Notification Store Databases.

  3. For authenticated logon, you must configure IBM Cognos Analytics components with an appropriate namespace for the type of authentication provider in your environment. You can configure multiple namespaces for authentication and then choose, at run time, which namespace you want to use

    See Authentication Provider.

  4. Optional:
    1. You can create an audit database to store log messages.

      See Audit Database

    2. Web server:
      1. You must configure your web server before users can connect to the IBM® Cognos® Analytics portal. For IBM Cognos Analytics for reporting, you must also set the content expiry for the images directory in your web server so that the web browser does not check image status after the first access.

        See Gateway Documentation.

      2. This tool automates the configuration steps based on the IBM Knowledge Center article – Configuring IIS with Cognos Analytics.

        See Internet Information Services Automated Script
      3. To view and browse images in the Reporting, configure Web Distributed Authoring and Versioning (WebDAV) on your web server. Report authors can browse for images to include in reports in a way that is similar to browsing a file system. On Microsoft Internet Information Services (IIS) web servers, you must first enable the WebDAV feature, and then configure your web server to access the image location.

        See WEBDAV on IIS Documentation.

      4. To view and browse images in the Reporting, configure Web Distributed Authoring and Versioning (WebDAV) on your web server. Report authors can browse for images to include in reports in a way that is similar to browsing a file system. On IBM HTTP Server or Apache HTTP Server, you must add directives to your server configuration file, and then configure the directory access.

        See WEBDAV Apache/IBM HTTP Server.

      5. After you complete this web server procedure, the server can handle requests for static files (such as .js, .html, .css), load balance requests to IBM Cognos Analytics, and route SSO requests through the IBM Cognos Analytics gateway code.

        See Apache / IBM HTTP Server (IHS) Scripts

    3. Configure your IBM® Cognos® Analytics mail server to send notifications using IBM Cognos Event Studio.

      See Mail Server Setup

    4. By default, the notification server uses the same database that Content Manager uses for the content store. You can use a separate database for notification in situations where you run large volumes of batch reports and email.

      See Notification Store Documentation


  1. Download installer and repository.
    Download from Passport Advantage.
  2. Double click installer file.
  3. Follow the directions in the installation wizard to copy and install the files to your computer.
  4. Installation log files are found here: <installLocation/uninstall/logs>
  5. Once completed, navigate to Drivers folder <InstallLocation\drivers> and place appropriate JDBC drivers for Content Store and Audit databases.
  6. Navigate to shortcut location and launch Cognos Configuration.
  7. If the Gateway option was selected, modify the Gateway URI to the following format: <http://applicationTierServer:applicationTierPort/bi/v1/disp
    1. Use HTTPS if SSL is being used.
    2. See SSL Documentation for more details.
  8. Configure the Audit Database.
    1. Right click on Logging > New Resource > Destination.
    2. Set the name to Audit.
    3. Set the type to Database.
    4. Right click on New Resource > Database > Audit.
    5. Set the name Audit.
    6. Select the type Select your database type.
    7. Select the database server and port number.
    8. Set database user ID and password.
    9. Set the database name and encryption.
  9. Configure the Authentication Provider.
    1. Right click Authentication Source > New Resource > Namespace. Set the following:
      • Name
      • Type (Group)
      • Type
    2. For more authentication details, please refer to Configuring Cognos Analytics guide, Chapter 7.
  10. If Content Store is Db2, fill in the following fields:
    1. Database Server and port number.
    2. User ID and Password for the database.
    3. Database name and encryption.
  11. If Content Store is not Db2, complete the following steps:
    1. Right Click Content Manager and select Delete. Confirm deletion.
    2. Right Click Content Manager > New Resource > Database. Set the following:
      • Name
      • Type (Group)
      • Database Server and port number
      • User ID and Password for the database
      • Database name and encryption
  12. Configure a mail Server.
    1. Click Notification.
      • Set the SMTP mail server.
      • Set account and password, if applicable.
      • Set default sender, if needed.
      • Set the SSL encryption enabled value.
  13. Configure a notification store.
    1. Right Click Notification > New Resource > Database.Fill out the following:
      • Set the name Notification Store.
      • Type - select your notification store database type.
      • Database server and port number.
      • User ID and password.
      • Database name.
      • Encryption.
  14. Test configuration to ensure settings are valid.
    1. Click on Configuration > Action Menu > Test


If you have not setup a Gateway you can now access IBM Cognos Analytics here: serverName:9300/bi .