Caution: Oracle urges you to carefully read and understand the following requirements. Failure to comply may result in applying a patch that can cause your application to malfunction, including service interruptions, loss of data, or both.

Patch Type

This PSU replaces files in an existing installation and does not require a full installation. See Defects fixed in this Patch for descriptions of the bugs that are fixed in this PSU.

Supported Paths to this Patch

You can apply this patch to EPM System Release 11.1.2.3.701 (patch 21365028) only.

Prerequisites

Required Microsoft Patch

Required User Rights

The user applying the patch should be the user who was set up to install and configure EPM System products. Required user privileges or rights:

Windows:

Use the user account that has Local administrator rights and was set up for installation and configuration. This user is an administrator and is the same for all EPM System products. Assign local policies if required by the product. Such assignments typically are: “Act as part of the operating system, Bypass traverse checking, Log on as a batch job, Log on as a service.”

UNIX/Linux:

Use the account that was used to install EPM System products and has Read, Write, and Execute permissions on $MIDDLEWARE_HOME. If you installed other Oracle products, the user who installed EPM System products must be in the same group as the user who installed the other Oracle products. OPatches are not intended to be applied using a root user.

Supported Platforms

This patch can be applied to all languages supported in release 11.1.2.3.000 of Oracle Enterprise Performance Management System. For the Oracle Enterprise Performance Management System Supported Platform Matrix, go to: http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

Supported Languages

This patch supports all locales supported in Release 11.1.2.3.000.

Defects Fixed in this Patch

Defect Number	Defect Fixed
• 20489144	Lifecycle Management failed to import security filters for aggregate storage (ASO) applications and displayed error messages similar to the following: /Databases/FinSHist/Security/BSCOE_FLTR:- Cannot set filter list. Essbase Error(1051013): User/group "B:10006" does not exist.
• 20695133	Intermittent taskflow execution failure is observed in environments where Essbase application name is identical to Financial Management application name. Note: You must delete taskflows that have been corrupted or failed to run because they use an incorrect application or product. Recreate such taskflows after applying this patch.
• 21668515	While attempting to export database properties from block storage (BSO) application, Lifecycle Management plugin for Essbase threw the following run time exception: 0_7For input string: "2281925632"
• 22384162	On restarting service, applications were not displayed. EPM System displayed the following error: <FoundationServices0> <WfAutoProcessingPushDaemon> <<anonymous>> <> <0000L6USsFeFO9S5UFs1yc1MRZ8D000000> <1450062556363> <BEA-000628> <Created "1" resources for pool "EPMSystemRegistry", out of which "1" are available and "0" are unavailable.>
• 22557887	A blank page is displayed when users attempt to open task flows.
• 22661763	On attempting to create the Artifact Change Report, the Lifecycle Management screen becomes unresponsive.

Known Issues in this Patch

There are no known issues.

Applying this Patch

This section includes important information about applying this patch for Shared Services.

To apply this patch:

1. Stop Foundation Services and other EPM System components and processes, including custom programs that use EPM System APIs.

2. Perform these steps on each machine that hosts EPM System components.

a. Download and unzip the downloaded patch file, 22288101.zip, to the EPM_ORACLE_HOME/OPatch directory (by default, Oracle/Middleware/EPMSystem11R1/OPatch).

Note: 22288101.zip is the name that My Oracle Support assigns to this patch. When you download the file, a message indicates the file name.

b. From a command line, change the directory to EPM_ORACLE_HOME/OPatch.

c. To apply the patch, enter the following command on one line:

Windows

opatch.bat apply EPM_ORACLE_HOME/OPatch/22288101 -oh EPM_ORACLE_HOME -jdk MIDDLEWARE_HOME/jdk160_35

Note: The default for EPM_ORACLE_HOME is C:/Oracle/Middleware/EPMSystem11R1. The default for MIDDLEWARE_HOME is C:/Oracle/Middleware.

UNIX/Linux

./opatch apply EPM_ORACLE_HOME/OPatch/22288101 -oh EPM_ORACLE_HOME -jdk MIDDLEWARE_HOME/jdk160_35 -invPtrLoc EPM_ORACLE_HOME/oraInst.loc

Note: The default for EPM_ORACLE_HOME is $HOME/Oracle/Middleware/EPMSystem11R1. The default for MIDDLEWARE_HOME is $HOME/Oracle/Middleware.

3. For WebSphere Application Server only: Redeploy the Shared Services web application. See "Deploying EPM System Products to WebSphere Application Server" in the Oracle Enterprise Performance Management System Installation and Configuration Guide for instructions.

4. Start Foundation Services and other EPM System components and processes, including custom programs that use EPM System APIs.

Rolling Back this Patch

To roll back a patch:

1. Stop Foundation Services and other EPM System components and processes, including custom programs that use EPM System APIs.

2. Perform these steps on each machine that EPM System components.

a. From a command line, change the directory to EPM_ORACLE_HOME/OPatch.

b. To roll back the patch, enter the following command on one line:

Windows

opatch.bat rollback -id 22288101 -oh EPM_ORACLE_HOME -jdk MIDDLEWARE_HOME/jdk160_35

Note: The default for EPM_ORACLE_HOME is C:/Oracle/Middleware/EPMSystem11R1. The default for MIDDLEWARE_HOME is C:/Oracle/Middleware.

UNIX/Linux

./opatch rollback -id 22288101 -oh EPM_ORACLE_HOME -jdk MIDDLEWARE_HOME /jdk160_35 -invPtrLoc EPM_ORACLE_HOME/oraInst.loc

Note: The default for EPM_ORACLE_HOME is $HOME/Oracle/Middleware/EPMSystem11R1. The default for MIDDLEWARE_HOME is $HOME/Oracle/Middleware.

3. For WebSphere Application Server only: Redeploy the restored web application. See "Deploying EPM System Products to WebSphere Application Server" in the Oracle Enterprise Performance Management System Installation and Configuration Guide for instructions.

4. Start Foundation Services and other EPM System components and processes, including custom programs that use EPM System APIs.

Troubleshooting FAQs

Why do I get the following patch conflict error message when running OPatch?

If the patch that you apply conflicts with a previously applied patch, you may receive the following error message when running OPatch:

Patch(es) <PreviousPatch#> conflict with the patch currently being installed (<NewPatch#>).

If you continue, patch(es) <PreviousPatch#> will be rolled back and the new patch (<NewPatch#>) will be installed.

If a merge of the new patch (<NewPatch#>) and the conflicting patch(es) (<PreviousPatch#>) is required, contact Oracle Support Services and request a Merged patch.

This error is returned when one patch attempts to update a previously patched file. When this conflict happens, you can either (1) roll back the previous patch and apply the new patch (this action might be appropriate if the previous patch was not critical) or (2) request a “merged patch” consisting of the new patch and the patch that it conflicts with. To request a merged patch, contact your Oracle Support representative.

Why do I get the OUI-67078 warning message when applying OPatch?

This warning means that the patch being applied is a superset of a patch already on the deployment and the existing patch will be rolled back. The following snippet shows the context of this warning.

The following warnings have occurred during OPatch execution:

1) OUI-67078:Interim patch 12345678 is a superset of the patch(es) [77777777] in OH C:\Hyperion

-----------------------------------------------------------------------------------

OPatch Session completed with warnings.

How can I find out which releases and patches of EPM System products are installed in a deployment?

In EPM System Release 11.x, you can use the lsinventory command to OPatch to find the release and patches that are installed in an Oracle Home. For example, enter the following command on one line:

Windows:

opatch.bat lsinventory -oh <EPM_ORACLE_HOME> -jdk <MIDDLEWARE_HOME>/jdk160_35

UNIX/Linux:

./opatch lsinventory -oh <EPM_ORACLE_HOME> -jdk <MIDDLEWARE_HOME>/jdk160_35 –invPtrLoc <EPM_ORACLE_HOME>/oraInst.loc

I applied the patch successfully but I don’t see the changes from the patch in the product. What should I do?

When patching an .EAR file for an application, you may need to delete the cached files in the following folders in order to see the changes provided with the patch:

<MIDDLEWARE_HOME>/user_projects/domains/<DOMAIN_NAME>/servers/

<MANAGED_SERVER_NAME/tmp/

<MIDDLEWARE_HOME>/user_projects/domains/<DOMAIN_NAME>/servers/

<MANAGED_SERVER_NAME>/cache