About the Robot Agent

Install one or more robot agents on each environment. An environment is the computer or virtual machine where a robot runs. A robot agent runs the robot instances on its environment.

To learn more about environments, see About Environments and Environment Pools.

Familiar with the Connectivity Agent?

If you're familiar with the connectivity agent in Oracle Integration, the robot agent offers similar capabilities with some differences.

Area Connectivity agent Robot agent

Usage

Use the connectivity agent to connect to a resource on a private or on-premises network from an integration.

Use the robot agent to run a robot.

Installation and number

Install the connectivity agent on an on-premises machine, typically a virtual machine.

Your organization can install one or many connectivity agents.

Install the robot agent on every environment that must run a robot.

You can install one or more robot agents per environment, and you can create as many environments as you need.

Components

Two types of connectivity agents are available:

  • SaaS agent, which runs in Oracle Integration. Oracle manages this agent.
  • On-premises agent, which you must install and manage.

Only one robot agent is available.

Your Responsibilities

Your organization is responsible for several tasks.

Plan the Robot Agent Setup

When planning your robot agent setup, consider the number of robots agents that you need in total, the number of robot agents to install on each environment, and the number environments to create.

For more guidance, see Set Up Enough Environments.

System Requirements

Every environment must meet the system requirements. The following system requirements are for an environment that runs a single robot agent.

Area Requirements

Hardware

Minimum of 8 GB memory with 4 GB of heap size dedicated to the robot agent

If you run other processes on the environment besides the robot agent, Oracle recommends increasing the physical memory

Operating system

Install the robot agent on one of the following certified operating systems:

  • MacOS
  • Oracle Linux 6.x, 7.x, and 8.x
  • RedHat Enterprise Linux 6.6, 7.x, and 8.x
  • Suse Linux Enterprise Edition 12 SP2
  • Windows Standard Edition 2016
  • Windows 2019

Software

  • Java Development Kit (JDK) 17

    You do not need to purchase a JDK license for the sole purpose of installing and/or running the connectivity agent. See JDK license and support for OIC Connectivity Agent (Doc ID 2611142.1).

    The JDK installation can be the same one as used with other products installed on the same host. However, separate JDK licensing may be required for any use of Java beyond the use of the connectivity agent. Ensure that the JDK installation is not modified for use with these other products.

  • One of the following browsers for the environment where the robot agent runs:
    • Apple Safari
    • Google Chrome (recommended) or Headless Chrome
    • Microsoft Internet Explorer
    • Microsoft Edge
    • Mozilla Firefox or Headless Firefox

    Note: Oracle Integration has different browser requirements. See Supported Browsers in Getting Started with Oracle Integration 3.

  • One of the following options for storing secret information in the computer's local keystore:

    • Linux and Unix computers: Keyutils

      You can install Keyutils by installing Homebrew, Yum, or AptGet.

    • Windows computers: PowerShell

      This solution is usually included in the operating system of Windows computers.

    • Mac computers: Security Utility

      This software is usually included in the operating system of Mac computers.

Specifications

Get an in-depth understanding of the robot agent by reviewing its communication method, security protocols, and more.

Area More information

Communication and ports

  • The robot agent initiates all communication and must be able to contact Oracle Integration so that it can poll for work.

    See Review Your Network Configuration.

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

Security protocol

  • The robot agent registers with Oracle Integration over SSL using the provided Oracle Integration credentials.

    See Complete Prerequisites.

  • All communication is secured using SSL.

  • The robot agent processes requests by pulling messages from Oracle Integration across SSL.

  • The robot agent posts responses by pushing messages to Oracle Integration across SSL.

Data persistence

No data is persisted in the robot agent.

Design Considerations

A robot runs on an environment, which is a computer or virtual machine (VM) on which the robot agent is installed. When determining where to place the environment, consider the requirements for the robot's interaction.

Type of robot interaction Location for the environment

Interact with a publicly available website

Ensure that the robot's environments are within a network that can interact with a publicly available web application.

If the computer that hosts the robot agent has restrictions on outbound connections to the public internet, you might need to update your network's allowlist to allow outbound access to the websites that are required for the robot to run. See Update Your Network's Allowlist.

Interact with an internal web application that is within a firewall and VPN

Ensure that the robot's environments are within the VPN with the HTTPS proxy settings configured so that the environments have access to the external web applications.

The environment must be able to access the public internet the first time that you start the robot agent and the first time that you run a robot that launches an internet browser. The robot agent requires this access to download its required dependencies. Therefore, you might need to temporarily disable egress restrictions on the environment the first time you start the robot agent.