Glossary Oracle EPM & Hyperion services

What Are EPM Agents (On-Premise Integration)?

EPM Agents are Oracle's on-premise software components that enable Oracle EPM Cloud to connect to on-premise data sources — ERP databases, file shares, and local systems — without requiring those sources to be publicly accessible. For IT architects designing cloud…

EPM Agents — specifically the Oracle EPM Integration Agent — are on-premise software components installed within the enterprise’s network perimeter that establish a secure, outbound connection between the enterprise’s on-premise data sources (ERP databases, file repositories, ODBC-compatible data sources) and the Oracle EPM Cloud environment. The EPM Integration Agent makes it possible for Oracle EPM Cloud’s Data Management application to access on-premise data without requiring the enterprise to expose its ERP database or internal file shares to the public internet. The Agent connects outbound from the enterprise network to the EPM Cloud service — the connection initiation is from inside the firewall, not from outside it — which allows the integration to operate within the enterprise’s standard outbound internet access controls without requiring inbound firewall rules or public-facing database endpoints.

EPM Integration Agent Architecture

Component Location Function
EPM Integration Agent application On-premise server within enterprise network Executes data extracts; uploads files to EPM Cloud Inbox; manages extract schedules
JDBC drivers On-premise server Connect the Agent to on-premise databases (Oracle EBS, SAP, SQL Server)
Agent configuration file On-premise server Defines connection parameters, EPM Cloud tenant URL, authentication credentials
EPM Cloud Data Management Oracle EPM Cloud Orchestrates the Agent via API; provides connection definitions and job execution instructions
Outbound HTTPS connection Enterprise firewall → Oracle Cloud Secure channel from Agent to EPM Cloud; initiated from on-premise (no inbound rule required)

Why the EPM Integration Agent Is Required in GCC Deployments

The EPM Integration Agent is the answer to the architectural problem that most GCC enterprise EPM Cloud deployments face: Oracle EPM Cloud is a cloud SaaS application that cannot directly access an on-premise Oracle EBS, SAP, or other ERP database. In the on-premise Hyperion world, FDMEE connected to ERP databases through direct JDBC connections within the same network. In the cloud world, Oracle EPM Cloud’s Data Management cannot make a JDBC connection to a database inside the enterprise firewall. The EPM Integration Agent bridges this gap: it runs inside the firewall, accepts job execution instructions from EPM Cloud, extracts data from the on-premise source using JDBC, and uploads the extract file to the EPM Cloud Inbox — all through an outbound HTTPS connection that the enterprise’s standard outbound firewall permits.

EPM Integration Agent vs File-Based Integration

The alternative to the EPM Integration Agent is a file-based integration pattern — where the enterprise’s on-premise ERP generates a flat file extract on a schedule, places the file in a shared location accessible from the internet or from a cloud storage service, and EPM Cloud’s Data Management picks up the file. File-based integration is simpler to implement but has limitations: it requires a scheduled extract job on the ERP side, a file transfer mechanism to a cloud-accessible location, and introduces additional failure points in the extract-transfer-load chain. The EPM Integration Agent provides a more tightly integrated alternative — EPM Cloud orchestrates the extract directly, reducing the dependency on separate ERP-side scheduling and file transfer infrastructure.

What Goes Wrong in Practice

The specific EPM Integration Agent failure that most commonly disrupts scheduled data loads is a connectivity outage between the on-premise Agent server and the Oracle Cloud endpoint — caused by proxy server changes, SSL certificate updates on the enterprise network, or changes to outbound firewall rules that affect HTTPS traffic to Oracle’s cloud domains. When the Agent cannot reach the EPM Cloud endpoint, data load jobs fail without the cause being obvious in the EPM Cloud job console, which shows the job as failed to start rather than failed during execution. Monitoring the Agent’s connectivity to Oracle Cloud — through the Agent’s built-in connectivity test capability — as part of the daily operations check prevents this failure from being discovered only when a scheduled close cycle data load fails.

How Loop Wise Solutions Implements EPM Integration Agents

We design EPM Integration Agent deployments with dedicated on-premise server infrastructure, monitoring for agent service status and cloud connectivity, and documented restart and recovery procedures. In GCC enterprises where the ERP and EPM Agent servers are in data centres in Riyadh or Dubai but the EPM Cloud tenant is in an OCI region — potentially in a different geographic zone — we validate latency and throughput for the Agent-to-cloud connection before designing data load schedules that depend on consistent upload performance.

← Back to glossary

Need help implementing EPM Agents (On-Premise Integration)?

Our team works with enterprise organizations across Egypt and the GCC. Tell us about your situation.