Example configurations

This requires IBM Cognos Analytics version 11.2 or higher.

Download the Example dashboards zip file.

Download installation video demo

1. Find the location of IBM Cognos Analytics extensions.

   For Cognos running within an Red Hat OpenShift cluster, locate the pod that contains /data/deployment/. Search for ca- to find Cognos pods.

      kubectl get pods | grep ca-
   

   ca1721852474940188-artifacts-bc9d68dc4-gzk6p 1/1 Running 0 21d
   ca1721852474940188-ca-cpd-cm-78676c5d8f-gctsj 1/1 Running 0 21d
   ca1721852474940188-ca-cpd-reporting-94bd774b8-d2thf 2/2 Running 0 21d
   ca1721852474940188-ca-cpd-rest-bd5667547-m7dxq 2/2 Running 0 21d
   ca1721852474940188-ca-cpd-smarts-7bbdd6ff97-vnwvl 2/2 Running 0 21d
   ibm-ca-operator-controller-manager-7b7d67667b-tks6b 1/1 Running 6 (4h36m ago) 21d
   

   Check whether the pod contains /data/deployment/.

   kubectl exec <pod_name> -- find / -type d -name 'deployment' 2>/dev/null
   

   /data/deployment
   /deployment
   

   For stand-alone IBM Cognos Analytics, this file is on the Cognos server, typically under /opt/ibm/cognos/analytics/deployment.

2. Install the example .zip file.

   For IBM Cognos Analytics running within a Red Hat OpenShift cluster:

   kubectl cp "./<example>.zip" "<pod_name>:/data/deployment/<example>.zip"
   

   For a stand-alone IBM Cognos Analytics server:

   cp ./<example>.zip /opt/ibm/cognos/analytics/deployment/<example>.zip
   

3. Open the Administration console in the IBM Cognos Analytics UI.

4. Go to Configuration > Content Administration and then select the new import button.

5. Select the Cloud_Pak_for_AIOps_examples package and click Next.

6. You are be prompted for a passcode. Enter examples, and click OK.

7. Optionally, update the name and description and click Next.

8. Select the checkbox next to the Cloud_Pak_for_AIOps_examples folder, and click Next.

9. Click Next through the remaining steps, updating defaults as required.

10. Click Finish > Run > OK. The examples package is displayed in the content list.

11. The incident dashboard example requires a custom funnel extension. Download and install this extension from the Manage > Customization > Custom Visuals menu option on the IBM Cognos Analytics home page.

12. The examples folder is displayed under Content > Team content from the IBM Cognos Analytics home page.

    • If you don't immediately see the examples, you might need to wait a minute and then reload the Team content page.

13. Example dashboards use mock data by default. Complete the following steps to use your own live data with the examples:

    1. Create an IBM Db2 integration.
    2. Relink the example Db2 data module to use your database server connection from the previous step.
    3. Relink the dashboard to use the Db2 data module.

1. Color of severity is off: Install the Custom color extension, which provides a richer color palette.

2. The funnel graph is blank: Install the Custom funnel extension.

3. Missing Data in the Db2 module: Relink the provided Db2 data source in the Data subfolder to your own IBM Db2 server connection. Or try loading the page in a private browser window.

4. Warning "One or more data caches could not be loaded." This message can be dismissed. It can occur after relinking data sources to inform you that the data from the new source is not found in the local cache.