OIC Gen 3 - installing a Connectivity agent

Workflow for using the connectivity agent:

1. Create an agent group
2. Download the agent installer
3. Download the agent group config file
4. Install jdk 17 and install agent
5. Create an adapter connection and select the agent group
6. Design an integration that uses the connection.

Step1: Create an agent group

Navigation: Design >> agents >> create >> provide agent name >> create

An Oauth client app will be auto created in OCI IDCS.

Step2: Download the agent installer

Navigation: Design >> agents >> doenload >> connectivity agent

It will download a .zip file(oic_conn_agent_installer.zip)

The zip has following files

• Agent home
• Connectivityagent.jar
• Cpi_upgradeutility.jar
• InstallerProfile.cfg

Step3: Download the agent group config

Navigation: Design >> agents >> select ellipsis(...) of the created agent group >> download config.

It will download the InstallerProfile.config file, filled with  all the Oauth details like client id, cliwnt secret, scope, idcs url, oic url, agent group identifier etc.

Step4: Ensure that you have installed jdk 17 and set $JAVA_HOME and update $PATH to include $JAVA_HOME/bin

Step5: Install agent

Go to command prompt >> cd the agent installer unzipped path >> run the below command

java -jar connectivityagent.jar

To run in the background: 

nohup java -jar connectivityagent.jar &

Step6: Associate the connection with agent group

Restarting the agent:

Stop the agent on host machine:

CTRL + C or kill -9 pid

Run the agent with same cmd:

java -jar connectivityagent.jar

Agent monitoring:

Observability >> agents

Post-Installation: Examining the Files

• Located in the agenthome/agent/config directory:
• CpiAgent.properties: Contains infrastructure information.
• logging.properties: Specifies logging severity levels.
• Located in the agenthome/logs directory:
• Agent diagnostic log files: Used for troubleshooting information.