Integration

Get Involved. Join the Conversation.

Topic

    Ritu
    OIC Connectivity AgentAnswered
    Topic posted June 7, 2018 by RituSilver Medal: 2,000+ Points, tagged Agent, Connection, Integration 
    1135 Views, 8 Comments
    Title:
    OIC Connectivity Agent
    Summary:
    Coomunication and High Availability Details
    Content:

    Hi,

    Could anybody throw some light what exactly happens in the background when an OIC agent is installed ,how exactly it communicates with OIC instance and how does the agent ensures high availability.

     

    Thanks

    Best Comment

    Ravi Sankaran

    Ritu,

    Connectivity Agent communicates with OIC / ICS over standard HTTP protocol.

    Here are the salient features of the Connectivity Agent that are vividly described in the documentation.

    • No ports are opened on the on-premises system for communication.

    • All communication is secured using SSL.

    • The on-premises connectivity agent registers with Oracle Autonomous Integration Cloud over SSL using the provided Oracle Autonomous Integration Cloud credentials.

    • The on-premises connectivity agent checks for work by making outbound requests through the firewall.

    • The on-premises connectivity agent can use a proxy to access the internet (the same proxy as other internal applications and browsers use). Authentication support for outbound proxy access is provided.

    • The on-premises connectivity agent connections are configured by the agent retrieving the configuration details from Oracle Autonomous Integration Cloud.

    • The on-premises connectivity agent processes requests by pulling messages from Oracle Autonomous Integration Cloud across SSL.

    • The on-premises connectivity agent posts responses by pushing messages to Oracle Autonomous Integration Cloud across SSL.

    • All communication is initiated by the on-premises connectivity agent.

    • No private SOAP-based web services are exposed.

    • No existing J2EE container is required to deploy the on-premises connectivity agent.

    • No data is persisted in the on-premises agent.

     

    Regarding HA, when the feature becomes available, the 2 agents that are associated to a single agent group form a virtual cluster. As you are aware, Agent Group is specified during agent installation. All of the work requests emanating from integration flows having connections bound to this agent group will be available for either of the agent to process. It is the 'Competing Consumer Pattern' that is in the play.

    Ravi

     

    Comment

     

    • Nagireddy Tadi

      Hi Ritu,

      On a high level Connectivity Agent will poll OIC agent channels  for messages. When ever it found messages it will pick and process and sends the response.

      Agent high availability is in works.  Will be available in future release.

      • Ravi Sankaran

        Adding to what Nagi said:

        Connectivity Agent installed behind the firewall makes an outbound https request to OIC / ICS for all communications. This communication is protected using TLS ( transport level security). And there’s absolutely no need for customer to open up the inbound port on the firewall 

        ravi

    • Ritu

      Hi Nagi and Ravi,

      " Connectivity Agent will poll OIC agent channels  for messages." Does this means that OIC agent no more listens to OMCS?

      Thanks

    • Amandeep Mahajan
      Hi Ritu,
       
      Based on your few questions, I assume you have some older documentation or content for the Connectivity Agent. The agent does not use OMCS and that goes as far back as ICS 17.3.5 release. In short, Agent talk to OIC/ICS requesting work and if there is work that needs to be processed that processing happens in the Connectivity Agent and a response sent back to OIC/ICS.
       
      Regarding HA as Nagi mentioned that will a feature available in agent in a near future. Though, it will be great if you can capture your exact requirement around HA? Given that agent is of a small size and the startup is extremely fast, in an event of failure a new agent (with the backed up data) can be up and running in a matter of minutes. See if it is something that will suffice for you till the exact feature becomes available. Please, refer to below link
       
      https://docs.oracle.com/en/cloud/paas/integration-cloud/integrations-user/backing-and-recovering-connectivity-agent.html
       
      Thanks
      Aman 
    • Ritu

      Hi Experts,
      Thanks for the quick updates.What I am trying to understand is how OIC agent is communicating with OIC instance.When we say that agent polls the channels, what channels are we talking about here?I was going through the agent properties file as below:
      icsPlatform=ExternalCompute
      proxyAuth=
      adminProfile=
      authenticatedProxy=false
      agentTransport=aq
      proxy_nonProxyHosts=
      namespace=CONNECTIVI_AGENT_GROUP
      omcsUri=
      proxy_host=
      agent_port=
      managedserverport=
      agentWorkerThreads=40
      proxy_port=
      externaljars=
      onPremiseAgentVersion=18.2.5.0.0
      agentInstanceId=CA-SAMPLE-XXXXXX
      icsRESTBaseURI=https\://***.oraclecloud.com\:443

      Does it mean this channel is AQ channel(on OIC instance) where the agent is polling?Are there any oracle documentation which talks about agent communication architecture as a whole.

      From HA availability perspective, lets say for example, one agent(agent 1 & agent 2) is installed on each of the on premise managed node(node 1 & node 2).If one of the agent goes down then how is the load balancing and high availability managed here? 

      Thanks..

      • Ravi Sankaran

        Ritu,

        Connectivity Agent communicates with OIC / ICS over standard HTTP protocol.

        Here are the salient features of the Connectivity Agent that are vividly described in the documentation.

        • No ports are opened on the on-premises system for communication.

        • All communication is secured using SSL.

        • The on-premises connectivity agent registers with Oracle Autonomous Integration Cloud over SSL using the provided Oracle Autonomous Integration Cloud credentials.

        • The on-premises connectivity agent checks for work by making outbound requests through the firewall.

        • The on-premises connectivity agent can use a proxy to access the internet (the same proxy as other internal applications and browsers use). Authentication support for outbound proxy access is provided.

        • The on-premises connectivity agent connections are configured by the agent retrieving the configuration details from Oracle Autonomous Integration Cloud.

        • The on-premises connectivity agent processes requests by pulling messages from Oracle Autonomous Integration Cloud across SSL.

        • The on-premises connectivity agent posts responses by pushing messages to Oracle Autonomous Integration Cloud across SSL.

        • All communication is initiated by the on-premises connectivity agent.

        • No private SOAP-based web services are exposed.

        • No existing J2EE container is required to deploy the on-premises connectivity agent.

        • No data is persisted in the on-premises agent.

         

        Regarding HA, when the feature becomes available, the 2 agents that are associated to a single agent group form a virtual cluster. As you are aware, Agent Group is specified during agent installation. All of the work requests emanating from integration flows having connections bound to this agent group will be available for either of the agent to process. It is the 'Competing Consumer Pattern' that is in the play.

        Ravi

         

    • Ritu

      Thanks Ravi and experts , this was really helpful.