Install the On-Premises Agent
If Oracle E-Business Suite is installed behind a firewall, then install the on-premises agent to enable Oracle Integration Cloud to connect to the deployed APIs.
You don’t need to install the agent if Oracle E-Business Suite is installed in a demilitarized zone (DMZ) configuration, and it’s publicly accessible through the internet.
About Agents and Integrations Between On-Premises Applications and Oracle Integration Cloud Service
The on-premises agent enables you to create integrations and exchange messages between on-premises applications and Oracle Integration Cloud Service.
Message payloads of up to 5 MB are supported through the use of compression, which can bring the payload down to 512 KB in size. The on-premises agent provides multithreading support, which allows for multiple executors to perform downstream message processing.
This type of integration enables you to:
-
Access SOAP endpoints.
-
Access non-SOAP endpoints such as Oracle E-Business Suite and Oracle Siebel.
-
Send requests from a cloud application to an on-premises E-Business Suite application. For example, send a Create Service Order request from an Oracle RightNow Cloud application.
Before You Begin Installing the Agent
The agent is certified with JDK 8 and 9 on the following operating systems:
-
Oracle Linux 6.x
-
Oracle Linux 7.2
-
RedHat Enterprise Linux 6.6
-
RedHat Enterprise Linux 7.2
-
Suse Linux Enterprise Server 12 SP2
-
Windows Standard Edition 2016
Install the Agent
First, create an agent group. Then, download and install the on-premises agent.
Create an Agent Group
You must create an agent group in Oracle Integration Cloud before you can run the connectivity agent installer. When you install the connectivity agent in your environment, you associate the connectivity agent with the agent group identifier. Only one connectivity agent can be associated with an agent group. For a single Oracle Integration Cloud instance, you can create up to five agent groups. Creating the agent group also creates the necessary artifacts required for message exchange.
-
Click Create Agent Group.
The New Agent Group — Information dialog is displayed.
-
Enter the following information, then click Create.
Field Description Agent Group Name
Provide a meaningful name so that others can understand the agent name. The name must be unique among all agent names in the system. The name can consist of the following:
-
Letters (A-Z, a-z)
-
Numbers (0-9)
-
Spaces ( )
-
Special characters ( _ - )
The name must not begin or end with a space and cannot be longer than 50 characters.
Identifier
Accept the default identifier value or change it, if necessary. The identifier is initially the same as the agent group name you provided, but in upper case. When you install the agent, you must specify the identifier value.
Note: After creating the agent group, you cannot edit the agent group identifier. Instead, you must delete and recreate another agent group to associate with a different agent group identifier.
Agent Type
Connectivity Agent is displayed and cannot be edited. The connectivity agent supports integrating with on-premises systems. The agent group references only connectivity agents.
Description
Provide a meaningful description so that others can understand the responsibilities of the agent group.
-
Download and Install the Agent
To install the agent in your local environment, you must use the connectivity agent installer. During the installation, you associate the connectivity agent with the agent group identifier that you generated when you create an agent group in Oracle Integration Cloud.
-
Create a directory for the connectivity agent installation on your on-premises host.
-
In the left navigation pane, click Integrations, and click Agents.
-
Click Download, and click Connectivity Agent.
-
Download the connectivity agent installer to the directory on your on-premises host.
-
Uncompress the
oic_connectivity_agent.zip
file. -
If you need to add a certificate on the agent host, then use the
keytool
to import the certificate inkeystore.jks
.-
Go to the
agenthome/agent/cert/
directory. (Thekeystore.jks
file is here). -
Run the following command:
keytool -importcert -keystore keystore.jks -storepass changeit -keypass password -alias alias_name -noprompt -file certificate_file
-
-
If you need to add any third-party JARs (for example, for the Siebel Adapter or MySQL Adapter), paste them to the
agenthome/thirdparty/lib
directory. -
Add the following information to the
InstallerProfile.cfg
file:# Required Parameters # oic_URL format should be https://hostname:sslPort oic_URL=https://icshost:sslport agent_GROUP_IDENTIFIER= #Proxy Parameters proxy_HOST= proxy_PORT= proxy_USER= proxy_PASSWORD= proxy_NON_PROXY_HOSTS=
-
Set the
JAVA_HOME
property to the directory where the JDK is installed. -
Set the
PATH
property. For example, ifcsh
is your shell:setenv PATH = $JAVA_HOME/bin:$PATH
-
Run the connectivity agent installer from the command prompt:
JDK 8:
java –jar connectivityagent.jar
JDK 9:
With, JDK 9, to prevent harmless warning messages from being displayed, run the following from the command prompt:java --add-modules java.xml.ws,java.xml.bind --add-opens=java.base/java.lang=ALL-UNNAMED -jar connectivityagent.jar
-
Enter your Oracle Integration Cloud credentials.
Proceeding to install a new agent ... Enter your OIC username : weblogic Enter password for weblogic :
-
Wait for a successful installation message to appear.
Done with Agent installation & configuration... Starting agent for message processing. Agent started successfully... listening for new messages...