Oracle Integration Cloud (OIC) enables organizations to connect cloud applications, databases, APIs, and enterprise systems. However, many businesses still operate applications and databases within private networks that cannot be accessed directly over the public internet. Connecting these on-premises systems with Oracle Cloud applications requires a secure connectivity mechanism.
The Oracle Integration Cloud Connectivity Agent solves this challenge by enabling communication between OIC and applications hosted within private or on-premises networks.
In this guide, we will explain what the OIC Connectivity Agent is, how it works, its architecture, installation requirements, configuration steps, common use cases, and troubleshooting techniques.
What Is the Oracle Integration Cloud Connectivity Agent?
The Oracle Integration Cloud Connectivity Agent is a software component that enables hybrid integration between Oracle Integration and applications hosted within private networks.
It acts as a bridge between Oracle Cloud and internal enterprise systems. Organizations can use it to connect OIC with supported databases, applications, messaging systems, and other resources that are not directly accessible over the internet.
For example, a company may store employee information in an on-premises Oracle Database while using Oracle Fusion HCM in the cloud. The Connectivity Agent enables OIC to communicate with the internal database and exchange information with Oracle Fusion HCM.
Some common use cases include:
- Connecting OIC with on-premises Oracle Database.
- Integrating Oracle E-Business Suite with Oracle Cloud.
- Connecting internal applications with Oracle Fusion ERP.
- Integrating on-premises SQL Server databases.
- Connecting supported messaging systems.
- Exchanging data between cloud and private-network applications.
How Does the OIC Connectivity Agent Work?
The Connectivity Agent uses a cloud-to-on-premises communication architecture.
It consists of two main components:
1. Cloud Agent: This component runs within Oracle Integration and supports communication with on-premises applications.
2. On-Premises Agent: This component is installed on a local server or virtual machine that has network access to the internal applications.
The on-premises agent establishes secure communication with the cloud agent. It retrieves integration messages from Oracle Integration and sends responses back to the cloud.
Communication is secured using TLS, and Oracle Integration 3 uses OAuth 2.0 token-based authentication for the connectivity agent.
An important security benefit is that the on-premises agent does not open inbound ports on the internal network for this communication. Instead, it establishes outbound connectivity to Oracle Integration. <Cite refs={[“turn740551search2”]}/>
Key Features of the Oracle Connectivity Agent
1. Secure Hybrid Connectivity
The agent enables OIC to communicate with supported applications inside private networks without directly exposing those applications to the public internet.
2. Support for On-Premises Applications
It supports integration scenarios involving technologies such as Oracle Database, Oracle E-Business Suite, Oracle Siebel, and other supported systems.
3. Multiple Target Systems
A connectivity agent can support multiple target systems, depending on the adapter and connectivity requirements.
4. Secure Communication
Communication between the on-premises agent and Oracle Integration uses TLS, with OAuth 2.0-based authentication in Oracle Integration 3.
5. Multithreading Support
The connectivity agent supports multiple executors for downstream message processing, helping manage concurrent integration workloads.
Oracle Integration Cloud Connectivity Agent Architecture
A typical OIC connectivity architecture includes the following components:
| Component | Purpose |
|---|---|
| Oracle Integration Cloud | Designs and executes integration workflows |
| Cloud Agent | Supports communication with on-premises agents |
| On-Premises Agent | Connects OIC to internal applications |
| Adapter | Provides application-specific connectivity |
| Internal Application | Source or target system |
| Network and Security | Controls secure communication |
For example, when OIC needs to retrieve employee records from an internal database, the integration invokes the appropriate database adapter connection. The connectivity agent facilitates communication with the database through the private network.
This architecture is particularly useful for organizations implementing hybrid cloud solutions. <Cite refs={[“turn740551search2”]}/>
Prerequisites for Installing the OIC Connectivity Agent
Before installing the agent, ensure that the host environment meets Oracle’s requirements.
For Oracle Integration 3, important prerequisites include:
- A supported operating system.
- Oracle JDK 17.
- At least 8 GB of system memory.
- Approximately 4 GB of heap memory dedicated to the agent JVM.
- Required network access to Oracle Integration and the target application.
- Appropriate installation permissions.
- An agent group created in Oracle Integration.
Oracle also specifies operating system certification and network requirements. Verify the latest supported configurations before installation. <Cite refs={[“turn740551search4”]}/>
Step-by-Step Guide to Installing the OIC Connectivity Agent
Step 1: Create an Agent Group
Log in to your Oracle Integration Cloud instance.
Navigate to the Design or Integrations area and open Agents, depending on the interface version.
Select Create Agent Group and provide a meaningful name and description.
For example:
OIC_ONPREM_AGENT_GROUP
The agent group provides the association between the on-premises agent and Oracle Integration.
Step 2: Download the Connectivity Agent
After creating the agent group:
- Open the Agents page.
- Select the Download option.
- Choose Connectivity Agent.
- Download the installer to your on-premises server.
- Extract the downloaded ZIP file.
Ensure that the installation directory is accessible to authorized administrators.
Step 3: Prepare the Installation Environment
Install the required Oracle JDK version and configure the Java environment variables.
For example:
export JAVA_HOME=/path/to/jdk-17
export PATH=$JAVA_HOME/bin:$PATHCreate a permanent installation directory for the agent.
Avoid installing the agent in /tmp, because temporary directories may be cleared during system maintenance or reboot.
Step 4: Configure the Agent
Review the InstallerProfile.cfg file and configure the required Oracle Integration URL, agent group identifier, and applicable proxy settings.
The configuration must match the agent group created in Oracle Integration.
Step 5: Run the Installation Command
Navigate to the directory containing the agent installer and execute:
java -jar connectivityagent.jarFollow the installation prompts and provide the required information.
After successful installation, the agent starts processing messages.
Step 6: Verify Agent Status
Return to Oracle Integration and open the Agents monitoring page.
Check whether the installed agent is showing an available or active status.
Once the agent is available, create or update the required adapter connection and associate it with the appropriate agent group.
The connection can then be used in supported integration workflows. <Cite refs={[“turn740551search0”]}/>
Real-World Examples of OIC Connectivity Agent
Example 1: Integrating OIC with an On-Premises Oracle Database
An organization maintains employee information in an internal Oracle Database and wants to synchronize selected records with Oracle Fusion HCM.
The integration can follow this process:
- Configure the Connectivity Agent.
- Create a database connection using the appropriate adapter.
- Associate the connection with the agent group.
- Retrieve employee records from the database.
- Map the employee information to the Oracle HCM structure.
- Send the data to Oracle HCM.
- Monitor the integration execution.
Example 2: Integrating Oracle E-Business Suite with OIC
An organization uses Oracle E-Business Suite for financial operations and wants to exchange information with Oracle Fusion Cloud applications.
The OIC Connectivity Agent can provide the required connectivity for supported EBS integration scenarios.
Developers can configure the appropriate adapter, implement the integration workflow, transform data, and manage errors.
Example 3: Connecting Internal Applications with REST APIs
A company may maintain internal business applications that are not publicly accessible.
Using supported adapter capabilities and the Connectivity Agent, OIC can exchange data with these systems while maintaining the organization’s network security requirements.
Common Connectivity Agent Errors and Troubleshooting
Connectivity issues can occur because of configuration problems, network restrictions, or authentication failures.
| Error | Possible Cause | Recommended Solution |
|---|---|---|
| Agent unavailable | Agent process stopped | Check and restart the agent |
| Authentication failure | Invalid credentials or token configuration | Review authentication settings |
| Connection timeout | Network or firewall restriction | Verify outbound connectivity |
| Installation failure | Incorrect Java configuration | Check JDK version and JAVA_HOME |
| Adapter connection failure | Incorrect connection configuration | Review adapter and agent group settings |
| Certificate error | Missing or untrusted certificate | Install the required certificate |
For detailed troubleshooting, review the agent diagnostic log:
agenthome/logs/agent-diagnostic0.log
Oracle recommends checking the agent process, network connectivity, authentication, and diagnostic logs when an agent becomes unavailable. <Cite refs={[“turn740551search1”]}/>
Best Practices for Managing the OIC Connectivity Agent
Follow these recommendations to maintain reliable connectivity:
- Install the agent on a supported operating system.
- Use the Oracle JDK version required by your OIC release.
- Install the agent with minimum required privileges.
- Restrict access to installation and configuration directories.
- Configure firewall rules for required outbound communication.
- Monitor agent availability regularly.
- Maintain sufficient memory and processing resources.
- Use appropriate agent groups for different environments or workloads.
- Protect authentication credentials and certificates.
- Review diagnostic logs when connectivity problems occur.
- Keep the agent updated according to Oracle’s recommendations.
Conclusion
The Oracle Integration Cloud Connectivity Agent is an essential component for organizations implementing hybrid integration solutions. It enables secure communication between Oracle Cloud and applications hosted within private or on-premises networks.
By understanding its architecture, installation requirements, configuration process, and troubleshooting methods, OIC developers can connect internal enterprise systems with Oracle Fusion Cloud Applications more effectively.
Whether you are integrating Oracle Database, Oracle E-Business Suite, or other supported enterprise applications, the Connectivity Agent helps extend Oracle Integration Cloud capabilities beyond publicly accessible systems.
For professionals preparing for Oracle Integration Cloud interviews or working on enterprise integration projects, understanding the Connectivity Agent is an important technical skill.
IQ Stream Technologies provides Oracle technology learning resources to help developers and consultants strengthen their knowledge of OIC architecture, adapters, connectivity, and real-world integration development.
