Configuring Agent
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 (example: Oracle Utilities Network Management System, Oracle Utilities Customer to Meter) and Oracle Integration Cloud. The agent related configurations are needed only if the server points to an on-premises application and to access OCI Streaming.
Note: A direct connection from Oracle Integration to the private endpoint OCI Streaming Service does not work. You must install the connectivity agent on the same network (a virtual machine (VM) created on the same virtual cloud network (VCN) and subnet).
This section includes:
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.
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, 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.
Installing On-Premises Agent
To install an on-premises agent:
1. Login 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 Customer Care and Billing certificate. Upload it by running the following command from the 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.
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 listed in the following page.
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.