Configuring Agent (if applicable)
Create an agent group in Oracle Integration Cloud and install agent on the on-premises server before creating/activating an integration in which messages are exchanged between the on-premises applications and Oracle Integration Cloud. The agent related configurations are needed only if the server points to an on-premises application.
This section includes:
Possible Combinations
The possible combination of an agent group is:
• Oracle Field Service on-premises and Oracle Field Service
Creating an Agent Group
Create an agent group in Oracle Integration Cloud before running the agent installer. When the on-premises agent is installed in the environment, the on-premises agent is associated with the agent group identifier. Only one on-premises 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 queues required for message exchange.
To create an agent group:
1. Log in to Oracle Integration Cloud.
2. On the Home page, click Agents.
3. Click Create Agent Group.
4. Enter the following information:
• Agent Group Name
• Identifier
Note: The agent group name and identifier must be same.
• Agent Type: “Connectivity Agent”
• Description
5. Click Create.
Downloading Agent Installer
Download the agent installer from Oracle Integration Cloud and run the installer to install the on-premises agent in your local environment. During the installation, associate the agent with the Agent Group Identifier generated when creating an agent group in Oracle Integration Cloud.
For more information on agent installer, see:
Installing On-Premises Agent
To install an on-premises agent:
1. Log in to Oracle Integration Cloud.
2. On the Home page, click Agents.
3. Click Download.
4. Select Connectivity Agent.
5. Select Save File when prompted to save the file to a directory location on your on-on-premises host.
6. Navigate to that directory and unzip oic_connectivity_agent.zip.
7. Change the file permissions to be executable.
8. Download the Oracle Utilities Network Management System certificate and upload by running the below command from agent home directory.
keytool -import -file directoryPath/sample.crt -alias SampleCert -keystore <Agent_Home>/agenthome/agent/cert/keystore.jks
9. Modify InstallerProfile.cfg to include the following information.
a. Provide the oic_URL value with the OIC SSL host name.
For example: https://OIC_host:OIC_port
b. Provide the agent_GROUP_IDENTIFIER. It should be the agent group created in Oracle Integration Cloud.
c. Set the proxy parameters if the connectivity agent is used with a proxy in the on-premises environment.
d. Set the JAVA_HOME property to the directory/folder where JDK is installed.
e. Run the connectivity agent installer from the command prompt.
java -jar connectivityagent.jar
f. Provide the Oracle Integration Cloud credentials when prompted.
g. Wait for a successful installation message to appear.
After the installation is complete, an agent instance is created to interact with Oracle Integration Cloud.
To verify if the agent instance was created:
1. Navigate to the Agents page in Oracle Integration Cloud.
2. Check if the agent count for your Agent Group is increased by one.
3. Click the number to view the agent details.