Page |1

Whitepaper

How to Migrate Metadata from EPMA to DRM

Created on: 02-Jan-2020

Last Modified on: 04-Jan-2020
 Page |2

Table of Contents
Overview ....................................................................................................................................................... 3
Steps to Migrate EPMA Application to DRM .............................................................................................. 3
Installing EPMA File Generator ................................................................................................................... 4
Generating ADS File..................................................................................................................................... 6
EPMA ADS File Conversion Utility ............................................................................................................ 8
DRM Load App Templates ......................................................................................................................... 10
DRM Import Metadata ................................................................................................................................ 13
DRM Export Metadata ................................................................................................................................ 15
HFM Load Metadata ................................................................................................................................... 17
Conclusion .................................................................................................................................................. 18
 Page |3

How to Migrate Metadata from EPMA to

DRM
Overview

From Oracle Enterprise Performance Management (EPM) 11.2 release, EPM Architect (EPMA)
will not be available as a Foundation Component.

For existing deployments of EPM Architect:

 Oracle Data Relationship Management will be offered under a restricted use license to
facilitate Oracle Hyperion EPM (on premises only) dimension maintenance
 Alternatively convert to “classic”

This guide will assist with dimension extraction from EPMA – HFM Application to DRM and
load back to the HFM Classic Application.

Steps to Migrate EPMA Application to DRM

Oracle Hyperion EPM Architect is not available in Oracle Enterprise Performance Management System
Release 11.2. If you have Performance Management Architect-based applications in Release 11.1.2.4 and
want to manage metadata in Data Relationship Management Release 11.2, review this overview of the
process.

Details about the below steps are provided in the upcoming chapter for HFM Application.

1. Export your 11.1.2.4 application metadata from Performance Management Architect to a file using
the EPMA File Generator Utility.
2. Update the file so that it is compatible with Data Relationship Management. This may be a
performed using ADS file conversion utility or a manual procedure.
3. Create an application in Data Relationship Management using predefined templates and import
your application metadata (the converted file from the previous step) to it.
4. Manage your metadata in Data Relationship Management.
5. For more information refer- DRM Admin Guide
6. When your metadata is ready to use in your EPM System Release 11.2 application, export
application metadata out of Data Relationship Management.
7. Import the Exported File into your EPM System application.
 Page |4

Installing EPMA File Generator

1) Download the Client Installer from the edelivery.oracle.com

2) Unzip the Client installer.

3) Run the ‘EPMAClient.exe’ as Administrator in the EPM Architect Server.

 Page |5

4) On Successful completion, EPMA clients will be available in the Folder:

<EPM_Oracle_Home>\Products\Foundation\BPMA
 Page |6

Generating ADS File

1) Identify the Application where the Metadata from EPMA needs to be exported. In this guide,
Sample4sim is the application has been identified which is of HFM Application type.

2) Run the EPM Architect File Generator which is available in the below path:
<EPM_Oracle_Home>\Products\Foundation\BPMA
 Page |7

3) Choose the “From HFM Application” for exporting the Metadata for HFM Application –
Sample4Sim and update the required details.

4) Run Execute and the Metadata (.ads) file will be generated in the specified path.
 Page |8

EPMA ADS File Conversion Utility

1) The EPMA ADS File Convertor for DRM Application is available in the My Oracle Support
as a Patch - 30695700

2) Download the patch and Extract to a folder<Patch_Extract>

To run the converter, follow the ReadMe document and the step-by-step actions also
captured.

Step -1: Navigate to the <Patch_Extract>\src folder in Command Prompt

Step -2: Set the JRE path variable
Step -3: Run the Java Compiler by executing the below command for the Main class –
Javac ADS_DRM.java
Step -4: Execute the Java Program using the below command:
Java ADS_DRM<Space>“ADS File name”<Space>”Target.txt”
Page |9
 P a g e | 10

DRM Load App Templates

1) DRM Migration Client is required to load the App-Templates for the DRM Application.
Default URL – http://<hostname>/drm-migration-client

2) In DRM 11.2, the App-Templates will be available in the following folder:

<EPM_Oracle_Home>\Products\DataRelationshipManagement\server\app-templates
 P a g e | 11

3) For HFM Application related templates, Select the “hfm-from-epma-app-template.xml”

4) Click Next.

5) Enter the login credentials by selecting the Target application connection.

 P a g e | 12

6) Select All and proceed next

7) Select Next

8) Select Next to complete.

 P a g e | 13

DRM Import Metadata

1) Login in to the DRM Application and Select the Import – HFM_Example_Import

2) Browse the file generated using the EPMA ADS Conversion utility.

3) Navigate to Target and Enter the New Version name.

 P a g e | 14

4) On Completion, New Version will be created with all the Dimension and Members from
EPMA.

Note:

During Import, Columns may require re-factor as per each application properties like
Alias, Custom Dimensions etc.
 P a g e | 15

DRM Export Metadata

1) In DRM Application, Select the Export Tab

2) Choose the Current and Previous Version, as the DRM version needs to be exported.
 P a g e | 16

3) Click on Run (Green Play button) to export the metadata.

4) The exported Combined file of all the Dimension(Hierarchy) will be in the Folder – Combined
 P a g e | 17

HFM Load Metadata

1) Login to Hyperion Workspace and open the application for Metadata Import by choosing the
DRM export file.

2) Select Load to Import the metadata.

 P a g e | 18

Conclusion

The EPMA ADS file converter for DRM application will help us in migrating the metadata from
EPMA. This converter is prepared on the HFM sample application any additional properties
requires the manual intervention.