Preparing & installing the ICS on-premises Connectivity Agent

Robert van Molken 2

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

2 thoughts on “Preparing & installing the ICS on-premises Connectivity Agent

  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=https://integration-gse00012012.integration.us2.oraclecloud.com:443 -u=cloud.admin -p=****** -ad=OIM_AGENT -au=lroot1 -ap=lroot1 -ph=****** -pp=80

    Following error :

    Valid hostURL provided
    integration-gse00012012.integration.us2.oraclecloud.com 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?

Comments are closed.

Next Post

Structure is Everything

Facebook0TwitterLinkedinMiddleware applications are normally build in a structured way – according to some architecture. However, often this structure can’t be recognized in the implementation. This article describes some simple measures that can be taken to improve on this point. The article does not intend to be complete,  but it should […]