Connectivity Agent and Security Certificates
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
- Creating an Agent Group
- Downloading Agent Installer
- Installing On-Premises Agent
Possible Combinations
The possible combination of an agent group is Oracle Utilities Customer Cloud Service on-premises and Oracle Integration Cloud.
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:
-
Login to Oracle Integration Cloud.
-
On the Home page, go to Design section and click Agents.
-
Click Create Agent Group.
-
Enter the following information:
- Agent Group Name
- Identifier
Note: The agent group name and identifier must be same.
- Agent Type: “Connectivity Agent”
- Description
-
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 the connectivity agent installer, see the following:
- Download and Run the Connectivity Agent Installer for Oracle Integration Cloud Generation 2
- Download and Run the Connectivity Agent Installer for Oracle Integration Cloud Generation 3
Installing On-Premises Agent
To install an on-premises agent:
-
Login to Oracle Integration Cloud.
-
On the Home page, go to Design and click Agents.
-
Click Download.
-
Select Connectivity Agent.
-
Select Save File when prompted to save the file to a directory location on your on- on-premises host.
-
Navigate to that directory and unzip oic_connectivity_agent.zip.
-
Change the file permissions to allow running the file.
-
Download the Oracle Utilities Customer 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 -
Modify InstallerProfile.cfg to include the following information:
-
Provide the oic_URL value with the OIC SSL host name.
Example: https://oic.example.com:443
-
Provide the agent_GROUP_IDENTIFIER. It should be the agent group created in Oracle Integration Cloud.
-
Set the proxy parameters if the connectivity agent is used with a proxy in the on- premises environment.
-
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
-
Run the connectivity agent installer from the command prompt.
java -jar connectivityagent.jar -
Provide the Oracle Integration Cloud credentials when prompted.
-
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:
- Navigate to the Agents page in Oracle Integration Cloud.
- Check if the agent count for your Agent Group is increased by one.
- Click the number to view the agent details.
For more details, refer to Oracle Integration Cloud documentation.
Setting up Certificates for Security
Important! Skip this section if there are valid CA certificates for the integration.
If there are no valid certificates for this integration, download the Oracle Utilities Customer Cloud Service certificates and upload them to Oracle Integration Cloud to handshake with Oracle Utilities Opower.
To download the Oracle Utilities Customer Cloud Service certificate:
- Login to Oracle Utilities Customer Cloud Service.
- Click the URL on the top-left corner.
- On the Security tab, click View Certificate.
- On the Details tab, click Export.
- Save the certificate.
To upload the certificate to Oracle Integration Cloud:
- Login to Oracle Integration Cloud with Admin credentials.
- Navigate to Settings > Certificates.
- On the Certificate window, click Upload.
- Select Certificate Type as Trust Certificate.
- Provide the Certificate Alias Name.
- Select the certificate to upload.
- Click Upload.