Integration Cloud Service (ICS) On-Premise Agent Installation

The Oracle On-Premises Agent (aka, Connectivity Agent) is necessary for Oracle ICS to communicate to on-premise resources without the need for firewall configurations or VPN. Additional details about the Agent can be found under New Agent Simplifies Cloud to On-premises Integration. The purpose of this A-Team blog is to give a consolidated and simplified flow of what is needed to install the agent and provide a foundation for other blogs (e.g., E-Business Suite Integration with Integration Cloud Service and DB Adapter). For the detailed online documentation for the On-Premises Agent, see Managing Agent Groups and the On-Premises Agent.

On-Premises Agent Installation

The high-level steps for getting the On-Premises Agent installed on your production POD consist of two activities: 1. Create an Agent Group in the ICS console, and 2. Run the On-Premises Agent installer. Step 2 will be done on an on-premise Linux machine and the end result will be a lightweight WebLogic server instance that will be running on port 7001.

Create an Agent Group

1.	Login to the production ICS console and view landing page.

2.	Verify that the ICS version is 15.4.5 or greater.


3.	Scroll down on ICS Home page and select Create Agents. Notice this brings you to the Agents page of the Designer section.


4.	On the Agents page click on Create New Agent Group.
5.	Provide a name for your agent group (e.g., AGENT_GROUP).

6.	Review the Agent page containing new group.

Run the On-Premises Agent Installer

1.	Click on the Download Agent Installer drop down on the Agent page, select Connectivity Agent, and save file to an on-premise Linux machine where the agent will be installed/running.


2.	Extract the contents of the zip file for the cloud-connectivity-agent-installer.bsx. This .bsx is the installation script that will be executed in the on-premise machine where the agent will reside. A .bsx is a self extracting Linux bash script:

3.	Make sure the cloud-connectivity-agent-installer.bsx file is executable (e.g., chmod +x cloud-connectivity-agent-installer.bsx) and execute the shell script. NOTE: It is important to specify the SSL port (443) as part as the host URL. For example:
	./cloud-connectivity-agent-installer.bsx -h=https://<ICS_HOST>:443 -u=[username] -p=[password] -ad=AGENT_GROUP

4.	Return to the ICS console and the Agents configuration page.

5.	Review the Agent Group.


6.	Click on Monitoring and select the Agents icon on the left-hand side.

7.	Review the Agent monitoring landing page.

8.	Review the directory structure for the agent installation.

	As you can see this is a standard WLS installation. The agent server is a single-server configuration where everything is targeted to the Admin server and is listening on port 7001. Simply use the scripts in the ${agent_domain}/bin directory to start and stop the server.