Install Oracle ICS On Premise

Introduction

Oracle Integration Cloud Service allows customers having a subscription to install the product in their On Premise site.

This is really useful in the following situations:

• You need to create integrations between On Premise Applications;
• You are developing a Custom Adapter using the Cloud Adapter SDK;

In the first scenario we can also use the Connectivity Agent to create a tunnel between the Cloud and our On Premise site and create the connection in the ICS Cloud instance configuring our agent in the Connection Configuration page. But if you only need to integrate two On Premise applications you can install ICS in our On Premise and create the integration locally. 

In the second scenario we need to register our Custom Adapter in ICS to test it and verify it is working as expected before publish it on the Cloud. 

System Requirements

Before installing on-premises Oracle Integration Cloud Service ensure that you satisfy the following prerequisites on your on-premises host:

• Operating system: Oracle Enterprise Linux 6 UC4 or above
• CPUs: 2
• Physical memory: 8 GB
• Hard disk space: 100 GB
• Database:
• Java Database (JavaDB). This is the default database.
• Oracle Database (XE or Standard). If you select this database option during installation, you are prompted to provide specific Oracle Database details.

On Premise Host

To install ICS On Premise I used a host running Oracle Linux 7 matching the requirements above. In this host I created an oracle user having its Home folder in /home/oracle. Before starting the installation, I created the directory /home/oracle/ics to store the installer and all the ICS files.

Download ICS Execution Agent

To install Oracle ICS on premise we need to download the Execution Agent installer. This is a self-extracting Linux bash script.

The installer can only be downloaded from your Integration Cloud Service instance and can only be run on a Linux environment. In this post I used an ICS instance version 16.2.5.

To download the installer, follow the steps below:

1. Log in to the instance of Oracle Integration Cloud Service to which you are subscribed.
2. In the Integration Cloud Service toolbar, click Designer.
3. On the Designer Portal, click Agents.
4. The Agent Groups page is displayed.
5. Click Download Agent Installer.
6. Select Execution Agent. The execution agent is used for On Premise installations of Oracle Integration Cloud Service.

7. Select Save File when prompted to save the ZIP file to a directory location on your on-premises host.
8. Unzip the ZIP file in the folder /home/oracle/ics. The ics-executionagent-installer.bsx execution agent file is included in the ZIP file.

9. Change the file permissions of the ics-executionagent-installer.bsx file to be executable.
   
   
   • chmod 755 ics-executionagent-installer.bsx

Install Oracle ICS

Execute the installer.

• ./ics-executionagent-installer.bsx

This starts the installation. During the installation, you are prompted to specify authentication and configuration details. The table below shows the parameters I entered during the process

When Prompted With the Following...	Enter…
Enter your ICS subscription URL for authentication	https://<my-subscription-url>:7002/ics
Enter ICS subscription Username	<my ICS Username>
Enter ICS subscription Password	<my ICS Password>
Enter HTTPS Proxy Server Host Name	Enter
Enter HTTPS Proxy Server Port Number	Enter
What Do You Want to call this Execution Agent?	CSC-ICS-OnPremise
Press enter to accept the default path or enter a new install path	Enter
Enter the user name (cannot be root) to be used for install	oracle
Enter the group (groups <user> will list the groups of a user) of the user to be used for install	oracle
Press enter to accept the default value or enter a new port number	Enter
Press enter to accept the default value or enter a new port number	Enter
Enter the password for the default user weblogic	My secret password
Select the type of database to use (JavaDB or Oracle):	JavaDB

More information about these parameters can be found here. 

The installation process will take about 1 hour and 40 minutes. After the installation completed successful you will see the following:

I started the installer from the directory /home/oracle/ics and accepted the default installation location, this will create the following directories structure:

• Oracle Base (OB): /home/oracle/ics/ICSOPInstall/ICSOP
• Oracle Home (OH): OB/app/Oracle/Middleware/Oracle_Home
• Domain Home (DH): OB/data/user_projects/domains

During the installation the installer also configured and started the Compact Domain available at:

• Compact Domain (CD): DH/compact_domain

We can now access the ICS Console available at the address: http://<host-ip>:<port>/ics  

Verify the Agent Installation 

After the installation the execution agent should be listed in your ICS cloud instance. To verify that do the following: 

1. Log in to the instance of Oracle Integration Cloud Service to which you are subscribed.
2. In the Integration Cloud Service toolbar, click Designer.
3. On the Designer Portal, click Agents.
4. The Agent Groups page is displayed.

5. In the Execution Agent Group click to expand the menu and select agents

Here you should see the agent just installed.

Solve the Proxy Issue

I don’t have any proxy so during the installation I pressed Enter to skip the proxy configuration. However, not configuring the proxy could generate the following error when accessing remote resources

The error is caused by an empty proxy Port. (See here for more details)

To solve this error, change the proxy settings by editing:

DH/compact_domain/bin/setICSDomainEnv.sh

This file contains the proxy settings:

#!/bin/sh EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dhttps.proxyHost= -Dhttps.proxyPort= -Dhttp.proxyHost= -Dhttp.proxyPort=" EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dweblogic.security.SSL.minimumProtocolVersion=TLSv1.0" EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -DExecutionContext=ICS_ON_PREMISE" export EXTRA_JAVA_PROPERTIES

Comment the line below:

#EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dhttps.proxyHost= -Dhttps.proxyPort= -Dhttp.proxyHost= -Dhttp.proxyPort="

Restart the server.

The result of this is that ICS will not use a proxy server anymore

Documentation Links

Downloading and Running the On-Premises Oracle Integration Cloud Service Installer