🔌 Installing Oracle Integration Cloud (OIC) Connectivity Agent on a Linux Server
Oracle Integration Cloud (OIC) allows seamless integration between on-premise and cloud applications using a Connectivity Agent. In this guide, we walk through installing and starting the OIC Agent on a Linux server.
Prerequisites
Before proceeding, make sure you have:
-
Access to the OIC Agent installer ZIP (e.g.
oic_conn_agent_installer_1.zip
) -
A supported version of Java JDK (17 or higher)
-
Correct Agent Group and OIC configuration credentials
-
Outbound internet access from the Linux server (for agent registration)
Step 1: Set Up Environment Variables
Navigate to the agent installer directory and configure the required Java environment:
export JAVA_HOME=/oic/jdk-17.0.7
export PATH=$JAVA_HOME/bin:$PATH
Check the Java version
Check the OIC and use the latest compatible Java version
Step 2: Unzip and Explore Agent Directory
After placing the oic_conn_agent_installer_1.zip
in your working directory, ensure the following files are present:
Download the oic_conn_agent_installer.zip from the OIC console and place it in the server where the agent needs to be installed
In this case, we are installing the user as Oracle on the Linux Box
unzip oic_conn_agent_installer_1.zip
[oracle@omdb1 oic]$ ls
agenthome connectivityagent.jar cpi_upgradeutility.jar InstallerProfile.cfg jdk-17.0.7 jdk-17.0.7_linux-x64_bin.tar.gz oic_conn_agent_installer_1.zip ss
Step 3: Start the Agent Installation
Run the installation command using the connectivity JAR:
Step 4: Run OIC Agent in the Background
Final Notes
-
The connectivity agent bridges on-prem systems (like databases, ERP, etc.) and Oracle Cloud.
-
Ensure the Linux server allows outbound connectivity to OIC endpoints (typically HTTPS on port 443).
-
You can monitor agent status directly from the OIC console under the Agents section.
Integrate your agent with on-premise apps like Oracle EBS, databases, or ERP connectors by configuring them in your OIC instance.
Need help integrating this agent with Oracle EBS /on-prem connectors or setting up high availability? Drop a comment or reach out-- happy to help!