OneCloud

Oracle Essbase

The OneCloud BizApp for Oracle Essbase streamlines the integration and management of on-premise Essbase cubes with other systems that co-exist in the cloud. OneCloud provides easy out-of-the-box commands to orchestrate important Essbase operations including high-speed data load and extract, execution of calculations and management of system settings. When combined with OneCloud's support for other technologies, the cloud suddenly becomes seamless from an application perspective.

For documentation on all available commands, see the Oracle Essbase Command Reference.

Connection Setup

OneCloud connects to Oracle Essbase via the published Java API. The OneCloud BizApp for Oracle Essbase is compatible with all versions 11.x and greater of Essbase. If you require support for earlier versions of Oracle Essbase (i.e. 7.x or 9.x), please contact support@onecloud.io.

To automate functionality within your Oracle Essbase environment from OneCloud, you'll need to navigate to the connection manager to create a connection.

This connection requires a OneCloud GroundRunner. Learn more about the GroundRunner Configuration

From here, choose Oracle Essbase from the service drop-down and select the appropriate Runner. Now, enter values for the following fields:

Input
Type
Detail

User Name

TextField

Essbase user name

Password

TextField

Essbase Password

Instance URL

TextField

The base URL of your Essbase Instance. In many cases, it may just be an IP address, proceeded by the proper protocol (i.e. http://100.0.0.1). In other cases, it might be the URL for your APS service (i.e. http://100.0.01:19000).

Cluster Name

TextField

Name of the Essbase cluster to which you are connecting. Essbase will call this "EssbaseCluster" by default.

Java API Path

TextField

The path to your Essbase JAR files. These files are installed by default in your Essbase directory, and the path will contain "EssbaseJavaAPI\VERSION". The full path to the directory containing the .jar files is required.

Oracle Essbase requires access to the following Essbase client JAR files:

  • ess_es_server.jar
  • ess_japi.jar
  • ess_maxl.jar

These files can be located where Oracle Essbase is installed and the default location is as follows:

  • Microsoft Windows: C:\Oracle\Middleware\EPMSystem11R1\common\EssbaseJavaAPI\11.1.2.0\lib
  • Linux: /User/<username>/Oracle/Middleware/EPMSystem11R1/common/EssbaseJavaAPI/11.1.2.0/lib

Configure a OneCloud GroundRunner to interact with Essbase on the same server

If the installation of GroundRunner is on the same server other than is hosting Oracle Essbase, then simply set the Java API Path to the folder location of the Essbase client Jar files.

Configure a OneCloud GroundRunner to interact with a remote Essbase server

If the installation of GroundRunner is on a different server other than is hosting Oracle Essbase, then copy these files to a new folder on the server that hosts the GroundRunner and set the Java API Path to this folder.

Connection Example

Troubleshooting

No output received when running a command

Issue
An Essbase command is executed and the output is blank.

Suggestion
The OneCloud Essbase BizApp requires a Java Runtime Environment (JRE). Please be sure to install a compatible such as Oracle JRE 1.8.x.

Receive a Java No Class Found Error

Issue
Receive the following error Exception in thread "main" [] false} stdErr="java.lang.NoClassDefFoundError: com/essbase/api/base/EssException"

Suggestion
Please be sure to follow the connection setup that requires the Essbase JAR files.

Cannot connect to Provider Services

Error
Error: com.essbase.api.base.EssException: Cannot connect to Provider Server. Make sure the signon parameters are correct and the Provider Server is running. Error authenticating with Essbase: Cannot connect to Provider Server. Make sure the signon parameters are correct and the Provider Server is running.

Suggestion

  1. Ensure that the specified server name is correct and is the provider server. Please do not use the IP address and port number of your Essbase server unless they are on the same operating environment.
  2. Ensure that the specified port number is correct. The default port for provider services is 19000.

Cannot connect to OLAP Service

Error
Error: com.essbase.api.base.EssException: Cannot connect to olap service. Cannot connect to Essbase Server. Error:Essbase Error(1042003): Network Error [11001]: Failed to retrieve name information for [Essbase-Cluster1] Error authenticating with Essbase: Cannot connect to olap service. Cannot connect to Essbase Server. Error:Essbase Error(1042003): Network Error [11001]: Failed to retrieve name information for [Essbase-Cluster1]

Suggestion
Ensure that the Essbase cluster name is correct. In the error message above, the connection is able to communicate with Essbase, but the connection is being rejected since the cluster name is not correct.

Oracle Essbase


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.