# IBM Cognos Analytics

IBM Cognos Analytics is a business intelligence and performance management software platform that is used to create dashboards, reports, and data visualizations.

OvalEdge uses IBM Cognos Analytics REST API and JDBC driver to connect to the data source, which allows users to crawl data objects (Reports, Modules, Exploration) and build Lineage.

![IBM\_arch](https://support.ovaledge.com/hs-fs/hubfs/Architecture%20Diagram/6.1ConnectorImages/IBM_arch.png?width=688\&height=299\&name=IBM_arch.png)

## **Connector Capabilities**

The following is the list of objects and data types supported by the IBM Cognos Analytics connector.

| **Functionality** | **Description**                                |
| ----------------- | ---------------------------------------------- |
| Crawler           | <p>Reports<br>Report Columns<br>Dashboard</p>  |
| Lineage           | <p>Report Lineage<br>Report Column Lineage</p> |

## **Prerequisites**&#x20;

The following are the prerequisites required for establishing a connection between the connector and the OvalEdge application.&#x20;

1. Driver / API details.
2. Service Account with minimum read permissions.
3. Configure environment variables (Optional).

### **Driver / API Details**

OvalEdge uses a JDBC driver to connect to IBM Cognos Analytics:

| **Driver**  | **Version** | **Details**                                                                                                                                             |
| ----------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| JDBC Driver | 19.3        | Oracle JDBC Jar.                                                                                                                                        |
| API         | 11.1        | <p>OvalEdge uses REST API to connect to IBM Cognos Analytics.</p><p><https://www.ibm.com/docs/en/cognos-analytics/11.1.0?topic=api-rest-reference>.</p> |

### **Service Account with Minimum Permissions**&#x20;

The following are the minimum privileges required for a service account user to crawl and profile the data.

| **Operation**         | **Minimum Access Permission** |
| --------------------- | ----------------------------- |
| Connection Validation | Read Permission.              |
| Crawling              | Read Permission.              |
| Lineage               | Read Permission.              |

### Establish Environment Variables (Optional)

This section describes the settings or instructions that users should be aware of prior to establishing a connection. If your environments have been configured, skip this step.

#### **Configure Environment Names**

The Environment Names allow users to select the environment configured for the specific connector from the dropdown list in the **Add Connector** pop-up window.\
You might want to consider crawling the same schema in both stage and production environments for consistency. The typical environments for crawling are PROD, STG, or Temporary, and may also include QA or other environments. Additionally, crawling a temporary environment can be useful for schema comparisons, which can later be deleted, especially during application upgrade assistance. \
\
**Steps to Configure the Environment**<br>

1. Navigate to Administration | Configuration.&#x20;
2. Select the Connector tab.
3. Find the Key name “connector.environment”.
4. Enter the desired environment values (PROD, STG) in the value column.&#x20;
5. Click ✔ to save.&#x20;

## Establish a connection

To establish an IBM Cognos Analytics Connection:

1. Log into the **OvalEdge** application
2. In the left menu, click on the **Administration** module name, and click on the **Connectors** sub-module name. The **Connectors** Information page is displayed.
3. Click on **+ New Connector**. The Add Connector pop-up window is displayed.
4. Select the connection type as IBM Cognos Analytics. The Add Connector with  IBM Cognos Analytics specific details are displayed.

   | **Fields**                | **Details**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                               |
   | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
   | Connection Type\*         | <p>The selected connection type ‘IBM Cognos Analytics’ is displayed by default. </p><p>If required, the dropdown menu allows the user to change the connector type and based on the selection of the connection type, the fields associated with the selected connection type are displayed.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |                               |
   | License  Add-Ons\*        | <p>All the connectors will have a <strong>Base Connector</strong> License by default that allows you to crawl and profile to obtain the metadata and statistical information from a datasource. </p><p>OvalEdge supports various License Add-Ons based on the connector’s functionality requirements.</p><ul><li>Select the <strong>Auto Lineage Add-On</strong> license that enables the automatic construction of the Lineage of data objects for a connector with the Lineage feature. </li><li>Select the <strong>Data Quality Add-On</strong> license to identify, report, and resolve the data quality issues for a connector whose data supports data quality, using DQ Rules/functions, Anomaly detection, Reports, and more.</li><li>Select the <strong>Data Access Add-On</strong> license that will enforce connector access via OvalEdge with Remote Data Access Management (RDAM) feature enabled.</li></ul>                                                                                                                           |                               |
   | Connection Name\*         | <p>Enter a Connection name for IBM Cognos Analytics. Users can specify a connection name to identify the IBM Cognos Analytics connection in OvalEdge.</p><p><strong>Example</strong>: IBMCognos\_db</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                               |
   | Environment               | <p>The environment dropdown menu allows you to select the environment configured for the connector from the dropdown list. For example, PROD, or STG (based on the configured items in the OvalEdge configuration for the connector.environment).<br>The purpose of the environment field is to help you identify which connector is connecting what type of system environment (Production, STG, or QA).<br><strong>Note:</strong> This was set up in the configuration in the above prerequisites steps. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |                               |
   | Host Name\*               | Enter the hostname of IBM Cognos Analytics                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                               |
   | Connection String\*       | Set the Connection string toggle button to automatic to get the details automatically from the credentials provided. Alternatively, you can manually enter the string. Example: {server}:/IBMCognosLibrary                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |                               |
   | Username\*                | Enter the Service Account Username for the IBM Cognos Analytics Server name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                               |
   | Password                  | Enter Password for IBM Cognos Analytics Server password                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                               |
   | DefaultGovernance Roles\* | <p>You can select a specific user or a  team from the governance roles (Steward, Custodian, Owner) that get assigned for managing the data asset. </p><p>Note: The dropdown list displays all the configurable roles (single user or a team) as per the configurations made in the OvalEdge Security                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Governance Roles section.</p> |
   | Admin Roles               | <p>Select the required admin roles for this connector.<br></p><ul><li>To add <strong>Integration Admin</strong> Roles, search for or select one or more roles from the Integration Admin options, and then click on the Apply button. <br>The responsibility of the Integration Admin includes configuring crawling and profiling settings for the connector, as well as deleting connectors, schemas, or data objects.</li><li><p>To add <strong>Security and Governance Admin</strong> roles, search for or select one or more roles from the list, and then click on the Apply button. <br>The security and Governance Admin is responsible for:</p><ul><li>Configure role permissions for the connector and its associated data objects.</li><li>Add admins to set permissions for roles on the connector and its associated data objects.</li><li>Update governance roles.</li><li>Create custom fields.</li><li>Develop Service Request templates for the connector.</li><li>Create Approval workflows for the templates.</li></ul></li></ul> |                               |
   | Cognos Namespace Id\*     | <p>Enter Cognos Namespace Id</p><p>For more information on Namespace, please refer to Active Directory Authentication</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                               |
   | MetaDB URL\*              | <p>It is the driver URL used to access the Oracle database from IBM Content Manager.  </p><p>Enter the URL as jdbc:mysql://{---}/ibmcognos</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |                               |
   | Database Name\*           | Enter the name of the Oracle database, which is pointed to the IBM Content Manager.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                               |
   | MetaDatabase UserName\*   | Enter the Username configured to access the Oracle Database                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                               |
   | MetaDatabase Password     | Enter Database Password                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                               |
   | No of archive objects\*   | <p>It is the number of last modifications made in the metadata data of a dataset at Remote/source. By default, the number of archive objects is set to disable mode. Click on the Archive toggle button and enter the number of objects you wish to archive.</p><p>For example, if a user updates the count as 4, then the connection is crawled. It will provide the last 4 changes that occurred in the remote/source of the connector. You can observe these changes in the ‘version’ column of the ‘Metadata Changes’ module. </p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |                               |
   | Select Bridge             | <p>With the OvalEdge Bridge component, any cloud-hosted server can connect with any on-premise or public cloud data sources without modifying firewall rules. A bridge provides real-time control that makes it easy to manage data movement between any source and destination. For more information, refer to Bridge Overview.</p><p>For more information, refer to <a href="https://support.ovaledge.com/bridge-overview">Bridge Overview</a></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |                               |
5. Click on the **Validate** button to validate the connection details.
6. Click on the **Save** button to save the connection.  Alternatively, the user can also directly click on the button that displays the Connection Settings pop-up window to configure the settings for the selected Connector. The **Save & Configure** button is displayed only for the Connectors for which the settings configuration is required.&#x20;

**Note:** \* (asterisk) indicates the mandatory field required to create a connection. Once the connection is validated and saved, it will be displayed on the Connectors home page. \
**Note:**  You can either save the connection details first, or you can validate the connection first and then save it.&#x20;

## Connection Validation Errors&#x20;

| S.No. | Error Message(s)              | Descriptions                                                      |
| ----- | ----------------------------- | ----------------------------------------------------------------- |
| 1     | Invalid Username or Password. | Error validating credentials due to invalid username or password. |

**Note:** If you have any issues creating a connection, please contact your assigned OvalEdge Customer Success Management (CSM) team.

## Connector Settings&#x20;

Once the connection is established successfully, various settings are provided to fetch and analyze the information from the data source.&#x20;

| **Connector Settings**    | **Description**                                                                                                                                                                                                                                                                                    |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Crawler                   | Crawler settings are configured to connect to a data source and collect and catalog all the data elements in the form of metadata. Check out the crawler options to set the crawler's behavior in the Crawler Settings.                                                                            |
| Business Glossary Setting | The Business Glossary setting provides flexibility and control over how they view and manage term association within the context of a business glossary at the connector level.                                                                                                                    |
| Lineage                   | In the Lineage setting a separate tab is provided in Connector settings for data source type as Report and ETL Connectors. These options allow you to configure multiple dialects (by Selecting Source Server Type for lineage) and connection priority lists to pick the tables to build lineage. |
| Access Instruction        | Access Instruction allows the data owner to instruct other users on using the objects in the application.                                                                                                                                                                                          |

**Note:** For more information, refer to the [Connector Settings.](https://support.ovaledge.com/connector-settings)

### **The Crawling of Schema(s)**

The user can use the **Crawl/Profile** option, which allows the user to select the specific schemas for the following operations: crawl, profile, crawl & profile, or profile unprofiled. For any scheduled crawlers and profilers, the defined run date and time are displayed to set.

1. Navigate to the Connectors page, and click **Crawl/Profile** option.
2. Select the required Schema(s).&#x20;
3. Click on the **Run** button that gathers all metadata from the connected source into OvalEdge Data Catalog.&#x20;

**Note:** For more information on Scheduling, refer to [Scheduling Connector](https://support.ovaledge.com/how-to-schedule-connectors)

## **Authentication using Active Directory**

This document describes the Active Directory authentication with OvalEdge.&#x20;

Steps&#x20;

1. Navigate to **Security** > Right-click **Authentication**, and click New resource > **Namespace**.
2. Type a name for your authentication namespace in the Name box.
3. In the Type drop-down list, select **Active Directory** and then click OK.
4. The new authentication provider resource appears in the Explorer window under the Authentication component.
5. In the Properties window, for the Namespace ID property, specify a unique identifier for the namespace.
6. Specify the values for all other required properties to ensure that IBM Cognos components can locate and use your existing authentication provider.
7. Specify the values for the Host and port property.

## **About IBM Content Manager**

Overall, IBM Cognos Content Manager is a powerful reporting solution that enables organizations to easily create, manage, and distribute reports while ensuring the accuracy and consistency of their reporting content.

Users can go to Data Access Menu > Content Manager and select Oracle.&#x20;

A snapshot of the Oracle database in Content Manager.&#x20;

**Note:** Apart from the Oracle database, many other databases can be configured in Content Manager, such as MySQL and SQL servers with their respective JARs installed.

***

Copyright © 2025, OvalEdge LLC, Peachtree Corners GA USA
