Installing IBM Cognos Analytics

Before you install IBM OpenPages® with Watson™ components, ensure that IBM® Cognos® Analytics is installed and running on your reporting server computer.

For more information, see the IBM Cognos Analytics Installation and Configuration Guide in IBM Documentation.

Before you begin

Review the following notes:

Java™

You must use the IBM Runtime Environment for Java that is provided with IBM Cognos Analytics.

The location is <COGNOS_HOME>/ibm-jre/jre.

Oracle
Verify that the database client software is at the same version as the Oracle database server software. For example, if you are using Oracle 19.3 on the database server, use the Oracle 19.3 client on the reporting servers.
Restriction: Do not install the database client software into a directory with spaces.
IBM Db2®

If you are using IBM Db2, install the 64-bit database client.

Linux®
Ensure that the dependent 32-bit and 64-bit libraries are installed.
Cognos Framework Manager
Framework Manager is not required. If you want to use this optional component, see IBM Cognos Framework Manager in the IBM Cognos documentation.
To set up the environment variables for Cognos, see:

Procedure

  1. Optional: If you have an earlier version of Cognos, back up the content store.
  2. Ensure that a web server is installed.

    For more information, see Prerequisite software for reporting servers.

  3. On the reporting server, install IBM Cognos Analytics.
    Restriction: Install IBM Cognos Analytics into a directory that contains only ASCII characters in the path name. Do not install IBM Cognos Analytics into a directory that contains spaces.
    For information about installing IBM Cognos Analytics, see the following topics in the Cognos documentation:
  4. Copy the JDBC database driver to the <COGNOS_HOME>/drivers directory.
    • If the content store is an Oracle 12.2.0.1, 18c, or 19c database, copy the ojdbc8.jar file from the Oracle installation, <ORACLE_HOME>/jdbc/lib.
    • If the content store is a Db2 database, copy the db2jcc4.jar and db2jcc_license_cu.jar files from the IBM Db2 installation, <DB2_HOME>/sqllib/java.
  5. Append the <COGNOS_HOME>/bin64 directory to the library path environment variable.
    • On Linux operating systems, update the LD_LIBRARY_PATH environment variable.
      Example: export LD_LIBRARY_PATH=/opt/ibm/cognos/analytics/bin64:$LD_LIBRARY_PATH
  6. Append the <COGNOS_HOME>/bin64 directory to the PATH environment variable.
    Example: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/ibm/cognos/analytics/bin64
  7. Verify that JAVA_HOME is set in the system environment variables.
    Set JAVA_HOME to <COGNOS_HOME>/ibm-jre/jre/bin

    Do this step on each reporting server in your deployment (active and standby).