Getting Started With Oracle Essbase
Getting Started With Oracle Essbase
Release 21
F17138-10
December 2023
Oracle Essbase Getting Started with Oracle Essbase, Release 21
F17138-10
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software, software documentation, data (as defined in the Federal Acquisition Regulation), or related
documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S.
Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,
any programs embedded, installed, or activated on delivered hardware, and modifications of such programs)
and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end
users are "commercial computer software," "commercial computer software documentation," or "limited rights
data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental
regulations. As such, the use, reproduction, duplication, release, display, disclosure, modification, preparation
of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated
software, any programs embedded, installed, or activated on delivered hardware, and modifications of such
programs), ii) Oracle computer documentation and/or iii) other Oracle data, is subject to the rights and
limitations specified in the license contained in the applicable contract. The terms governing the U.S.
Government's use of Oracle cloud services are defined by the applicable contract for such services. No other
rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle®, Java, MySQL and NetSuite are registered trademarks of Oracle and/or its affiliates. Other names
may be trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc,
and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
A Certification Matrix
System A-2
Client A-2
Browser A-3
Database A-4
Interoperability A-6
ID and Access A-6
iii
Accessibility and Support
4
1
What Is Oracle Essbase?
Oracle Essbase is a business analytics solution that uses a proven, flexible, best-in-class
architecture for analysis, reporting, and collaboration. Essbase delivers instant value and
greater productivity for your business users, analysts, modelers, and decision-makers, across
all lines of business within your organization.
Topics:
• About Oracle Essbase
• Features of Oracle Essbase
• Overview of Latest Oracle Essbase Platform
• Use Case Examples
1-1
Chapter 1
Features of Oracle Essbase
and migration, and can also distribute application templates throughout your
organization without compromising ease of use or self-service options. The
software provides flat-file, Excel-based, and SQL-based import and export.
• Rapid Deployment
With latest Essbase 21c independent deployment release, you can deploy Oracle
Essbase with a stand-alone installer and configuration tool.
When using Oracle Essbase on Oracle Cloud Infrastructure via Marketplace
allows you to quickly deploy relevant Oracle Cloud Infrastructure stack
components to get started using Essbase. You don't have to buy, install, or
configure hardware on-premises. With quick deployment, you can deploy
database, storage, and required network infrastructure components.
Using the new application workbook upload, you can also leverage the deep
product expertise of the worldwide Oracle Hyperion Partner network and the
Essbase gallery templates to quickly develop and deploy cloud-based analytic
models.
• Portability
When using the Essbase 21c independent deployment release, you can migrate
your Essbase users and applications and take advantage of the latest Oracle
Essbase features.
If you’re an existing Essbase customer, you can choose to leverage its built-in
migration capabilities to port your on-premises or cloud applications to Oracle
Essbase on Oracle Cloud Infrastructure via Marketplace. Migrating to the cloud
enables your organization to extend Oracle Essbase usage across the enterprise
to other lines of business, without additional demands on your IT resources,
hardware, personnel or budget.
1-2
Chapter 1
Overview of Latest Oracle Essbase Platform
• Using Essbase on the cloud, with Oracle Cloud Infrastructure via Marketplace, you can
use Oracle Analytics data flows including ingestion, transformation, and persistence, to
create Essbase applications. You can also set up a private VCN to connect to on-
premises data sources.
Platform Features
Architecture — The Essbase 21c independent deployment architecture includes a middle-
tier platform that runs on WebLogic. This Fusion Middleware architecture enables fast
performance, optimized memory usage, high concurrency, flexible deployment options, and
failover.
Essbase on Oracle Cloud Infrastructure architecture utilizes OCI to enable the same benefits.
Both independent and cloud-based architectures utilize Oracle Database and/or your choice
of relational database to store Essbase schemas.
Query Engine — Hybrid mode is the default query engine for block storage cubes, providing
robust dependency analysis and fast aggregation. Hybrid mode has fewer limitations than it
did in Release 11g, handles more calculations, and is enhanced with several tuning options.
Failover — In Essbase 11g, Provider Services enabled failover leasing managed through
OPMN. Today, on Essbase 21c independent deployments only, failover is integrated with
WebLogic to support a central request leasing system that determines which node is active
and which nodes are waiting on standby.
Security — In Essbase 21c independent deployments, all data is encrypted in transit layer
using Transport Layer Security (TLS) 1.2. You can implement a load balancer. In
deployments of Essbase on Oracle Cloud Infrastructure, you can implement public or private
subnets, policies, firewalls, and other network security options available in Oracle Cloud
Infrastructure.
For user authentication, you can choose WebLogic Embedded LDAP in conjunction with your
choice of external authentication provider, or, if you already use EPM Shared Services
security, you can continue to use it with Essbase 21c independent deployments only.
Authentication using Identity Cloud Service (IDCS) is an option if you are deploying Essbase
on Oracle Cloud Infrastructure via Marketplace.
There are three Essbase user roles: User, Power User, and Service Administrator.
Application permissions, granted separately, are Application Manager, Database Manager,
Database Update, and Database Access. All roles from EPM Shared Services can be
mapped to the new roles and permissions, or, you can continue to use EPM Shared Services
(Essbase Essbase 21c independent deployments only).
Essbase filters help you implement fine-tuned, cell-level access controls to your cubes. Using
dynamic filters with built in functions/variables, you can make filters extensible and adaptible
1-3
Chapter 1
Overview of Latest Oracle Essbase Platform
to a changing user base and real-time source data. You can use LoginAs to test the
filters in the administrative interface.
Administrative Interface —The Essbase web interface enables you to manage
applications, users/groups, and Essbase artifacts. It includes a rich outline editor,
scripting editors, a data analysis interface where you can save grid layouts, and a load
rules editor with built-in data previews. A centralized Jobs interface lets you initiate
requests, and monitor active and recent requests. Cube Designer and Smart View, as
well as utilities for migration, automation, and administration, are available to download
from the Console.
Essbase Administration Services Lite — Although the Essbase web interface is the
modern administration interface and offers the current platform features, a light version
of Essbase Administration Services (EAS) is a limited-support option for continued
management of your applications, in case your company is not ready to adopt the new
interface. The features and functionality of EAS are limited to what was available in
Release 11g and do not encompass the modern platform features.
Accelerated Development and Audit Capabilities — Calculation tracing lets you
monitor and debug calculation scripts. Query tracing can be used to monitor and
debug query performance. Audit trail enables you to track changes made to data.
Solve order can be adjusted while you're working in Smart View.
Automation and Developer tools — REST API helps you automate management of
hosted Essbase resources and operations over secured HTTP. Java and C API are
also available, as well as a new command line interface (CLI), the MaxL administrative
scripting language, Report Writer, and backward-compatibility support for the
ESSCMD command language.
Catalog — The Catalog is a central place to store files and artifacts associated with
Essbase applications and users. It includes user and shared directories, and an
instructive Gallery of sample cubes.
Gallery — Included in the Catalog is a Gallery of cube templates, in the form of Excel
application workbooks. You can easily import these workbooks to build a diverse
variety of sample cubes. The samples are instructional for learning about different use
cases for Essbase applications and features, as well as learning how to build and
design cubes from structured and unstructured workbooks.
Cube Designer — The Cube Designer extension for Excel is a client interface for
designing and building Essbase cubes from application workbooks. This interface
offers a flexible and portable cube design and administration system. Structured
workbooks simplify everyday cube design, optimization, and portability. Cube Designer
infers patterns found in unstructured workbooks, to help you shape raw data into
hierachically organized cubes.
Connectivity — Essbase APIs use TLS/SSL for secure connectivity both internally
between components and externally with other applications. You can connect from any
software using Essbase Runtime Client (RTC) over secure HTTP without needing to
open additional TCP/IP ports to enable client connectivity.
Connections and Datasources — Essbase administration tasks often require
connectivity to remote source data or hosts. With reusable connections and
Datasources, you no longer have to code the connection details into artifacts like rule
files or filters, or enter them each time you perform other connection-dependent tasks.
Analysis — You can perform ad hoc data queries/grid analyses on cube data from the
administrative Essbase web interface, as a built-in alternative to connecting via Smart
1-4
Chapter 1
Overview of Latest Oracle Essbase Platform
View. You can save your grid layouts, run report scripts, and run and save named MDX
queries.
Calculation — Essbase offers a rich library of calculation functions and commands to suit
most analytical applications, and you can add your own custom defined functions and macros
built using Java. Calculation tracing helps you analyze and debug calculation script
performance and member formula processing. Tuple-based calculation helps you optimize
and refine calculation scope, limiting it to focus on the active Smart View grid. Hybrid mode
calculation can be selected, and is enhanced with several tuning options.
MDX Insert and Export — In addition to MDX’s well-known utility as a multidimensional
query language, you can use its Insert and Export directives to shape, copy, move, and
update any custom slice of multidimensional data.
Aggregate Storage Calculation — You can use MDX Insert to perform custom calculations
and allocations. You can automate the creation and maintenance of default aggregate views.
Data Load and Dimension Build — The Essbase web interface load rules editor with built-in
data previews enables import of data and dimension from the Catalog or from outside
sources. Rule file columns can employ functions like Sum, Min, Max, Count, and Avg to help
you shape your import. SQL-based loading has improved performance. Batch Outline Editing
can be performed programatically from Java or REST API. Command-line interface (CLI)
supports streaming data load from a variety of sources. Aggregate storage data load
optimizations are added, including buffer, merge, and cache tuning options.
Drill Through — When you need more data than what you can see in the Essbase cube, you
can use drill through reports to access external data sources. Performance is improved for
drill through connections to Oracle Database. The flexibility of drill through report design is
improved, allowing diversified selection of multiple cells or ranges of cells. Selections can be
recursive, non-recursive, level 0, contiguous, or non-contiguous.
Scenario Management — Scenario management offers the ability to build private work
areas or “sandboxes” in which users can model different assumptions within the data to see
the effect on aggregated results, without affecting the cube.
Shadow Applications — To perform cube modifications and restructures with limited down
time, you can create a shadow application that is a copy of the primary application. The
primary application continues to serve read-only operations, such as queries, while you
perform modifications on the shadow application. You can make the shadow application
visible or hidden. For more information, see the Create Shadow Application endpoint in the
REST API.
Configuration — Most configuration parameters you need for application tuning should be
set per application, using the Essbase web interface. If you install Essbase 21c on
independent deployments, you also have control of the system wide configuration defaults in
essbase.cfg, if needed.
Logging — Logs are in Oracle Diagnostic Logging (ODL) format. You can download log files
from the Essbase web interface. You can use Performance Analyzer to analyze Essbase logs
to generate usage and performance statistics.
Migration, Backup/Restore— Lifecycle Management Utility (LCM) makes it easy to migrate
on premise applications across Essbase releases and host servers. An additional migration
utility that helps migrate users and groups is also available to download from the Console.
For deployments on Oracle Cloud Infrastructure, you back up your Essbase stack using the
infrastructure.
1-5
Chapter 1
Use Case Examples
1-6
2
How Do I Get Started?
Here are some steps and information to help you get started.
Topics:
• Differences Between Essbase Deployment Options
• Installing Oracle Essbase on Independent Deployments
• Deploying Oracle Essbase on Oracle Cloud Infrastructure via Marketplace
• Using Oracle Essbase
• Oracle Learning Library
• Oracle Essbase Accessibility
2-1
Chapter 2
Deploying Oracle Essbase on Oracle Cloud Infrastructure via Marketplace
2-2
Chapter 2
Oracle Learning Library
For information on user roles and permissions, see Understand Your Access Permissions in
Essbase.
2-3
Chapter 2
Oracle Essbase Accessibility
Keys Actions
Shift + up arrow key To enter to the first cell inside grid and to get
the focus out of the grid (in both Ad Hoc
Analysis and Reports tabs).
Shift + Ctrl + up arrow key Launch the context menu.
Keys Actions
Ctrl+Alt+Enter Move the cursor to the element previous to the
script editor.
Ctrl+Enter Move the cursor to the element after the script
editor.
Keys Actions
CO Connections
CAT Catalog
LO Local
DP Designer panel
FE Formula editor
HV Hierarchy viewer
2-4
Chapter 2
Oracle Essbase Accessibility
Keys Actions
BC Build cube
LD Load data
CAL Calculate
AN Analyze
VJ View jobs
TD Transform data
OP Options
HE Help
AT Admin tasks
CS Currently selected
Designer Panel
The designer panel keyboard equivalents work only when the cursor is on the designer panel.
If the cursor is on the worksheet, then press F6 + Tab to move the cursor to the designer
panel and use the panel equivalents.
Keys Actions
Ctrl + Alt + F From sheet
Ctrl + Alt + T To sheet
Ctrl + Alt + R Reset
Ctrl + Alt + S Sync
Menu (or right click) When a dimension from the dimensions list is
selected, opens the dimensions context menu
Keys Actions
Ctrl + U Upload to Essbase
Enter Enter folder or download file
Ctrl + X Select a file to be moved to another location
Ctrl + C Select a file to be copied to another location
Ctrl + V Paste a file
Del Delete a file or files
F2 Rename the selected file or folder
F5 Refresh
Ctrl + Shift + N Create a new folder
Ctrl + A Select all items
Left and right arrows Toggle focus between the catalog and the files
area
Backspace Navigate to parent folder
Menu (or right click) Opens file context menu
2-5
Chapter 2
Oracle Essbase Accessibility
Keys Actions
Ctrl + 1 Focus on member tree
Ctrl + 2 Focus on formula content
Ctrl + 3 Focus on function tree
Ctrl + A Select all text
Ctrl + V Paste file
Alt + V Validate formula
Alt + S Save formula
F3 Search
Ctrl + Tab Tabular spacing
Enter Add a new line to the formula content, or, if
focused on the function list, insert the selected
item into the formula
Keys Actions
F2 Rename member
F3 Find next (according to search term)
F5 Reload
Menu (or right click) Opens member context menu
Optimize Cube
Keys Actions
Esc Ends analysis operation
Job Manager
Keys Actions
Del Deletes a job from the table
Transform Data
Keys Actions
Menu (or right click) Opens the member context menu
2-6
Chapter 2
Oracle Essbase Accessibility
2-7
A
Certification Matrix
This matrix provides certification for: Oracle Essbase 21c independent deployments (where
you download software from Oracle Software Development Cloud and then install and
configure setup) and for Oracle Cloud Infrastructure (OCI) via Marketplace (where you deploy
Essbase, from the OCI Console, using Marketplace listings).
For interoperability and compatibility information, see Understanding Interoperability and
Compatibility at https://docs.oracle.com/en/middleware/fusion-middleware/12.2.1.4/intop/
toc.htm.
• System Certification
• Client Certification
• Browser Certification
• Database Certification
• Interoperability
• Identity and Access Management
Note:
Conventions in this matrix:
• The phrase "and higher" after a version number indicates that this version and
all higher versions are certified. For example, "21.1 and higher" means 21.1,
21.1.1, 21.1.2, 21.2, 21.3, 21.4, 21.4.2, and so on.
• The use of an "x" after a version number indicates that this version, and all
higher versions at that decimal level, are certified. For example, "Release
21.1.x" means 21.1.0.0.0, 21.1.1, 21.1.2, and so on - only versions of 21.1
decimal level, and not 21.2 or higher.
• Any exceptions are noted in the Notes column.
Note:
Regarding Virtualization - for independent deployments only:
Oracle Essbase is mainly certified against the Operating System (OS) and not a
specific virtualization technology. If an OS vendor releases a newer OS version,
along with a complementary virtualization and/or partitioning technology, the
support of this new combination depends on the new OS being certified
• by Oracle
• by virtualization technology provider
A-1
Appendix A
System
System
This matrix provides certification for Oracle Essbase (Plus) 21c independent
deployments and Oracle Cloud Infrastructure (OCI) via Marketplace.
For interoperability and compatibility information, see Understanding Interoperability
and Compatibility at https://docs.oracle.com/en/middleware/fusion-middleware/
12.2.1.4/intop/toc.htm.
Independent Deployments
Notes:
• Oracle App 64 bit support for all Oracle Essbase versions.
• Note 1: If running on Oracle VM, Oracle VM 3.3.1 and higher is supported.
• Note 2: For Oracle Unbreakable Enterprise Kernel Release 4 on Oracle Linux 7,
UL 1 or higher is required.
• Note 3: For Linux 8, install libnsl.so.1, with the assistance of your Linux System
Administrator, if not installed by default. EAS lite requires this file.
Note:
Oracle App and JDK 64 bit support for all Oracle Essbase versions.
OCI Deployments
For Release Notes deployments listings on OCI, see OCI Marketplace Deployment.
Client
This matrix provides certification for Oracle Essbase (Plus) 21c independent
deployments and Oracle Cloud Infrastructure (OCI) via Marketplace. For JDK
supported versions, see supported versions on the System page of the Certification
Matrix.
A-2
Appendix A
Browser
Browser
This matrix provides certification for Oracle Essbase (Plus) 21c web user interface
independent deployments and Oracle Cloud Infrastructure (OCI) via Marketplace.
The following are the browser software supported versions for the Essbase web interface:
• Safari
• Edge
• Chrome
• Firefox
Please see Oracle Software Web Browser Support Policy (Doc ID 2092205.1) for more
details.
A-3
Appendix A
Database
Note:
For all of the above, browser support is no longer based on operating
systems, but strictly tied to the browser themselves, no matter operating
systems on which they are installed.
Database
This matrix provides certification for Oracle Essbase (Plus) 21c independent
deployments and Oracle Cloud Infrastructure (OCI) via Marketplace.
Target Database for RCU
Notes:
• ,
• Note 1: The latest available Autonomous database on OCI (ATP) will be deployed
in case users do NOT select the “USE EXISTING DATABASE” option at the time
of deployment of the stack.
• Note 2: If OCI DB System is used, Essbase compute and Database (OCI or
Autonomous) should be in the same Region.
• Note 3: Bare Metal and VM databases are supported. Exadata is not supported in
21.4 and higher, as it is no longer supported in OCI provisioning and with
Terraform.
• Note 4: Both serverless and dedicated are supported.
Platform SQL
Platform SQL refers to performing a data load or dimension build using the
Connections and Datasource constructs. The database used in Platform SQL should
be network accessible, if you're not using the CLI or REST streaming options.
A-4
Appendix A
Database
Direct SQL
Direct SQL allows users to connect to the data sources by direct SQL in rules files.
Notes:
• *Database column notes for Direct SQL:
– Oracle databases listed in Database column are supported on all platforms supported
on this page.
– For all Oracle configurations: Single instance, RAC, XA, and DR are supported.
– Oracle DB XE is not supported.
– Oracle recommends using latest Oracle DB PSU's.
– Essbase uses ODBC 8.0.2; see related ODBC documentation: https://
www.progress.com/odbc.
– For latest recommended patch information, see Oracle Support.
A-5
Appendix A
Interoperability
Interoperability
This matrix provides certification for Oracle Essbase (Plus) 21c independent
deployments and Oracle Cloud Infrastructure (OCI) via Marketplace.
For Interoperability and Compatibility information, see Understanding Interoperability
and Compatibility at https://docs.oracle.com/en/middleware/fusion-middleware/
12.2.1.4/intop/toc.htm.
For Oracle Smart View support versions, see Supported Platforms Matrices
For Oracle Smart View for Office (Mac and Browser) requirements, see:
• Working with Oracle Smart View for Office (Mac and Browser): Supported Data
Source Providers
• Deploying and Administering Oracle Smart View for Office (Mac and Browser):
Prerequisites
ID and Access
This matrix provides certification for Oracle Essbase (Plus) 21c independent
deployments and Oracle Cloud Infrastructure (OCI) via Marketplace.
Directory Services and User Directories
A-6
Appendix A
ID and Access
Notes:
• Note 1: WebLogic Embedded LDAP is provided and is not recommended for production
use cases.
• Note 2: All security providers supported are based on the WebLogic security mode. For
details, see: https://www.oracle.com/middleware/technologies/fusion-certification.html
• Note 3: For independent deployments only. For EPM Shared Services Security, see
"Non-Oracle ID and Access Mgmt" in the 11.1.2.x / 11.2.x Certification Matrix available
here: https://www.oracle.com/middleware/technologies/bi-foundation/hyperion-supported-
platforms.html. EPM products are governed by the Life Time Support Policy here: https://
www.oracle.com/us/assets/lifetime-support-applications-069216.pdf, the "Premiere
Support End" date for EPM 11.1.2.4.x release is Dec 2021.
• Note 4: Support only for Shared Services and Oracle Essbase instances that are running
on the same platform. Cross platform support is not certified.
Access Management
A-7