On-premise Robots Agent system requirements

Before installing an on-premise Robots Agent, make sure that the server on which the Robots Agent will be installed meets the hardware and software requirements outlined below.

Note

The information in this topic applies only to organizations that use an on-premise Robots Agent to run ACL scripts in ACL robots.

Individuals and organizations with ACL Robotics Professional Edition do not have an on-premise Robots Agent. Python/HCL scripts that run in HighBond robots or Workflow robots do not use the Robots Agent.

Hardware requirements

Note

The best Robots Agent performance in a production environment may require greater resources than the minimum specification.

Component Options Recommendation
Processor
  • 2.5 gigahertz (GHz)
  • Quad-core processor (or two Dual-core processors) at 3.5 GHz or higher
Quad-core processor (or two Dual-core processors) at 3.5 GHz or higher.
Memory

(RAM)

8 GB

16 GB of memory or higher, especially if sorting large files.

Hard disk space
  • minimum of 100 GB
  • 200 - 500 GB

200 - 500 GB of disk space. High-speed disk access and throughput is recommended.

Ports

TCP/IP connectivity. Outbound communication on HTTPS port 443.

Port must be open for outbound communication with Diligent One.

All communication is initiated by the on-premise Robots Agent and is encrypted in transit.

Software requirements that must be confirmed or installed by the user

Note

The on-premise Robots Agent has been tested and verified to work with the listed versions of operating systems and third-party software. The Robots Agent may work with versions other than those listed, however there is no guarantee that it will.

Use of the Robots Agent with versions other than those listed is considered "an unsupported installation" and our Support team may not be able to find a resolution if issues arise.

Requirement Additional information

Windows Server operating system

One of the following operating systems (64 bit):

  • Windows Server 2022
  • Windows Server 2019
  • Windows Server 2016

    (Edition: Essentials or Standard)

Recommended: Windows Server 2019 or 2022

R, 64-bit (optional)

To use Analytics functions that integrate with the R programming language, you must install and configure R.

The following versions of R have been tested and work with the Robots Agent:

  • 4.0.3
  • 3.4.4
  • 3.3.2
  • 3.3.1
  • 3.2.5
  • 3.2.3

You can use either CRAN R or Microsoft R.

Note

Other versions of R may work as well. However, they are not guaranteed to work.

If you are using one of the CRAN R packages, you may need to add the path to the R binary folder to the PATH environment variable on the server.

For example: C:\Program Files\R\R-<version>\bin\x64

Note

You do not need to install R if you do not intend to use the Analytics R functions or RCOMMAND.

Note

Two optional features of Analytics require installing two separate instances of Python:

  • Analytics Python functions require a customer-installed instance of Python
  • Analytics machine learning commands require an instance of Python that can be installed as part of the Robots Agent installation

Additional details appear below.

Python, 32-bit (optional)

To use Analytics functions that integrate with the Python programming language, you must install and configure:

  • Python
  • PYTHONPATH environment variable
  • ACLPYTHONDLL environment variable

The following versions of Python have been tested and work with the Robots Agent:

  • 3.7
  • 3.8
  • 3.9

Note

Any version of Python from 3.7.x onward should work with the Robots Agent. However, versions other than those listed are not guaranteed to work.

When installing Python, you must also configure it to run on the server. For more information, see Configuring Python for use with an on-premise Robots Agent.

Note

You do not need to install Python if you do not intend to use the Analytics Python functions.

Python, 32-bit (optional)

To enable Analytics machine learning commands, you must install:

  • Python engine for Analytics (3.7.9)

If you select the Enable machine learning (install Python engine for Analytics) check box during Robots Agent installation, the installer installs the Python engine for Analytics.

Note

This instance of Python is not intended for use with the Analytics Python functions, or for general Python use. You must install a separate instance of Python for these purposes.

Oracle Instant Client (optional)

To use the ACL Connector for Oracle, you must install:

  • Oracle Instant Client 11g or 12c
  • You do not need to install Oracle Instant Client if you do not intend to use the ACL Connector for Oracle.
  • The bitness of Oracle Instant Client must match the operating system's bitness. If the 32-bit Instant Client is installed on a 64-bit machine, the connection fails.
  • If you install the Oracle Instant Client after the Robots Agent, you must restart the Robots Agent Windows service before you can use the connector.

Automatically installed software prerequisites

If the following software prerequisites are not already installed on the server, they are automatically installed by the Robots Agent installer:

  • Microsoft .NET Framework 4.6.2

    Note

    If the server already has .NET 4.6.0 or 4.6.1, the Robots Agent uses the installed version of .NET and does not install version 4.6.2.

  • Microsoft Visual C++ 2015-2019 Redistributable Package (x64 and x86)
  • Microsoft Visual C++ 2013 Redistributable Package (x64) (only if optional data connectors are installed)
  • Microsoft Visual C++ 2012 Redistributable Package (x64) (only if optional data connectors are installed)
  • Microsoft Access Database Engine 2016 (32-bit) (optional)

Requirements contained in the Robots Agent installation directory

Local copies of the following components are installed with the Robots Agent and contained in the Robots Agent installation directory:

  • Python Engine 3.7.9 and TPOT 0.10.2 – used by the Analytics machine learning commands

Analytics data connectors

The Robots Agent installation includes a number of Analytics data connectors. Most of the connectors are ODBC drivers installed in the Robots Agent installation directory.

Standard data connectors

The following data connectors are installed by default when installing Robots Agent.

Category Connector
Big Data and NoSQL
  • Amazon Athena
  • Amazon DynamoDB (v.2)
  • Amazon Redshift (v.2)
  • Apache Cassandra (v.2)
  • Apache HBase (v.2)
  • Apache Hive (v.2)
  • Apache Phoenix
  • Azure Data Catalog
  • Azure Data Lake Storage
  • Azure Table
  • CockroachDB
  • Couchbase (v.2)
  • Elasticsearch
  • Google BigQuery (v.2)
  • IBM Cloudant
  • MarkLogic
  • MongoDB (v.2)
  • Parquet
  • Presto
  • Snowflake
  • Spark SQL (v.2)
ERP and CRM systems
  • Dynamics 365 Business Central
  • Dynamics 365 Finance and Operations
  • Dynamics 365 Sales
  • Dynamics CRM
  • Epicor ERP
  • Exact Online
  • NetSuite
  • Odoo
  • Oracle HCM Cloud
  • Salesforce (v.2)
  • SAP (to be functional, requires an additional subscription entitlement)
  • SAP ByDesign
  • ServiceNow
  • SugarCRM
  • SuiteCRM
  • Workday
Accounting tools
  • ADP
  • Dynamics GP
  • Dynamics NAV
  • QuickBooks
  • QuickBooks Online
  • QuickBooks POS
  • Sage 50 UK
  • Sage Cloud Accounting
  • Sage Intacct
  • SAP Concur (v.2)
Marketing and analytics
  • Google Analytics
  • LinkedIn
  • Marketo
  • Oracle Eloqua
  • Oracle Sales Cloud
  • Splunk
  • SurveyMonkey
  • Twitter
Collaboration solutions
  • Active Directory
  • Airtable
  • AWS Data Management
  • Azure Active Directory
  • Azure Management
  • Basecamp
  • DocuSign
  • Email
  • Excel
  • Excel Online
  • Exchange
  • GitHub
  • Google Contacts
  • Google Sheets
  • Jira
  • Kintone
  • Microsoft Teams
  • SAP SuccessFactors
  • SharePoint
  • Slack
  • Zendesk
File and API integration
  • Amazon S3
  • Box
  • CSV
  • DigitalOcean
  • Dropbox
  • Google Cloud Storage
  • Google Drive
  • JSON
  • LDAP
  • Microsoft OneDrive
  • OData
  • REST
  • RSS/ATOM
  • SFTP
E-commerce solutions
  • Edgar Online
  • Open Exchange Rates
  • ShipStation
  • Square
  • Stripe
  • UPS
  • USPS
Relational databases
  • Apache Impala (v.2)
  • Azure Analysis Services
  • Microsoft Access
  • MySQL
  • Oracle (v.2)
  • SAP Hybris Cloud for Customer
  • SQL Server (v.2)
  • Sybase
  • Sybase IQ
  • Teradata (v.2)
  • xBase
Security tools
  • Qualys
  • Tenable.sc
Other connectors
  • Rsam

Optional data connectors

The following data connectors are optional, and you can opt to not install these when installing Robots Agent.

  • Amazon Redshift
  • Cassandra
  • Concur
  • Couchbase
  • Drill
  • DynamoDB
  • Google BigQuery
  • HBase
  • Hive
  • Impala
  • MongoDB
  • Oracle
  • Salesforce
  • Spark
  • SQL Server
  • Teradata