Wednesday, 22 August 2018

Download and Run Connectivity Agent Oracle Integration Cloud (OIC)

The Oracle On-Premises Agent i.e Connectivity Agent is required for Oracle Integration Cloud to communicate to on-premise applications.

In ICS the connectivity agent was very heavy and agent installer was approximately 1.7 GB, however, OIC agent installer is very light weigh agent and it is approximately 142 MB.

Below is the system requirement to install the connectivity agent.

Product
Version / Size
JDK
JDK Version 8 and 9
OS
* Oracle Enterprise Linux 6.x
* Oracle Enterprise Linux 7.2
* RedHat Enterprise Linux 6.6
* RedHat Enterprise Linux 7.2
* Suse Linux Enterprise Edition 12 SP2
* Windows Standard Edition 2016
RAM
Minimum 4GB
Space
8 GB

Above system requirement as per the Oracle Documentation. I myself tried to install the connectivity agent on Windows 10 64 bit and it's running perfectly.

Below are high-level steps to download and run connectivity agent:
  • Create Agent Group in Oracle Integration Cloud
  • Download Connectivity Agent
  • Install Connectivity Agent
  • Verify Connectivity Agent
Create Agent Group in Oracle Integration Cloud
  • Login into Oracle Integration Cloud instance
  • Click on Integrations tab
  • Navigate to Designer -> Agents
  • Click on Create Agent Group and enter the Agent Group Name
    information on the opened popup. Click on Create button 
Note the Identifier name which is required during connectivity agent installation

  • Once created, it will show up on the Agents page and will show the AGENT(s) count 0. The count will increase once the connectivity agent installation is completed

Download Connectivity Agent

Connectivity Agent will be downloaded from the Agents page. Click on the Download -> Connectivity Agent button from the upper left corner


The file with name oic_connectivity_agent.zip will be downloaded

Install Connectivity Agent

During installation, we'll associate the connectivity agent with the agent group identifier we generated when creating an agent group in Oracle Integration Cloud
  • Unzip the oic_connectivity_agent.zip
  • Open the extracted file and notice InstallerProfile.cfg inside. Modify the file to include the following information
# Required Parameters
# oic_URL format should be https://hostname:sslPort
oic_URL=
agent_GROUP_IDENTIFIER=

# Proxy Parameters
proxy_HOST=
proxy_PORT=
proxy_USER=
proxy_PASSWORD=
proxy_NON_PROXY_HOSTS=


Parameter
Description
oic_URL
This parameter is required. This is the HTTPS URL for the Oracle Integration Cloud host. The port is 443.

For example:
https://oic-abc.uscom-central-1.oraclecloud.com:443

agent_GROUP_IDENTIFIER
This parameter is required. This is the identifier for the connectivity agent group created in Oracle Integration Cloud

For example: TEST_AGENT_GROUP

Proxy Parameters
These all required only if the agent is used with proxy

Once entered, save the file and close
  • Set the JAVA_HOME property to the location of the JDK installation and PATH property
  • Open the command prompt and hit the java -version command to make sure Sun JDK 1.8+ is installed
  • Run the Connectivity agent installer using below command
If JDK 8

java -jar connectivityagent.jar

If JDK 9

java --add-modules java.xml.ws,java.xml.bind -jar connectivityagent.jar
  • Enter the Oracle Integration Cloud credentials when prompted
Proceeding to install a new agent ...
Enter your OIC username :
Enter password for username :
  • Once installed, below successful message will appear on the screen
Done with Agent installation & configuration... Starting Agent for message processing.
Agent started successfully...Now available for new messages...


When we run the connectivity agent installer (using java -jar connectivityagent.jar), the process is tied to the terminal window in which we are working and ends when the window is closed. Update the following two properties in InstallerProfile.cfg file if you want to run the process in the background
  • oic_USER 
  • oic_PASSWORD
And use nohup command if the connectivity agent installation in installed on Linux / Unix box

Verify Connectivity Agent

Verify the connectivity agent by opening the Integration Cloud Agents page and see the count should increase from 0 to 1


To verify the connectivity is up and running, go to the Monitoring -> Agents page and see the GREEN icon in front of the Agent. If this is green which means the agent is up and running, if RED this means, the agent is down


Now, we can create the integrations to connect on-premise application using connectivity agent.


No comments:

Post a Comment