Oracle® Hyperion Provider Services

Readme

Release 11.1.2.2.100


Copyright © 2012, Oracle and/or its affiliates. All rights reserved.

Authors: EPM Information Development Team

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

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 or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS:

Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

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.

This software or hardware and documentation may provide access to or information on 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. 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.


Table of Contents:

Purpose

New Features

Installation Information

Supported Platforms

Supported Languages

Supported Paths to this Release

Defects Fixed in this Release

Defects Fixed in Release 11.1.2.2.000

Known Issues

Documentation Updates

Accessibility Considerations

Purpose

This document includes important, late-breaking information about this release of Oracle Hyperion Provider Services. Review this Readme thoroughly before installing Provider Services.

New Features

See the Oracle Hyperion Provider Services 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.

Installation Information

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.

Supported Platforms

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:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

Supported Languages

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:

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

Supported Paths to this Release

You can upgrade to EPM System Release 11.1.2.2 from the following releases:

Note:

For instructions to upgrade, see the Oracle Enterprise Performance Management System Installation and Configuration GuideOracle Hyperion Data Relationship Management EPM Architect Integration Guide, "Upgrading EPM System Products."

Table 1. Supported Paths to this Release

Release Upgrade Path FromTo

11.1.2.x

11.1.2.2

Note that when moving from Release 11.1.2.0.x or 11.1.2.1.x to Release 11.1.2.2, 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 11.1.2.1.

11.1.1.3.x

11.1.2.2

11.1.1.4.x

11.1.2.2

9.3.3.x

Note: If you were using Oracle Hyperion EPM Architect Release 9.3.1, you can download the Oracle Hyperion Shared Services release 9.3.3 from My Oracle Support.

11.1.2.2

A release earlier than Release 9.3.3.x

If you are upgrading from a release earlier than 9.3.3.x, you must first upgrade to a supported release and then upgrade to release 11.1.2.2. For upgrade procedures for the earlier release, see the product installation guides for the interim release that you are upgrading to.

An environment that includes multiple releases, which can include an environment with one instance of 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.

Note:

If you are starting from Release 9.2.0.3+, 9.3.0.x, 9.3.1.x (except for Oracle Essbase 9.3.1.4.1, 9.3.1.5, 9.3.1.6, and 9.3.1.7), or 11.1.1.x, Oracle recommends that you upgrade to Release 11.1.1.3 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 9.3.1.4.1. Essbase and Oracle Hyperion Shared Services Release 11.1.1.3, however, still synchronize security information. For this reason, if you are using Essbase Release 9.3.1.4.1, 9.3.1.5, 9.3.1.6, or 9.3.1.7, you must first upgrade all products to Release 9.3.3, instead of Release 11.1.1.3.

Defects Fixed in this Release

If you are coming from Release 11.1.2.0 or 11.1.2.1, use the Defects Fixed Finder tool to review the list of defects fixed between those releases and Release 11.1.2.2. This tool is available here:

https://support.oracle.com/oip/faces/secure/km/DocumentDisplay.jspx?id=1292603.1

  • 13590781 -- If member names in a cube contain square brackets (for example, "PUB_[1234]_1"), performing a zoom in or refresh operation on a range containing these members may result in an error message.

  • 12756717 -- If an invalid configuration setting is entered in essbase.properties, Provider Services may fail to start.

  • 12885251 -- In Oracle Hyperion Smart View for Office, if you insert a blank row into a Smart Slice and then launch Query Designer, the Essbase menu and point of view may disappear.

  • 12885232 -- In Smart View, if you launch Member Information on a Date-Time Series member, you may receive an "unexpected Essbase error."

  • 13591636 -- When third-party software retrieves a large cell data section using XMLA, the third-party software may terminate abnormally with an error message of “The server sent an unrecognizable response.

  • 13519619 -- When Provider Services is running on a server with a non-English locale set, queries using XMLA services may fail with the following error message: “The server sent an unrecognizable response. Additional information: Unable to format XML value according to declared type.

  • 13452698 -- In Smart View, using the function HsGetVal to refresh a sheet may incorrectly refresh a different sheet when you have attribute dimensions in the grid.

  • 9104922 -- MaxL statements that require API support do not work. On such statements, you will receive an error message that the statement is not supported.

  • 11772464 -- In an XMLA stateless session, you may get this error message: "...Concurrent requests on the same session are not allowed. Wait till the previous request completes processing or kill the request....”

  • 11839647 -- When you connect a Java API client to Essbase using a Provider Services URL without the port, for example, http://<hostname>/aps/Essbase?ClusterName=<logical name>, you may get the following error: Cannot connect to Essbase server, Error(1030027): Port length must be less or equal to 9 character9Including white space) when passed to ESSAPI function EssLogin.

    This occurs only in Provider Services instances that are deployed on default ports (80/443) and only for Java API clients that use the Provider Services URL as the OLAP server name for resolving the Essbase logical name for implementation in release 11.1.2.

Defects Fixed in Release 11.1.2.2.000

  • 12913916 -- In the Smart View Member Selection window, searching for members with aliases that are stored in a non-default alias table does not work. The members are not found, and no error is displayed.

  • 12896745 -- If a cube created in Oracle Essbase Studio is deployed to Essbase and opened using Smart View, when the Essbase Studio service is running and an ad-hoc drill-down is initiated, the following error message may occur: Dimension signature mismatch in @ function ~[SET CONSTRUCTOR]~ on line ~[1]

  • 13406653 -- In Smart View, when executing an Oracle Essbase Studio drill-through report on duplicate members, the error message Cannot perform cube view operation.null may occur.

  • 13112801 -- Open JAPI connections to Essbase may unexpectedly be terminated with the following error message: Cannot set active application/cube. Essbase Error(1051021): You have been logged out due to inactivity or explicitly by the administrator.

  • 13078240 -- The file <APS_HOME>\lib\essconfiguration.jar is no longer needed, and has been removed.

  • 12931820 -- Executing an MDX query may result in the following error message: Cannot perform cube view operation.

    Calling IEssOpMdxQuery.setQuery with needCellStatus = true may prevent this error.

  • 12913916 -- In the Oracle Hyperion Smart View for Office Member Selection window, searching for members with aliases that are stored in a non-default alias table may not work. The members are not found, and no error is displayed.

  • 12788139 -- When retrieving a qualified member name for an alias name containing “++,” an incorrect member name is returned.

  • 11694142 -- The JAPI client may not properly handle an unexpected socket closure from Essbase.

  • 12781645, 12656037 -- The JAPI client may fail to recognize the status of an Essbase data load.

Known Issues

The following issues are the noteworthy known issues of this release.

  • 8674073 -- In Smart Slice dimensions that contain more than 5000 members, not all members will be displayed when users zoom in on the dimension. To use Smart Slices on dimensions with more than 5000 members, in the essbase.properties file, located in EPM_ORACLE_INSTANCE\bin, set the property service.olap.dataQuery.grid.maxRows=0 and increase maximum heap size to 512M. Restart Provider Services.

  • 11655006 -- Ensure that you use the correct syntax to specify secure mode. When you set the OLAP_NAME to cluster URL, use the values “yes” or “no” to specify whether you want to use secure mode, for example, OLAP_SERVER=http://<servername>:<port>aps/Essbase?ClusterName=Win32Cluster-1&SecureMode=yes

    All other values (for example, SecureMode=true or SecureMode=false) are invalid and are interpreted by Provider Services as SecureMode=no.

    If you use invalid syntax, no error message is generated, nor is the connection halted. Therefore, if you were to enter SecureMode=true to specify secure communication, it would be interpreted as SecureMode=no, and the connection would be made successfully but not in secure mode.

  • 11898620 -- When you use the Essbase cluster URL in a Java API client program running in 3-tier APS mode, the Provider Services host used to resolve the Essbase cluster URL is the Provider Services host name to which the client is connected in the 3-tier mode; the Provider Services host name within the Essbase Cluster URL is not used. These two references to Provider Services hosts are usually same. When you use the Essbase cluster URL in a Java API client program running in embedded 2-tier mode, then the Provider Services host used to resolve the Essbase cluster URL is the Oracle Hyperion Provider Services host name within the Oracle Essbase cluster URL.

Documentation Updates

Accessing EPM System Product Documentation

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.

Copying and Pasting Code Snippets from PDFs

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.

Accessibility Considerations

It is our goal to make Oracle products, services, and supporting documentation accessible to the disabled community. The Oracle Hyperion Provider Services Administration Guide and this Readme file are accessible in HTML format.

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).