OIC Agent Installation Guide

Introduction

Oracle Integration Cloud Agent Installation is a critical step when you need to securely connect on-premise systems with cloud applications using Oracle Integration Cloud. In real-world enterprise implementations, most organizations still run legacy databases, file servers, or ERP systems on-premise. The connectivity agent acts as a secure bridge between these systems and Oracle Cloud Infrastructure.

As an Oracle consultant, you will frequently encounter hybrid integration scenarios where installing and configuring the OIC connectivity agent is mandatory. This guide walks you through the installation, configuration, troubleshooting, and best practices based on real implementation experience aligned with Oracle Fusion Cloud 26A standards and OIC Gen 3.

What is Oracle Integration Cloud Agent?

Oracle Integration Cloud Agent (also called Connectivity Agent) is a lightweight Java-based runtime installed inside your on-premise network. It allows secure communication between OIC and systems behind firewalls without exposing internal endpoints to the internet.

Key Characteristics

• Runs inside customer network
• Uses outbound HTTPS communication (no inbound firewall rules required)
• Supports multiple adapters (DB, File Server, SOAP/REST services)
• Works with OIC Gen 3 architecture
• Supports high availability via multiple agents

Why It Matters

In real projects, you cannot directly connect OIC to:

• On-premise Oracle Database
• Local file systems (SFTP, FTP)
• Internal REST/SOAP services

The agent solves this by acting as a proxy.

Key Features of OIC Connectivity Agent

Real-World Integration Use Cases

1. Payroll Integration with On-Premise DB

A manufacturing client stores payroll data in an on-prem Oracle DB. Using OIC Agent:

• OIC extracts payroll data
• Sends to Fusion HCM
• Agent ensures secure DB connectivity

2. File-Based Integration with Legacy Systems

Banking client scenario:

• Legacy system drops CSV files on local server
• OIC agent reads files via File Adapter
• Processes and uploads into Fusion ERP

3. Internal API Exposure

Retail client:

• Internal REST APIs for inventory
• OIC calls APIs via agent
• No external exposure of internal services

Architecture / Technical Flow

How OIC Agent Works

1. Agent installed inside customer network
2. Agent initiates outbound connection to OIC
3. OIC sends requests via agent
4. Agent connects to local system
5. Response flows back securely

Key Components

• Agent Group (logical grouping in OIC)
• Agent Runtime (installed locally)
• Keystore for security
• OIC instance (Gen 3)

Prerequisites for Installation

Before installing the agent, ensure the following:

System Requirements

• Java JDK 8 or higher
• Minimum 4GB RAM recommended
• Linux or Windows server
• Network access to OIC endpoints

Network Requirements

• Outbound HTTPS (port 443)
• No inbound firewall changes required

OIC Setup Requirements

• Access to OIC instance
• Agent Group created in OIC
• Download agent installer from OIC

Step-by-Step Oracle Integration Cloud Agent Installation

Step 1 – Create Agent Group in OIC

Navigation:

Home → Integrations → Agents → Create Agent Group

Configuration:

• Name: OnPrem_Agent_Group
• Description: On-prem connectivity for ERP integration

Important Note:

Agent group acts as logical container for multiple agents.

Step 2 – Download Connectivity Agent

From OIC console:

• Navigate to Agent Groups
• Click Download Agent Installer

This downloads a ZIP file containing:

• agent.jar
• configuration files
• scripts

Step 3 – Prepare Installation Directory

On your on-prem server:

Step 4 – Configure Agent Properties

Edit configuration file:

Update key values:

Step 5 – Configure Security (Keystore)

Run command:

You will be prompted for:

• OIC Username
• Password
• Agent Group

This generates secure credentials.

Step 6 – Start the Agent

Run:

Expected Output:

Step 7 – Verify in OIC

Navigate:

Home → Integrations → Agents

Check:

• Agent status = Active
• Last heartbeat updated

Testing the Connectivity Agent

Test Scenario: Database Connectivity

1. Create DB Adapter connection in OIC
2. Select Agent Group
3. Provide DB credentials

Test Connection

Click Test

Expected Result:

• Status: Successful

Validation Checks

• Agent is running
• Network connectivity is available
• DB listener is active

Common Errors and Troubleshooting

1. Agent Not Connecting

Issue: Agent shows disconnected

Resolution:

• Check outbound internet access
• Verify OIC URL
• Validate proxy settings

2. SSL Handshake Error

Cause: Certificate mismatch

Fix:

• Import certificates into Java keystore
• Ensure TLS compatibility

3. Authentication Failure

Cause: Wrong credentials

Fix:

• Re-run setup command
• Validate OIC credentials

4. Agent Heartbeat Missing

Cause: Agent process stopped

Fix:

• Restart agent
• Check logs

Best Practices from Real Implementations

1. Use Multiple Agents for High Availability

• Deploy at least 2 agents per environment
• Assign same agent group

2. Monitor Agent Logs

Log location:

Always monitor for:

• Connectivity issues
• Adapter failures

3. Use Dedicated Server

Avoid installing agent on:

• Database servers
• Application servers

Use a separate integration node.

4. Secure Network Configuration

• Restrict outbound traffic only to OIC endpoints
• Use corporate proxy if required

5. Automate Agent Restart

Use scripts or system services:

Summary

Oracle Integration Cloud Agent Installation is a foundational step in any hybrid integration project. It enables secure communication between cloud and on-premise systems without exposing internal infrastructure.

In real-world implementations:

• It is widely used for DB, file, and API integrations
• Requires careful setup of network and security
• Needs monitoring and high availability planning

A properly configured agent ensures reliable and secure integration flows in enterprise environments.

FAQs

1. Can we install multiple agents in one environment?

Yes. Multiple agents can be installed and grouped under a single agent group for load balancing and failover.

2. Does OIC Agent require inbound firewall access?

No. It only requires outbound HTTPS access, making it highly secure.

3. Can we run OIC Agent in cloud VM?

Yes. You can install it on an OCI VM or any cloud VM if it can access on-prem systems.

Additional Reference

For more details, refer to official Oracle documentation:
https://docs.oracle.com/en/cloud/paas/integration-cloud/index.html