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 Utilities Work and Asset Cloud 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. Login to Oracle Integration Cloud.
2. On the Home page, navigate to Integration > 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.
• 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, refer to the Download and Run the Connectivity Agent Installer section in the Oracle Integration Cloud documentation.
Installing On-Premises Agent
To install an on-premises agent:
1. Login to Oracle Integration Cloud.
2. On the Home page, navigate to Integration > 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 Work and Asset Cloud Service 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.
Note: Before running the connectivity agent installer, perform the steps in the Oracle Utilities Adapter with Oracle Integration documentation.
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 Integration > Agents 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.
For more details, refer to Oracle Integration Cloud documentation.