Preparing & installing the ICS on-premises Connectivity Agent


In this second article about the Connectivity Agent we deep-dive into the details. We take a look in preparing and installing the agent. This is done in combination with Integration Cloud Service. For more information about the architecture and inner workings of the agent I recommend to read this article first.

What is the Connectivity Agent?

Basically it is a gateway between cloud and on-premises. The Agent eliminates common security and complexity issues previously associated with integrating on-premises applications from outside the firewall. With the agent it is possible for example to connect with an on-premises database or ERP application using the existing JCA adapter framework.

Agent Architecture

Downloading the Connectivity Agent

There are a few steps in installing the agent. First the installer can only be downloaded from your Integration Cloud Service instance. Secondly the installer can only be run on a linux environment. Thirdly some settings can be tuned / changed after installation.

Downloading the Agent

The agent first need to be downloaded from Integration Cloud Service. Login into your ICS instance and navigate to the Agents page.

Navigate to Agents page
At the top-right corner the user can find the “Download Agent installer” button. When clicking on the button it will show two options; the connectivity and execution agent. This article describes the first option. The second agent is evenly interesting, because it will install an instance of Integration Cloud Service on-premises. More details on this agent at a later time.

Download Agent Software

After selecting the Connectivity Agent the download will start. The downloaded file is a zip file with a filesize around 1.58GB. It took an hour to download the file, because of a limit cap of the server.

Download file size

In the zip file the user finds a file called “cloud-connectivity-agent-installer.bsx“. The installer is LINUX only.

Installer file

In preparation of my upcoming book about “Implementing Oracle Integration Cloud Service” the further content of this blog is redacted. If you like where this blog is going I can recommend reading the book when finished around October 2016.

packt pre-order

About Author

Robert is internationally recognized for its deep technological insight in Oracle technology and this are this views. He is a speaker at (international) conferences and is a frequent blogger and participates in OTN ArchBeat Podcasts. Robert one of the two SOA/BPM SIG leads for the Dutch Oracle User Group (OGh) and organizes these meetups. He works closely with the SOA Oracle Product Management team by participating in the Beta programs. In 2015, Robert was named Oracle ACE for SOA and Middleware because of these contributions.

1 Comment

  1. Hi

    I am trying to install agent on onPremise Vm, but when running installation command, I am getting following error .

    command run :

    ./cloud-connectivity-agent-installer.bsx -h= -u=cloud.admin -p=****** -ad=OIM_AGENT -au=lroot1 -ap=lroot1 -ph=****** -pp=80

    Following error :

    Valid hostURL provided is alive
    Some Other process is currently running on the port provided. Exiting Agent Installation Process.

    Nothing is mentioned in doc about it, I am not sure which service is running on 443?

    Could you please help?

Leave a Reply