Configuring the content store for Cognos Analytics

The Cognos® Analytics content store is a database that is used to store configuration data, global settings, data server connections, and product-specific content.

Before you begin

As of IBM Cloud Pak® for Data 3.0.1, the Cognos Analytics service must be configured to reference/store content in an external content store. Valid content store databases are Db2® Database, Microsoft SQL Server, and Oracle.

If you want to use a content store located outside of IBM Cloud Pak for Data such as Db2, Microsoft SQL Server, or Oracle, refer to Guidelines for creating the content store.

If you want to use the IBM® Db2 service on IBM Cloud Pak for Data, complete the following task.

About this task

If the IBM Db2 service is not installed, complete the steps in the Db2 Advanced Edition on Cloud Pak for Data topic.

Note: If you configured the IBM Db2 database server to use Oracle compatibility mode, you must temporarily disable the Oracle compatibility mode before creating the content store. After creating the content store, configure the IBM Db2 database server to use Oracle compatibility mode again. For details, see https://www.ibm.com/support/pages/node/515565.

Procedure

  1. Collect the following details from your database administrator:
    • Database name
    • Deployment id
    • Username
    • Password
    • JDBC Connection URL
  2. Log in to your Red Hat® OpenShift® cluster:
    oc login OpenShift_URL:port
  3. Open a terminal window and enter the following commands:
    #
    #  USE VALUES from STEP 2
    #
    export NAMESPACE=<Namespace of your CPD Installation>
    export DB2USERNAME=<USERNAME>
    export DB2PASSWORD=<PASSWORD>
    export DB2DEPLOYMENTID=<DEPLOYMENTID>
    
     
    #
    # Connect to DB2U Pod
    #
    export CMD="env DB2USERNAME=$DB2USERNAME DB2PASSWORD=$DB2PASSWORD  bash"
    oc  exec -ti c-$DB2DEPLOYMENTID-db2u-0 -n $NAMESPACE -- $CMD
    
  4. From the Db2 container, enter the following commands in your terminal window:
    cd /mnt/blumeta0/home/db2inst1/sqllib
    . ./db2profile   
     
    db2 CONNECT to BLUDB user $DB2USERNAME using  $DB2PASSWORD 
    db2 UPDATE DATABASE CONFIGURATION USING APPLHEAPSZ 1024 DEFERRED; 
    db2 UPDATE DATABASE CONFIGURATION USING LOCKTIMEOUT 240 DEFERRED;
    db2 CREATE BUFFERPOOL CMDB_08KBP IMMEDIATE SIZE 1000 PAGESIZE 8K;
    db2 CREATE BUFFERPOOL CMDB_32KBP IMMEDIATE SIZE 1000 PAGESIZE 32K;
    db2 CREATE SYSTEM TEMPORARY TABLESPACE TSN_SYS_CMDB IN DATABASE PARTITION GROUP IBMTEMPGROUP PAGESIZE 32K BUFFERPOOL CMDB_32KBP;
    db2 CREATE USER TEMPORARY TABLESPACE TSN_USR_CMDB IN DATABASE PARTITION GROUP IBMDEFAULTGROUP PAGESIZE 8K BUFFERPOOL CMDB_08KBP;
    db2 CREATE REGULAR TABLESPACE TSN_REG_CMDB IN DATABASE PARTITION GROUP IBMDEFAULTGROUP PAGESIZE 8K BUFFERPOOL CMDB_08KBP; 
    db2 CREATE SCHEMA db2COGNOS AUTHORIZATION $DB2USERNAME;
    db2 ALTER BUFFERPOOL ibmdefaultbp size 49800;
    
    exit
    

    Your database is created. Complete the next steps to connect to a data source.

  5. To connect to a IBM Db2 Database, Microsoft SQL Server, or Oracle data source:
    Note: IBM Db2 Warehouse database is currently not a supported data source.
    1. Log in to the Cloud Pak for Data web client.
    2. From the menu, select Connections.
    3. Click New connection.
    4. Enter a name and a description for the connection.
    5. Select Db2, Microsoft SQL Server, or Oracle for the Connection type.
    6. On the New connection page, enter the connection information. For example:
      • Host
      • Port
      • Database name
      • Username
      • Password
      Important: If you selected Db2 for the Connection type on Cloud Pak for Data, you must set Username and Password Security Mechanism to Clear text.
  6. To test the connection, click Test connection on the New connection page.
  7. Click Create.
    The connection is saved.

What to do next

To provision an instance of Cognos Analytics, complete the following task: Provisioning the Cognos Analytics service.