Installing the Connector for Oracle Essbase

In order to retrieve data from Oracle Essbase, you have to install its connector.

The Oracle Essbase API provides two modes of connecting to Essbase servers. The section Multidimensional Data Sources to Oracle Essbase of the Virtual DataPort Administration Guide provides more information about these modes.

The set of drivers you have to install, depend on the connection mode used:

  1. Three-tier APS mode: obtain the ess_japi.jar.

  2. Embedded mode: check the Administration Guide of Oracle Essbase to obtain the list of jars that a Java application needs to connect to Essbase in Embedded mode. Make sure that the version of the Essbase Administration Guide matches the version of your Essbase server because the jars required change depending on the release of Essbase you want to connect to.

After obtaining the appropriate jars, upload them to Virtual DataPort. Follow these steps to do this:

  1. Log in with the Administration Tool with an administrator account.

  2. Click the menu File > Extensions management.

  3. Click the tab Libraries and then, click Import.

  4. In the new dialog, in Resource type, select essbase.

  5. In Version, select the version you are going to upload.

  6. Click Add and select the file(s). To select more than one file, hold the key Ctrl and select each file.

  7. Click Ok to upload the file(s) to Virtual DataPort.

Requirements of the Essbase 11 Adapter

This section does not apply to you if you are using Denodo 8.0u20210715 or newer.

If you are using Denodo 8.0 GA or 8.0u20210209, to connect to Oracle Essbase 11.1.2.2 or newer, the user account in Essbase requires the role “manager (database)”. This is necessary to be able to introspect cubes. That is, to list the contents of the cubes during the process of creating base views. This user account needs this role because by default, the data source opens the outline of the cube.

If you are using Denodo 8.0 GA, you need to grant this role to the account you use to connect to Essbase.

If you are using 8.0u20210209, to be able to use a user account that does not have the role “manager (database)”, log in as an administrator and execute this command (you do not need to restart after this):

SET 'com.denodo.vdb.essbaseAvoidOpenOutline' = 'true';

With this change, the user account for Essbase only requires the role “read” because it does not open the outline of the cubes. Note that you still need the “execute” role as well to be able to execute queries.

If you are using 8.0u20210715, the Essbase data source no longer requires this user account to have the role “manager (database)”.