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:
- Log in to the instance of Oracle Integration Cloud Service to which you are subscribed.
- In the Integration Cloud Service toolbar, click Designer.
- On the Designer Portal, click Agents.
- The Agent Groups page is displayed.
- Click Download Agent Installer.
- Select Execution Agent. The execution agent is used for On Premise installations of Oracle Integration Cloud Service.
- Select Save File when prompted to save the ZIP file to a directory location on your on-premises host.
- Unzip the ZIP file in the folder /home/oracle/ics. The ics-executionagent-installer.bsx execution agent file is included in the ZIP file.
- 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:
- Log in to the instance of Oracle Integration Cloud Service to which you are subscribed.
- In the Integration Cloud Service toolbar, click Designer.
- On the Designer Portal, click Agents.
- The Agent Groups page is displayed.
- 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
