Table of Contents:
This document includes important, late-breaking information about this release of Oracle Essbase Studio. Review this Readme thoroughly before installing Essbase Studio.
See the Oracle Essbase Studio New Features. For new features relating to installation, architecture, and deployment changes in this release, see “New Features” in the Oracle Enterprise Performance Management System Installation and Configuration Readme.
Late-breaking information about installation of Oracle Enterprise Performance Management System products is provided in the Oracle Enterprise Performance Management System Installation and Configuration Readme. Review this information thoroughly before installing EPM System products.
Information about system requirements and supported platforms for EPM System products is available in a spreadsheet format in the Oracle Enterprise Performance Management System Certification Matrix. This matrix is posted on the Oracle Fusion Middleware Supported System Configurations page on the Oracle Technology Network (OTN):
Information about supported languages for EPM System products is available in a spreadsheet format on the Translation Support tab in the Oracle Enterprise Performance Management System Certification Matrix. This matrix is posted on the Oracle Fusion Middleware Supported System Configurations page on OTN:
You can upgrade to EPM System Release 18.104.22.168 from the following releases:
For instructions to upgrade, see the Oracle Enterprise Performance Management System Installation and Configuration Guide, "Upgrading EPM System Products."
Table 1. Supported Paths to this Release
|Release Upgrade Path From||To|
When moving from Release 22.214.171.124.x or 126.96.36.199.x to Release 188.8.131.52, you use the "Apply Maintenance Release" option in Oracle Hyperion Enterprise Performance Management System Installer, instead of following the documented upgrade procedures.
For Oracle Hyperion Financial Close Management, applying the maintenance release is supported only from Release 184.108.40.206.
An environment that includes multiple releases, which can include an environment with one instance of Oracle Hyperion Shared Services or an environment with two instances of Shared Services
See “Upgrading from an Environment with Multiple Releases” in the “Upgrading EPM System Products” chapter in the Oracle Enterprise Performance Management System Installation and Configuration Guide.
If you are starting from Release 220.127.116.11+, 9.3.0.x, 9.3.1.x (except for Oracle Essbase 18.104.22.168.1, 22.214.171.124, 126.96.36.199, and 188.8.131.52), or 11.1.1.x, Oracle recommends that you upgrade to Release 184.108.40.206 as your interim release. If you are starting from an earlier release, Oracle recommends that you upgrade to the highest level release that directly supports upgrade from your starting release. Security Synchronization between Essbase and Shared Services was removed in Essbase Release 9.3, starting with Release 220.127.116.11.1. Essbase and Shared Services Release 18.104.22.168, however, still synchronize security information. For this reason, if you are using Essbase Release 22.214.171.124.1, 126.96.36.199, 188.8.131.52, or 184.108.40.206, you must first upgrade all products to Release 9.3.3, instead of Release 220.127.116.11.
If you are coming from Release 18.104.22.168, 22.214.171.124, or 126.96.36.199.102, use the Defects Fixed Finder tool to review the list of defects fixed between those releases and Release 188.8.131.52. This tool is available here:
12735687 -- After deploying an Essbase application from Oracle Hyperion EPM Architect and viewing the outline in Administration Services Console, the order of shared members in the accounts dimension were changed.
Note that starting with this release, the Clear Metadata check box in the Deploy dialog of Performance Management Architect is removed. This means that all dimensions, including the accounts dimension, are automatically rebuilt with each redeploy.
13346939 -- The Custom data load settings button is disabled when a model contains user-defined tables, text measures, or calendar hierarchies.
13490998 -- After logging out of and logging back into Essbase Studio Console, left, right, and full outer joins are not displayed in a minischema.
Support for outer joins (left, right, and full) for most data sources has been added in this release. Use the minischema to define or redefine join cardinality.
MySQL data sources do not support full outer joins.
13041135 -- When attempting to delete an alias set, an error occurs if an alias set with the same name exists in a different folder and one of those alias sets is associated with one or more Essbase models. Also, if you attempt to delete a metadata folder that contains a duplicate-named alias set, the folder contents will not be completely deleted.
Workaround: Whether you are deleting an individual alias set or a metadata folder, give a unique name to any duplicate-named alias set, and then delete the alias set or metadata folder.
13521216 -- Select statements containing columns of the NCHAR or NVARCHAR data type return an error.
In this release, the list of relational data types supported by Essbase Studio is extended. The SQL data types NCHAR and NVARCHAR are now associated with the string data type in Essbase Studio.
13356806 -- Alias sets that are created in folders other than the Root folder (of the Metadata Navigator) do not appear in the Alias tab of the Edit Properties dialog box for the associated dimension element.
Note that the Alias tab is a display-only dialog box; the alias set will still work properly.
13366975 -- When performing an incremental update of a data source connection, if the first object in the connection is a user-defined table, an exception occurs on Essbase Studio Server.
9196670 -- When performing catalog import/export, minischemas are not imported or exported along with data source connections.
Note that in this release, minischemas become part of individual data source connections and can be imported and exported along with other metadata elements. See the Oracle Essbase Studio New Features guide for more information.
11781604 -- The canonical host name of Essbase Studio Server is not stored in an Essbase outline; a general host name is stored instead. The stored Essbase Studio Server host name is used to connect to Essbase Studio from Oracle Hyperion Provider Services and Oracle Hyperion Smart View for Office. Thus, if the canonical machine name where Essbase Studio Server and Provider Services are hosted contains a period ( . ), the cube linkage for the cube must be manually reset after each redeployment before any drill-through reports can be executed from Smart View.
11793745, 11830011 -- Drill-through reports cannot be displayed in Smart View for Essbase cubes deployed from Essbase Studio if the underlying Essbase model name contains non-ASCII characters.
11886510 -- For deployments from Performance Management Architect, attribute values associated with a ragged base dimension may not be loaded properly.
12385131 -- Upgrading from 11.1.2 to 184.108.40.206 causes the Essbase Studio catalog database to be out of sync with Essbase Studio Server.
After applying the 220.127.116.11.000 patch, the catalog version is not synchronized with the current version of Essbase Studio Server. To synchronize the catalog, execute the reinit command from the Essbase Studio command line client. The reinit command is described in the Oracle Enterprise Performance Management System Installation and Configuration Guide.
12587204 -- Migrating the catalog from a pre-11.1.2.x release to an 11.1.2.x release fails when the deployment history in the catalog database is too large.
You can now run a new command, cleanModelHistory, from the Essbase Studio command line client. This command clears deployment history from the Essbase Studio catalog.
See the “Clearing Deployment History” topic in this readme for information on using the cleanModelHistory command.
12661093 -- Errors result from deployments using the MaxL deploy statement when there are mixed hierarchies, such as chains containing hand-typed members on the upper levels, and dimension elements as the lower levels.
12703695 -- Essbase Studio Server is not handling redeployment from Oracle Hyperion EPM Architect when the accounts dimension is altered between deployments.
12797137 -- The “Never Consolidate” option (^) is not allowed on models that are enabled for aggregate storage.
12810562 -- Deployment fails when using the MaxL “deploy” statement on Windows 64-bit platforms.
12884358 -- If you are starting from an a pre-11.1.2.x environment and have installed and configured Essbase Studio 11.1.2.x, the models containing varying attributes with forward dependencies are not upgraded correctly. Forward dependent dimensions are when the dimensions containing varying attributes come before the independent dimension in terms of dimension order in the model.
13521216 -- Essbase Studio does not support the data source column data types NCHAR and NVARCHAR.
N/A -- Integration Services catalog migration is not supported on 64-bit UNIX platforms or on the Windows 2008 64-bit platform.
N/A -- Oracle Essbase Spreadsheet Add-in for Excel works in native locale. If Spreadsheet Add-in does not receive data in native locale, drill-through on cubes built in Essbase Studio is not supported.
N/A -- Transformation rules defined in the Essbase model will not be used in query generation for drill-through operations.
Workaround: You may edit the expressions for the dimension element's caption binding to transform members.
N/A -- If Oracle is your catalog database: Essbase Studio no longer issues the ALTER SYSTEM command when connecting to the catalog database. For increased performance, add the ALTER SYSTEM statement to the Oracle database user's privileges for the Essbase Studio catalog user.
Following are the recommended settings:
ALTER SYSTEM SET open_cursors=300 SCOPE=MEMORY
The catalog user is specified in the server.properties file during configuration and should have the privileges necessary to execute the ALTER SYSTEM statement.
6576813 -- The JISX0213 Japanese character set, which replaces the JISX0208 and JISX0212 Japanese character sets, is supported on Windows Vista. The Essbase family of products does not support the JISX0213 Japanese character set.
7138321 -- You cannot deploy an XOLAP-enabled Essbase model that is based on an Oracle Business Intelligence Enterprise Edition data source.
7366645 -- When using Smart View or Spreadsheet Add-in to query cubes built in Essbase Studio, if the intersection for a drill-through cell is represented by both a base member and one or more associated attribute members, you cannot perform drill-through on that cell.
Specifically, drill-through will not work on an intersection (cell) that is represented by members of a base dimension and members of attribute dimensions.
When specifying intersections for a drill-through report in Essbase Studio, do not specify both the base and attribute hierarchies from a multichain hierarchy. Select only one of the hierarchies for drill-through.
If you require drill-through from an intersection containing a base member and attribute members, you must build the cube using Oracle Essbase Integration Services.
7665495 -- A 255-character limit applies to certain objects that you name in Essbase Studio. These objects are:
Data source connection names
User-defined table names
Metadata element names, such as dimension elements and hierarchies
Cube schema names
Drill-through report names
These are the limits on Essbase application and database names:
8 bytes for non-Unicode
30 characters for Unicode
8661977 -- When deploying a cube for the first time, and the cube contains text or date measures, the data is loaded correctly. Upon subsequent deployments of the cube, selecting the "Load data" option along with either the "Add to existing data" or "Subtract from existing data" option, results in incorrect data.
Workaround: Use custom data load SQL to selectively load data on numeric measures only, omitting any text or date measures.
8897922 -- When migrating an OLAP metaoutline from Integration Services to Essbase Studio, members in a hierarchy may not be sorted properly in the deployed Essbase cube if both transformation and sorting rules are defined on the original Oracle Essbase Integration Services member set. In Essbase Studio, performing transformation in Essbase Model Properties does not resolve the issue.
Workaround: Perform transformation in the Dimension Element Properties dialog box by editing the key binding expression of the dimension elements.
8908738, 7127257 -- Microsoft Windows authentication is not supported for data source connections to Microsoft SQL Server.
9315569 -- The labeling rules listed in the Editing Labeling Rules dialog box were not translated and appear in English for all languages.
The Editing Labeling Rules dialog box is accessed from the Time Depth area of the Calendar Hierarchy dialog box, as described in "Defining Time Depth" in the Oracle Essbase Studio User's Guide.
9325297 -- Varying attributes do not support NULL values in the "FROM" or "TO" columns of the "history" table. When working with varying attributes, if the history table contains rows with a NULL value in either the FROM or TO columns, then the attribute values from these rows are not built into an attribute dimension.
Workaround: Ensure that there are non-NULL values in the FROM and TO columns of the history table. For more information on history tables, see “Setting Up a History Table for Varying Attributes” in the Oracle Essbase Studio User's Guide.
9326364 -- If two independent dimensions have the same leaf member name for one varying attribute, deployment fails with the error, "Duplicate name of the field in the query."
For example, suppose there is a varying attribute dimension, "VARYPER," and two independent dimensions, "Period" and "Year." If the leaf member name is the same for both "Period" and "Year" in the Essbase Model Properties, Independent Dimension Binding dialog box, the deployment will fail.
Workaround: Rename the column for the physical relational table that will be used for the leaf member name. If that is not possible, you can create a user-defined table with the different column name and build the second independent dimension based on a column in the user-defined table.
9364712 -- When deploying cubes in nonstreaming mode (the Enable streaming mode for cube deployment check box is cleared), deployment fails when the Essbase model is based on a Unicode data source.
Use streaming mode: In the Cube Deployment Wizard, ensure that the Enable streaming mode for cube deployment check box is selected.
Use nonstreaming mode with the data source enabled for N-CHAR support:
First, create a DSN and enable the N-CHAR support option as follows:
On Windows, use the ODBC Data Source Administrator to create a DSN with the Enable N-CHAR Support option selected. This option is found on the Advanced tab of the ODBC driver setup dialog box.
On UNIX or Linux, edit the odbc.ini file to create a new DSN, and set the EnableNcharSupport value as follows:
Then, the Cube Deployment Wizard, complete these steps:
In the Essbase Server connection options page, select the ODBC (Enter ODBC DSN Name) option and provide the DSN you created.
In the Cube deployment options page, ensure that the Enable streaming mode for cube deployment check box is cleared.
See the Cube Deployment chapter in the Oracle Essbase Studio User's Guide for information on using the Enable streaming mode for cube deployment check box.
9433391 -- Deploying From Text File Data Sources
Cube deployment from text file data sources is always done in nonstreaming mode, regardless of how the server property, server.essbase.streamingCubeBuilding is set.
Essbase Studio Server uses the nonstreaming cube building method automatically for text file data sources; you will not be asked about or notified of this internal load method.
Cube deployment progress statistics are not supported on text file data sources.
9477466 -- In Smart View, when performing drill-through from an Essbase Studio-sourced cube to Oracle Hyperion Financial Data Quality Management, if the EPM System Single Sign-On token expires before the sessions of all products involved expire (Workspace, Oracle Hyperion Provider Services, Essbase, Essbase Studio, Oracle Hyperion Financial Data Quality Management), the following message is displayed: “Error: An error occurred logging on to the system using single sign-on. Please contact your administrator. Error: 2067 - You do not have access to the application!”
Workaround: Log in again to Workspace from Smart View client.
9492526, 9502269-- On Windows, when Essbase is started using OPMN, cube deployment fails for cubes built from Oracle BI EE data sources if the option ODBC (Essbase dynamically creates ODBC connection string) is selected in the Cube Deployment Wizard.
Workarounds: For successful deployment, use one of the following workarounds:
In the Cube Deployment Wizard, specify an ODBC DSN for the OBI data source connection. See “Providing Connection Information for Cube Deployment” in the Oracle Essbase Studio User's Guide for more information.
Start Essbase Studio Server in streaming mode, then perform the deployment. In streaming mode, the server.essbase.streamingCubeBuilding property is set to “true.” See “server.essbase.streamingCubeBuilding” in the Oracle Essbase Studio User's Guide for information on this property.
9561925 -- Solaris only: Your machine likely has a network configuration problem if Essbase Studio Server fails to start, and either of the following messages appears in the server log file:
Cannot register server in catalog.
Network error prevented server registration check.
Workaround: Manually add a single, empty row to the cp_server_key table in the Essbase Studio catalog database.
9578741 -- During cube deployment, if the Essbase model that is being deployed or its underlying data source contains MBCS (Multi-byte Character Set) characters, the OCI data source setting option is not supported.
11663358 -- Cubes containing calendar hierarchies with day attributes do not correctly build during cube deployment as most of the day attributes are missing. (Related to bug 11696797.)
11696797 -- The day attributes of a calendar hierarchy are not all listed under the hierarchy in the Essbase Model Properties dialog. (Related to bug 11663358.)
12854605 -- Due to internal Essbase model changes that were implemented in Release 11.1.2, when performing an upgrade from a pre-11.1.2 release to 18.104.22.168, if a model has varying attributes, it will not be upgraded correctly.
Workaround: Before performing the upgrade, in the pre-11.1.2 environment, remove varying attributes from the Essbase models that contain them. After upgrade, recreate the varying attributes in the upgraded models.
13810033 -- Essbase Studio does not support IPv6 protocol on Microsoft Windows platforms. Essbase Studio supports IPv6 protocol only on UNIX platforms.
14155099, 14462547 -- Netezza Data Source for Essbase Studio. Unable to connect to a Netezza data source using non-streaming mode in Essbase Studio.
Workaround: In non-streaming mode, the connection to a data source is made by Essbase, not Essbase Studio. Data source drivers are specified in the Essbase configuration file (essbase.cfg). By default, some data source drivers are disabled by the presence of a semicolon (;) comment indicator at the beginning of the data source entry. In the following example, the Netezza driver is disabled.
BPM_Oracle_DriverDescriptor "DataDirect 6.1 Oracle Wire Protocol" BPM_DB2_DriverDescriptor "DataDirect 6.1 DB2 Wire Protocol" BPM_SQLServer_DriverDescriptor "DataDirect 6.1 SQL Server Native Wire Protocol" ;BPM_SQLServer_DriverDescriptor "SQL Server" ;BPM_Netezza_DriverDescriptor "NetezzaSQL" BPM_Teradata_DriverDescriptor "Teradata" ;BPM_ORACLEBI_DriverDescriptor "Oracle BI Server 11g_OHXXXX" ;BPM_ORACLEBI_DriverDescriptor "Oracle BI Server" BPM_MySQL_DriverDescriptor "DataDirect 6.1 MySQL Wire Protocol
Edit essbase.cfg to make sure that the data sources you are using are listed and are not disabled by the semicolon comment indicator.
The Netezza ODBC driver must be installed on the machine on which Essbase Server runs.
The Oracle Essbase Studio User's Guide (PDF and HTML format) contains an appendix entitled “Essbase Studio Limitations and Guidelines,” which describes various limitations you may encounter while working with Essbase Studio.
Also, refer to the Working with the Virtual Memory Setting section of this document for the latest information on limitations and guidelines.
If Essbase Studio Server fails to start, check the catalog.url property in the server.properties file to verify that the syntax is correct.
If the syntax is incorrect, Essbase Studio Server will not start. If the syntax is incorrect, open server.properties and edit the catalog.url property to correct the problem. Then restart Essbase Studio Server.
See the topic, “catalog.url” in the Oracle Essbase Studio User's Guidefor more information and examples.
The server.properties file is located in. Oracle/Middleware/user_projects/epmsystem1/BPMS/bpms/bin/server.properties.
If you used the “Apply Maintenance Release” option to move from Essbase Studio Release 11.1.2 or 22.214.171.124 to this release, you must update the Essbase Studio catalog after installation and configuration. You update the catalog by issuing the reinit command in the Essbase Studio command line client. For instructions, see the Oracle Enterprise Performance Management System Installation and Configuration Guide, “Updating the Essbase Studio Catalog.”
When working with Essbase models based on an Oracle BI EE Business Model data source, Oracle recommends that you enable the Duplicate member name support option. Selecting the Duplicate member name support option helps resolve member name collisions which are likely to occur in Oracle BI EE Business Model-based Essbase cubes.
You can generate a MaxL deploy statement by choosing options in the Cube Deployment Wizard and then saving your selections as a MaxL script.
When redeploying XOLAP cubes, if you then edit the Essbase Studio Server-generated MaxL to remove or change any deployment settings, data may not be consistent.
To redeploy an XOLAP cube, do not change the deployment settings by editing an Essbase Studio Server-generated MaxL script. Instead, Oracle recommends that you launch the Cube Deployment Wizard, make your required selections, then save those selections in a new MaxL script.
You can use the MaxL Deploy statement to load members and data into Essbase from a rules file that was created in Essbase Studio. The Deploy statement provides you with the simplest way to accomplish this task.
You may, however, choose to use the MaxL Import Dimensions statement to load members from an Essbase Studio-generated rules file. If you choose to use the Import Dimensions statement to build an outline, note that a problem exists when building an Accounts dimension either from the fact table or from a hierarchy containing only user-defined members. When this is the case, use the following workaround to successfully load the data.
Workaround: Prepare an empty dummy text file that can be called in the MaxL Import Dimensions statement. For example:
import database 'tbc.MaxL1' dimension from local text data_file 'C:\dummy.txt' using server rules_file 'Account' on error append to 'C:\Hyperion\textUn1.log';
Two port properties are used by Essbase Studio Server to communicate with Spreadsheet Add-in and Smart View. These are transport.port and server.httpPort. Changes to the port numbers specified in these properties will affect drill-through operations as described in the following sections.
After initial configuration using the Oracle Hyperion Enterprise Performance Management System Configurator, if the transport.port property in the server.properties file is changed manually, the following is the state of drill-through connectivity on cubes built prior to the port adjustment.
In Smart View, drill-through will not work properly. You must refresh the port number stored in the cube by following the instructions in “Updating Cube Linkage.” See the Oracle Essbase Studio User's Guide.
Cubes built after the port adjustment will work properly.
In Spreadsheet Add-in, drill-through will work properly.
If you add an entry for the server.httpPort property in the server.properties file to change it from the default setting of 9080, the following is the state of drill-through connectivity on cubes built prior to the port adjustment.
In Spreadsheet Add-in, drill-through will not work properly. In order to use drill-through with Oracle Essbase Spreadsheet Add-in on cubes built prior to the port adjustment, you must redeploy those cubes.
Cubes built after the port adjustment will work properly.
In Oracle Hyperion Smart View for Office, drill-through will work properly.
(9460997, 9480016, 10415849)
On the machine where Essbase Studio Console is running, you may increase the virtual memory setting within the limits specified by your operating system.
For example, on Windows 32-bit platforms, the maximum virtual memory setting is 2048 MB.
Instructions on virtual memory configuration are in “Configuring Virtual Memory” in the Oracle Essbase Studio User's Guide.
Table 2 summarizes how Essbase Studio Server, running in streaming or nonstreaming mode, integrates with Oracle BI EE Server, assuming that Essbase is managed by OPMN, and whether streaming or nonstreaming mode is supported for a particular operating system. Also, if further configuration must be completed, there is a reference to the appropriate substep in step 2; for example, step 2.a or step 2.b.
Table 2. Essbase Studio Server Integration with Oracle BI EE Server
Oracle BI EE Version
Nonstreaming Mode server.essbase.streamingCubeBuilding=false
Streaming Mode server.essbase.streamingCubeBuilding=true
Modify the essbase.cfg file. See step 2.b.
UNIX and Linux: Not Supported
Oracle BI EE ODBC driver has a conflict on common environment variables, such as ORACLE_HOME.
UNIX and Linux: Supported
See step 2.c.
10.1.3.4 or later
Requires the Oracle BI EE 126.96.36.199 ODBC driver installed on same machine as Essbase Server. See step 2.a.
UNIX and Linux: Supported
Manually modify opmn.xml to set the correct environment variables, which are different from 188.8.131.52. See step 2.d.
UNIX and Linux: Supported
10.1.3.3. or earlier
Windows: Not Supported
UNIX and Linux: Not Supported
See step 2.e.
UNIX and Linux: Supported
See step 2.e.
To complete any further configuration required by Table 2:
On Windows, in nonstreaming mode (server.essbase.streamingCubeBuilding=false in server.properties), Essbase Studio can deploy cubes from Oracle BI EE data sources version 10.1.3.4 or later, as long as the Oracle BI EE ODBC driver is version 184.108.40.206 and resides on the same machine as the Essbase Server.
Complete the steps below, as indicated in the preceding table, depending on your operating system, Oracle BI EE version, and whether you want to run Essbase Studio Server in streaming or nonstreaming mode:
BPM_ORACLEBI_DriverDescriptor "Oracle BI Server 11g_OHXXXX"
BPM_ORACLEBI_DriverDescriptor "Oracle BI Server 11g_OH449923612"
<variable append="true" id="LD_LIBRARY_PATH" value="/.../prod1/OracleBI/server/Bin"/>true id="LD_LIBRARY_PATH" value="/.../prod1/OracleBI/web/Bin"/> <variable id="SATEMPDIR" value="/.../prod1/OracleBIData/tmp"/> <variable id="SAROOTDIR" value="/.../prod1/OracleBI"/> <variable id="SA_ROOTDIR" value="/.../prod1/OracleBI"/> variable id="SADATADIR" value="/.../prod1/OracleBIData"/
For more information, see “(UNIX) Configuring the Environment for Essbase and Oracle BI EE Integration” in the Oracle Enterprise Performance Management System Installation and Configuration Guide.
On Windows, UNIX, and Linux, cubes may be deployed based on Oracle BI EE version 10.1.3.3 and earlier only if the server.essbase.streamingCubeBuilding property is set to streaming (server.essbase.streamingCubeBuilding=true).
ODBC driver configuration for Oracle BI EE running on UNIX is covered in the topic, “(UNIX) Configuring the Environment for Essbase and Oracle BI EE Integration,” in the Oracle Enterprise Performance Management System Installation and Configuration Guide.
When upgrading from Release 220.127.116.11, during configuration with EPM System Configurator, if the Configure Database task fails for Essbase Studio, review the upgrade log file for a message related to inconsistent object in the catalog, similar to this:
Caused by: com.hyperion.cp.cplutil.scripts.export_import.exceptions.ExportException: Inconsistent object in catalog. Please check the object form : \'Drill Through Reports'\'Supplier', object id : @44#0#101#0@.
Important: Be sure that your 18.104.22.168 release environment is running and available until the Essbase Studio catalog is successfully upgraded.
This error occurs when you rename data source connections which have drill-through reports dependent on them.
If there is an error related to inconsistent objects in drill-through reports, then one or more drill-through reports are invalid and must be corrected before you can upgrade Essbase Studio. Fix inconsistent drill-through reports (drill-through reports that depend on data source connections that have been renamed) by taking any of these actions:
In the 22.214.171.124 environment, rename the data source connections back to their original names.
Update the invalid drill-through reports by providing new column values and, optionally, filters, in the Report Contents tab of the drill-through report editor.
Delete the invalid drill-through reports from the 126.96.36.199 environment and then recreate them in the upgraded Essbase Studio environment, if needed.
Then, restart EPM System Configurator and rerun the Configure Database task.
When Essbase Studio Server is installed and configured as a Windows service, you cannot start it as a service using Windows authentication. In order configure Essbase Studio Server to take advantage of Windows authentication, you must do the following:
If already running, stop the Essbase Studio Server service.
Edit the catalog.username property in the Essbase Studio server.properties file as follows:
Do not add any user name or other text to the catalog.username property.
Start Essbase Studio Server using either the Start menu or the start_BPMS_bpms<instance>_Server.bat file.
If you are using an Oracle database with Essbase Studio, you may want to configure the associated Oracle JDBC drivers with Oracle Advanced Security. Click the following link for information on Oracle Advanced Security:
The most recent version of each EPM System product guide is available for downloading or viewing from the EPM System Documentation area of the OTN Web site (http://www.oracle.com/technology/documentation/epm.html). You can also use the EPM System Documentation Portal (http://www.oracle.com/us/solutions/ent-performance-bi/technical-information-147174.html), which also links to EPM Supported Platform Matrices, My Oracle Support, and other information resources.
Deployment-related documentation is also available from the Oracle Software Delivery Cloud Web site (http://edelivery.oracle.com/EPD/WelcomePage/get_form).
Individual product guides are available for download on the Oracle Technology Network Web site only.
Upgrading from releases prior to 188.8.131.52.000 will not migrate minischemas. However, minischemas can be manually recreated, and joins created in the previous release will be displayed. (17859852)
To configure Teradata as a data source:
Essbase Studio uses JDBC drivers. The JDBC Teradata driver must be installed on the computer on which Essbase Studio Server runs.
Essbase Studio uses the JDBC Teradata driver to deploy cubes in streaming mode.
To deploy cubes in non-streaming mode, the ODBC Teradata driver must be installed on the computer on which Essbase Server runs.
Essbase uses ODBC drivers. The ODBC Teradata driver must be installed on the computer on which Essbase Server runs.
<variable id="ESS_CSS_JVM_OPTION7" value="-Djava.util.logging.config.class=oracle.core.ojdl.logging.LoggingConfiguration"/>
<variable append="true" id="PATH" value="C:\Program Files\Teradata\Client\14.00\Shared ICU Libraries for Teradata\lib"/>
When using Teradata data sources with Essbase, and using OPMN to monitor and control the Essbase Agent process, you must update the opmn.xml file with variables for the operating system you are using.
The absolute path value cannot contain spaces. The examples of absolute path values are based on a 64-bit machine configuration.
Add these variables:
TWB_ROOT: Teradata root
PATH: Teradata shared libraries
PATH: Teradata client DLL libraries
PATH: Teradata Call-Level Interface Version 2 routines
PATH: Teradata message DLL libraries
64-bit Windows example:
<variable id="TWB_ROOT" value="C:\PROGRA~1\Teradata\Client\14.00"/> <variable append="true" id="PATH" value="C:\PROGRA~1\Teradata\Client\14.00\SHARED~1\lib"/> <variable append="true" id="PATH" value="C:\PROGRA~1\Teradata\Client\14.00\TERADA~1\bin64"/> <variable append="true" id="PATH" value="C:\PROGRA~1\Teradata\Client\14.00\CLIv2"/> <variable append="true" id="PATH" value="C:\PROGRA~1\Teradata\Client\14.00\TERADA~1\msg64"/>
Add these variables:
LIBPATH: Teradata ODBC libraries
LIBPATH: Teradata shared libraries
LIBPATH: ODBC components needed to load Teradata ODBC drivers
LIBPATH: Teradata client libraries
COPERR: Directory where the errmsg.txt file resides
NLSPATH: Teradata message libraries
64-bit AIX example:
<variable append="true" id="LIBPATH" value="/opt/teradata/client/ODBC_64/lib"/> <variable append="true" id="LIBPATH" value="/opt/teradata/client/13.10/tdicu/lib64"/> <variable append="true" id="LIBPATH" value="/usr/odbc/lib:/usr/odbc/drivers"/> <variable append="true" id="LIBPATH" value="/usr/lib:/usr/teragss/aix-power/client/lib"/> <variable id=" COPERR" value="/usr/libperion/essbase"/> <variable id="NLSPATH" value="/opt/teradata/client/13.10/odbc_32/msg/%N"/> <variable append="true" id="NLSPATH" value="/usr/lib/nls/msg/%L/%N"/> <variable append="true" id="NLSPATH" value="/usr/lib/nls/msg/%L/%N.cat"/>
Add these variables:
TWB_ROOT: Teradata root
TD_ICU_DATA: Teradata shared libraries
NLSPATH: Teradata ODBC message libraries
COPERR: Directory where the errmsg.txt file resides
COPLIB: Directory where the libcliv2.so library file resides
LD_LIBRARY_PATH: Teradata libraries
PATH: Teradata client directories
The errmsg.txt and libcliv2.so files typically reside in the same directory. Therefore, the value for the COPERR and COPLIB variables is typically identical.
64-bit LINUX example:
<variable id="TWB_ROOT" value="/opt/teradata/client/13.10/tbuild"/> <variable id="TD_ICU_DATA" value="</opt/teradata/client/13.10/tdicu/lib64> "/> <variable id="NLSPATH" value="</opt/teradata/client/13.10/odbc_64/msg/%N > "/> <variable append=true id=NLSPATH value=/opt/teradata/client/13.10/tbuild/msg64/%N/> <variable id="COPERR" value="/usr/lib64"/> <variable id="COPLIB" value="/usr/lib64"/> <variable append=true id=LD_LIBRARY_PATH value=/opt/teradata/client/13.10/tbuild/lib64/> <variable append=true id=LD_LIBRARY_PATH value=/usr/lib64/> <variable append=true id=PATH value=/opt/teradata/client/13.10/tbuild/bin/> <variable append=true id=PATH value=/opt/teradata/client/13.10/tbuild/lib64/>
Essbase: Use the Data Prep Editor in Administration Services Console to connect to a Teradata database using a DNS.
Essbase Studio: Perform a cube deployment in non-streaming mode, which uses the Teradata ODBC driver.
When you cut and paste code snippets from a PDF file, some characters can be lost during the paste operation, making the code snippet invalid. Workaround: Cut and paste from the HTML version of the document.
To perform an export/import of the Essbase Studio catalog database, you must be provisioned as Administrator in Oracle Hyperion Shared Services. For information on provisioning and on all Essbase Studio roles, see the Oracle Essbase Studio User's Guide.
The following rules for drill-through template SQL were not previously documented:
All pairs of predefined variables that are associated with dimension intersection values and dimension table columns must be included in the user-defined SQL. For example, the intersection of the dimension Product is specified by the following expression in the standard SQL template:
$$Product-COLUMN$$ IN ($$Product-VALUE$$)
This expression must also be included in the user-defined SQL template.
In the user-defined SQL template, users should reuse the same alias names that were generated by the Essbase Studio Server in the predefined SQL template.
In the “Limitations and Guidelines” appendix, under “General Limitations” in the “Cube Deployment Limitations and Guidelines” section, the statement, “Incremental builds for XOLAP-enabled models are not supported. ” is incorrect. You can ignore this statement. Starting with Release 184.108.40.206.102, Essbase Studio supports incremental builds for XOLAP-enabled models.
The topic, “Upgrading the Essbase Studio Catalog and Data” has been updated. Please disregard the topic in the Oracle Essbase Studio User's Guide and refer to the topic below.
To move Essbase Studio from release 220.127.116.11 to the 18.104.22.168 release, you perform an upgrade. To move from release 11.1.2 to 22.214.171.124, you apply the maintenance release.
The upgrade or maintenance release procedure for Essbase Studio is part of the configuration process for EPM System. See the Oracle Enterprise Performance Management System Installation and Configuration Guide for more information. Complete the tasks applicable to your environment in the order noted in the guide.
After configuration, perform these tasks in Essbase Studio:
If Essbase Server has moved, perform the rehosting procedure so that Essbase connections point to the new server location, as described in “Updating References to Rehosted EPM System Products” in the Oracle Essbase Studio User's Guide.
If Essbase Studio Server has moved, for deployed applications that reference the old server location, update the cube linkage, as described in “Updating Cube Linkage” in the Oracle Essbase Studio User's Guide.
For text file data sources:
Specify either the location from an earlier release, or the replicated location for the Essbase Studio data files by modifying the default EPM_ORACLE_INSTANCE/BPMS/bpms1/datafiles location provided in the Oracle Hyperion Enterprise Performance Management System Configurator. See the Oracle Enterprise Performance Management System Installation and Configuration Guide for more information.
Edit the connection properties for any text file connections to point to the new location of the text files, as described in “Editing Data Source Connection Properties” in the Oracle Essbase Studio User's Guide.
After configuration, if you move your text files to another location, edit the server.datafile.dir property in the server.properties file and edit the connection properties for any text file connections to point to the new location of the text files. See “server.datafile.dir” and “Editing Data Source Connection Properties” respectively in the Oracle Essbase Studio User's Guide.
If Performance Management Architect Dimension Server has moved, edit the connection properties for any Performance Management Architect Dimension Server connections that point to the old server location, as described in “Editing Data Source Connection Properties” in the Oracle Essbase Studio User's Guide.
The Essbase Studio user role, cpDMDSAdmin, was previously undocumented. This role has all the privileges of the Essbase Studio Viewer, Data Source Administrator, and Metadata Administrator roles. The cpDMDSAdmin role name appears in the title bar of the Essbase Studio Console when both the Data Source Administrator and Metadata Administrator roles are selected when provisioning.
For information on provisioning and on all Essbase Studio roles, see the Oracle Enterprise Performance Management System User and Role Security Guide.
When dimension elements have sort orders applied to them and, in the Essbase model, the members based on those dimension elements have prefix or suffix transformations applied to them, these members will not sort correctly after the model is deployed.
Workaround: If you require prefix or suffix transformations on a member that has sort orders applied to the underlying dimension element, you can edit the key binding expression for the element to add the transformation. Do not use the transformation functionality in the Essbase model in this case.
For example, using the TBC database, a Product dimension is built using the following hierarchy:
FAMILY |_ SKU
Before applying the transformation to the key binding expression, the dimension element properties are set as follows:
Dimension element FAMILY—with Key and Caption Bindings set to PRODUCTDIM.FAMILY, and Sort Column set to PRODUCTDIM.FAMILY
Dimension element SKU—with Key and Caption Bindings set to PRODUCTDIM.SKU, and Sort Column set to PRODUCTDIM.SKU
Now edit the key binding expression using concatenation to add a prefix or suffix.
For example, to add SKU from the PRODUCTDIM table as a suffix to the FAMILY dimension element, the additional text in bold below is added to the key binding expression:
connection : \'TBC-oracle'::'TBC.PRODUCTDIM'.'FAMILY' || "_" || connection : \'TBC-oracle'::'TBC.PRODUCTDIM'.'SKU'
In a multichain hierarchy containing a base chain and attribute chains, when removing the base chain, the Essbase model resync operation will succeed, but cube deployment of this model will fail.
Note that the Essbase model resync operation does not validate the model. If the resynced model contains errors, you will not be notified. Therefore, you must validate the model separately by opening it in the Essbase Model Properties dialog box and performing the steps in the “Validating Model Properties” topic in the Oracle Essbase Studio User's Guide.
In a multichain hierarchy containing a base chain and an attribute chain, if an intermediate level in an attribute chain is added or deleted and then model resync is performed, the attribute settings are removed from attribute dimension.
Whenever you add or remove levels in an attribute chain, you should perform the model resync, and then review and reset any attribute or varying attribute properties in the affected Essbase models. Also, Oracle recommends that you validate the model before attempting cube deployment.
If you remove the leaf level of a hierarchy that is included in a varying attribute, and then perform a model resync, the resync will appear to be successful but the varying attribute will no longer work. Deployment of a cube that uses this hierarchy will fail.
As stated in the previous item (13005538), after performing the model resync, review and, where necessary, reset attribute or varying attribute properties in affected Essbase models. Also, be sure to validate models before attempting cube deployment.
In the topic, “About Model Resync,” there are two erroneous items in the list of operations that trigger the need for a model resync. Those operations are:
Renaming the schema
Renaming the hierarchy
Note that renaming a cube schema or a hierarchy does not trigger the need for a model resync.
When previewing drill-through reports in Essbase Studio, the maximum number of rows returned is 1024.
Note: You preview, or test, drill-through reports by clicking the Test button in the Report Contents tab of the drill-through report editor.
When working with an Essbase model that is based on an Oracle BI EE data source using the Business Model option, and you selected the Create cube schema and Essbase model option when creating the data source connection, then the ASO storage model option and Duplicate member name support option are enabled by default. You may clear either or both of these options if you require.
Oracle recommends, however, that you enable the Duplicate member name support option. Selecting the Duplicate member name support option helps resolve member name collisions which are likely to occur in Oracle Business Intelligence Enterprise Edition Business Model-based Oracle Essbase cubes
This topic references the EASLaunch.properties file in error. Administration Services Console can no longer be launched from Essbase Studio Console and, therefore, this file has been removed from the installation.
13560119 -- When using scripts to start or stop Essbase Studio Server, be sure to use ONLY the .bat or .sh scripts located in EPM_ORACLE_INSTANCE/bin.
Do not use the .bat or .sh files that are located in EPM_ORACLE_HOME/products/Essbase/EssbaseStudio/Server to start or stop the Essbase Studio Server.
In the General tab for members in the Essbase Model Properties dialog box, the former “Comments” drop-down list box (which also accepted hand-typed comments) has been converted to a new Comments group with these options:
Comments—a text box where you enter a comment for the member.
From External Source—a drop-down list box where you select an applicable database column that contains comments, which are loaded along with members during cube deployment.
You can select one of the above options per member.
It is our goal to make Oracle products, services, and supporting documentation accessible to the disabled community. Oracle's Oracle Essbase Studio supports accessibility features, which are described in the Oracle Essbase Studio Accessibility Guide. The most up-to-date version of this guide can be found in the Oracle Enterprise Performance Management System Documentation Library on the Oracle Technology Network (http://www.oracle.com/technology/documentation/epm.html).
In addition, this Readme file is accessible in HTML format.