Anda di halaman 1dari 33

Data Management

FDMEE Lite in the cloud

Omprakash Jangir
Sr. Consultant

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. |


Day 3 – EPM Automate
Introduction to EPM Automate

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 2
Introduction to EPM Automate

Batch Utility that allows you to perform various tasks in your


cloud instance through the command line.

EPM Automate plays a vital role in automating many admin


and user tasks in Oracle EPM Cloud

Handy when using third party scheduling tools, or need to


run various automated batch processes overnight to perform
application refreshes, backups, metadata or data loads.

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 3
Why to use EPM Automate?

Improves Integration Options over the cloud

Back up Application Snapshot to a Computer

Create and Provision Users

Automate the Cloning of Environments

Import Data/Metadata into Application

Automate the daily tasks (Rule Executions, Batch Executions etc.)


Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Confidential – Oracle Internal/Restricted/Highly Restricted 4
How to use EPM Automate?

Download EPM Automate and Install it.

Build your own script (say .bat) and use EPM Automate
commands

Execute and Schedule it as per need.

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 5
Download EPM Automate

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 6
Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 7
Installing EPM Automate

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 8
EPM Automate – Admin Guide

URL:

https://docs.oracle.com/en/cloud/saas/enterprise-performance-
management-common/cepma/GUID-3C3F97F0-0EC6-4279-871C-
4736865C0EE3.pdf

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 9
Encryption Level for the EPM Automate Utility

Transport Layer Security (TLS) with SHA-2/SHA-256


Cryptographic Hash Algorithm to secure communication with
the EPM Automate Utility

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 10
Prerequisites

User must be Service Administrator

Specify full filename along with extensions “data.csv” while


processing file upload, list files and deletefiles

No extensions for Snapshot files

Parameters having spaces must be enclosed within quotation


marks

DLR, Batches
Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 11
File Locations for Data Management

Files that are to be processed using Data Management must


be available in the inbox or in a folder within it.

By default, files exported using Data Management are stored


in outbox while Data Management report outputs are stored
in Data Management outbox/report folder.

You use the Data Management File Browser to browse these


files.

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 12
Commands for Data Management

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 13
Exit Codes

The EPM Automate Utility returns an exit code and message


to indicate the status of the operation.

• Exit Code 1 Errors

• Exit Code 6 Errors

• Exit Code 7 Errors

• Exit Code 9 Errors

• Exit Code 11 Errors


Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 14
Exit Code 1 Errors

Command failed to execute

Insufficient privileges to perform the operation

Resource does not exist

Invalid snapshot SNAPSHOT

Internal server error. Unable to delete file: FILE_NAME Please issue "Provide
Feedback" with details

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 15
Exit Code 6 Errors

Service Unavailable

Read/Write timeout

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 16
Exit Code 7 Errors

EPM Automate doesn't support proxies which require authentication

Unable to open password file FILE_NAME

Unable to parse password file FILE_NAME

Unable to connect to URL. Root cause MESSAGE

Session is not authenticated. Please execute the “login” command before


executing any other command

Invalid parameter
Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 17
Exit Code 9 Errors

Invalid credentials

Authentication failed while executing command. Please retry

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 18
Exit Code 11 Errors

Internal server error MESSAGE

Unable to connect to URL: MESSAGE

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 19
Generating Debug Log File

The utility supports the - d option to generate debug


messages, which can then be redirected to a file using >
directive.

You can create a debug file for one command or a batch


execution file or script containing several commands.

Example: epmautomate downloadfile "Artifact Snapshot" -d


> C:\logs \download_log.txt

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 20
Running the EPM Automate utility

Start EPM Automate Launch EPM Automate

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 21
Encrypt Credentials
Use the password encryption command to encrypt and store
it in a file.

You use the password encryption file to pass encrypted


password to initiate a session.

Command: epmautomate encrypt epmDem0s myKey


C:/Oracle/EPMAutomate/password/password.epw

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 22
Start a session as a Service Administrator

Command:

epmautomate login epm_default_cloud_admin


C:/Oracle/EPMAutomate/password/password.epw

http://192.168.56.101:9000

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 23
Sign out of the environment

Command: epmautomate logout

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 24
Sample Scenario
Import Data into Data Management, Run a Data Load Rule, and Export Data
to Planning

Prerequisites:

1. Data Load Rule in Data Management

2. Period definitions

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 25
Steps

1. Sign In to the cloud environment

2. Upload Data File in inbox

3. Import Data and Export Data using Data Load Rule

4. Sign Out

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 26
Step 1-Sign In to the cloud environment

Command:

epmautomate login epm_default_cloud_admin


C:/Oracle/EPMAutomate/password/password.epw http://
192.168.56.101:9000

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 27
Step 2- Upload Data File in inbox

Command:

epmautomate uploadfile Test_vision.csv


inbox/Vision_Integration

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 28
Step 3- Import Data and Export Data using Data Load Rule

Command:

epmautomate rundatarule BSDL Jan-18 Jan-15 REPLACE STORE_DATA


inbox/Vision_Integration Test_vision.csv

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 29
Step 4- Sign Out

Command:

Epmautomate logout

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 30
Assignment

SNAPSHOT download automation using EPM Automate and


batch script.

-Purge the SNAPSHOT for last 5 days

-Schedule it using Windows Scheduler

-Email Notification on completion of snapshot process

-Integrate with Excel

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 31
Referrence Links

• https://
docs.oracle.com/en/cloud/saas/enterprise-performan
ce-management-common/cepma/GUID-3C3F97F0-0EC6-4279
-871C-4736865C0EE3.pdf

Copyright © 2017 Oracle and/or its affiliates. All rights reserved. | Oracle Confidential – Internal/Restricted/Highly Restricted 32

Anda mungkin juga menyukai