Understanding Integration Cloud and how to get the most out of your implementation

ICS Connection Agent on Windows?

We have seen the question a number of times (such as here) regarding whether or not the ICS Connection agent or (Execurtion) Worker Agent can run on Windows. Presently when establishing an agent ICS provides a Bash shell executable (BSX) file.

We’ve not heard any suggestion this is likely to change – but when you consider that the Agent is essentially a WebLogic server with parts of ICS incorporated into it. You can see that from a production perspective, demand for Windows support isn’t going to be huge.

That said, when researching, testing, developing and testing a lot of people do use a Windows platform. So being able to use the agent is attractive.  So what options are available for a Windows environment?

Well, the simplest alternative is to utilize VirtualBox with a supported version of (e.g. OEL). As detailed by Sven Bernhardt in one of the Community.Oracle.com threads on the matter:

  1. Download VirtualBox: https://www.virtualbox.org/wiki/Downloads
  2. Download Prebuilt Oracle Linux 6 Admin VM from OTN: Oracle Linux VM Image for Hands-On Lab
  3. Import the downloaded appliance to VirtualBox
  4. Start the image
  5. Install a local JDK to the VM
  6. Install the agent ./cloud-connectivity-agent-installer.bsx -h=<ICS-URL> -u=<USERNAME> -p=<PASSWORD> —ad=<AGENT_NAME> -au=<ADMIN_USER> -ap=<ADMIN_PASSWORD>
  7. Start the agent

Network settings should be sufficient, since the VM uses NAT.

If you want to learn more, you can also reach out to the following resources:

We have looked into whether it is possible to exploit the Bash (actually Bash shell on Ubuntu) Windows Subsystem for Linux (WSL) available for Windows 10 Anniversary Edition (guide to getting basic WSL setup here). Whilst getting the bash shell working, deploying a Linux Java and starting the installation on the BSX file. The install stopped as it identified missing resources, which appear to be related to sufficient swap space, and determining how to configure more space in a WSL context didn’t look promising, particuarly when you read statements from Microsoft advising not to use WSL for running server solutions (see here). Such an approach certainly isn’t supported by Oracle, and given Microsoft’s statement unlikely to be supported.

There is another option, potentially available, or may become available. Oracle has made a strong commitment to Docker at Open World this year (2016) including driving forward with a catalogue of Docker containers.  We are also seeing Docker coming to Windows, as of Windows 10, Docker is available natively – called Docker for Windows rather than the previous approach of  (rather than Docker Toolbox which exploited VirtualBox – but works for pre-Windows 10).  The only catch is presently there isn’t a Docker image presently available for the ICS agent, although you could start with Oracle Enterprise Linux (OEL) ‘image’ to run on Docker (see here), and then install the agent.

The utilization of Docker makes a lot of sense in this context, and when looked at in the light of the fact that Docker will be supportied by Microsoft Server 2016 (see here).



Oracle Messaging Cloud Service (OMCS) on Trial


Consolidated References of 3rd Party Information on ICS and OIC


  1. Antony Reynolds

    Just to add to this, I hope to shortly be able to share an unsupported dockerfile to allow building ICS Agent docker image. We are also looking into how to support docker directly.

  2. vipul


    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?

    • A couple of suggestions …

      1. Have you tried using CURL to call the server? it may reveal more info on the issue
      2. Port443 is correct
      3. Documentation wont say anything on this subject as the issue is networking rather than ICS specific

      Last & perhaps most important – post these sort of questions – on community.oracle.com First. I say this, not because we dont want to help, but this site is handled by the 2 authors who arent necessarily able respond to questions. On the community site there is a specific space for ICS where other experts including the Product Management team checkin. So you’re likely get get an answer sooner. We do look at and respond to questions on the community site as much as possible. As it gives us ideas for possible blogs


Leave a Reply

Your email address will not be published. Required fields are marked *

Powered by WordPress & Theme by Anders Norén