Wednesday, March 27, 2024

 

🔌 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:

[oracle@omdb1 oic]$ java -jar connectivityagent.jar
Proceeding to install a new agent ...
Enter your OIC username : palaneandavar@domainname.ae
Enter password for palaneandavar@domainname.ae:
No Proxy Configuration Detected
Checking for trusted certificates ...
Making call to check OIC Version ...
Making call to check Agent group availability ...
Updating Agent with configuration details ...
Making call to register new agent instance ...
Making call for getting agent app id & keys...
Done with Agent installation & configuration... Starting Agent for message processing.
Agent started successfully...Now available for new messages...

This confirms that the agent has been installed, configured, and started successfully.

Step 4: Run OIC Agent in the Background


[oracle@omdb1 oic]$ nohup java -jar connectivityagent.jar &
[1] 81615
[oracle@omdb1 oic]$ nohup: ignoring input and appending output to ‘nohup.out’


[oracle@omdb1 oic]$ cat nohup.out
Existing Agent installation found... Starting Agent for message processing.
Checking for already running instances of this agent. This might take up to 15 seconds ...
Initializing the credential store ...
Agent started successfully...Now available for new messages...
[oracle@omdb1 oic]$

 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!