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 a integration developer at heart and one of the expertise leads on Integration, Blockchain and IoT at AMIS. He is an respected author, speaker at (international) conferences and is a frequent blogger on the AMIS Technology blog, the Oracle Technology Network, and participates in OTN ArchBeat Podcasts. Robert is an member of the board of the Dutch Oracle User Group (nlOUG) and also organizes meetups.In 2017, Robert was named Oracle Developer Champion, but also hold the Oracle ACE title, for his contributions to the community. He is co-author of the first Oracle PaaS book published, which was published in January 2017. His fascination for technology had led to the research of Blockchain and is currently writing a book called Blockchain across Oracle.


  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?