Installing and Testing OIC Connectivity Agent on Windows Machine

 In this article we will learn how to install and use OIC connectivity agent on our local windows machine.

·       Login to OIC integration Instance

·       Click on “Integrations” as shown in below screenshot

·       Click on “Agents”

·       Now click on “Create Agent Group”

 

·       Provide details for Agent group

 

 

·       Now we need to download the connectivity agent. To download click on “Download” and then “Connectivity Agent”. It will download a zip file with name “oic_conn_agent_installer.zip”

 

 ·       Unzip the file("oic_conn_agent_installer.zip"). After unzipping update the “InstallerProfile.cfg”.

We need to edit only below fields.

oic_URL= https://hostname:sslPort

Example- https://xxTest-xxxxxxx-ia.integration.ocp.oraclecloud.com:443

agent_GROUP_IDENTIFIER=XXTEST_AGENT

oic_USER=OIC_username

oic_PASSWORD=Password

Note:-

Username and password are needed only for the first time when we are starting/installing agent.

It would also be needed when there is a network problem and we need to restart the agent. At this time the user which we will be using its password should not be expired.

If username and password not entered in file then it will prompt us to enter at runtime when we start/install the agent.

 

 

 

 

•  After editing open windows command prompt.
• Change the directory to where the agent installer file resides.

 ·       Make sure that JAVA_HOME is set in the windows machine.

·        To check enter “javac” in command prompt. If JAVA_HOME is set, then it               would give list of possible options.

 

•  Now we will run the agent installer

            Enter the command as:

            java -jar connectivityagent.jar

 ·       If everything is fine, we will get log as shown in below screenshot:

 

 ·       Now we will verify the status of agent in OIC instance. For this, in the home page click on

       Monitoring->Integrations->Agents

• The agent should be in Green colour in Agent Monitoring page and should show status as “Available” and “Active”.

 

 

 

 

-------------Creating connection using the Agent---------

Create a connection to file adapter

•  In the homepage click on Integrations->Connections

 ·       Here click on “Create” button

 

•          Select the “File Adapter” from the adapter list.

 ·       Provide the necessary details and in the next window configure agent. Select the agent and click on use

 

 

 

 ·       Test the connection, it should be 100%. Save it and come out of connection screen.

 

 ·       Our connection is ready now. We will create an integration to poll for a new file placed in a folder in the windows machine. Whenever a new file is placed in that folder the OIC integration should get triggered automatically.  We will set the polling frequency as 60 seconds.

 

Create an Integration using file adaper as trigger to poll for new file

·       In the homepage click on Integrations->Integrations

• Click on “Create” button

 

 ·       Select integration style as “App Driven Orchestration”

 

 ·       Provide the basic details

 

 ·       Drag and drop the “XXAgentTest” file adapter trigger connection to the start of integration as shown in below screenshot.

 

 ·       Configure the file operation trigger. Save the integration.

 

 

 

·       Add Tracking Var for integration, then the highlighted error would go away.

 

 ·       Save the integration and click on close.

·       Activate the integration with payload.

 

 

 

·       

•  Once the integration is activated, it will show active status with green colour.

 

 

 Tesing the Integration by placing a file in the folder

•  Place a file in polling folder

 

 

·       ·      The integration should poll the folder in every 60 seconds and should get triggered when a new file is placed in the folder.  In the OIC homepage click on Monitoring->Integrations->Tracking

·       The file “test_polling.txt” should come as the primary tracking var.

·       We can see the activity stream as well