Adaptive Integration Data Agent Technical Requirements

Adaptive Data Agents

The Adaptive data agent is a component of Adaptive Integration that runs on a Adaptive Insights customer on-premises
server. The data agent extracts information from a JDBC-compliant database or a custom scripted data source. Data
agents can also export data from Adaptive Insights. The data agent requires a computer running Windows deployed
behind a customer firewall, and runs as a hosted service. The data agent manages access to on-premises applications
as well as connections to Adaptive Integration on the cloud.

The Adaptive Data Agent Service (the Agent Service) manages the data agents. This service runs as a Windows
Service and launches a Java application installed behind the customer’s firewall. The Agent Service long polls the
Adaptive Gateway. The Adaptive Gateway server brokers communication through the firewall to on-premises instances
of the Agent Service. This gateway receives requests from Adaptive Insights servers on behalf of all data agents hosted
by that instance of the service. Each installed instance of the Agent Service can host multiple data agents.

The installation includes the Adaptive Data Agent Service Manager, a desktop utility the customer uses to intially setup
and configure the Agent Service. The installation optionally includes Pentaho Kettle and Spoon, the Kettle ETL
Designer. If the optional Pentaho Kettle components get used, the Agent Service manages a pool of Kettle ETL
execution instances (job runners). Each execution instance is a Java virtual machine running in its own process. The
Agent Service delegates any Kettle ETL scripts that launch to a free job runner. Adaptive Insights provides plugins to
enable design-time connectivity between the Spoon environment and Adaptive Integration. These plugins allow for
authenticating into a cloud instance of Adaptive Insights, publishing scripts to the cloud, and testing the script-based
integration from within the Kettle UI. Note that the optional Pentaho components are needed only if there is a
requirement to use a Pentaho Kettle script to extract data. These components are not needed if the data agent extracts
data out of JDBC-compliant databases using Adaptive Integration’s JDBC data sources.

The on-premises data agents get managed and controlled from the cloud using the agent UI. The agent UI is part of
Adaptive Integration’s data designer, which is accessed through a web browser. When an agent is created in the data
designer, the customer can download and install the latest version of the data agent, along with the optional Pentaho
Kettle components. The agent UI shows the current status and version details of the agents and allows the customer to
provision/unprovision/suspend/resume data agents. The customer can also upgrade to a newer version of the data
agent through the agent UI. See Adaptive Integration.

Exported Date: Thu, 20 Feb 2020 17:13:49 GMT

©Copyright 2020, Adaptive Insights, a Workday Company. All rights reserved.
1
Technical Specifications
The following technical specifications are recommended for the machine the data agent will reside on. Exact
specifications will depend on data volumes and should be reviewed with an Adaptive Insights Professional Services
consultant.

Operating System
Supported platforms:

• Windows 2019 Server

• Windows 2016 Server
• Windows 2012 Server (R2)
• Windows 2008 Server (R2 is recommended)
• Windows 10
• Windows 8.1
• Windows 7

Data Agent Support for Pentaho Kettle and Java version:

Data Agent Version Java Version Pentaho Data Integration (Kettle) Version

2019.3 Data Agent v8 8, 11, OpenJDK 8.2

2017.1 Data Agent v60 and v7x 8 6.1

Legacy Data Agent earlier than v60 7 4.4

2019.3 Data Agent v8 Support by OS, JDK, and Kettle Version

OS JDK Pentaho Data Integration (Kettle) Version

Windows Server 2016 Open JDK 8 No Kettle

Windows Server 2016 Open JDK 8 Kettle 8.2

Windows Server 2016 Open JDK 8 Kettle 7.1

Windows Server 2016 Open JDK 8 Kettle 6.1

Windows Server 2016 Open JDK 11 No Kettle

Windows Server 2019 Open JDK 8 No Kettle

Windows Server 2019 Open JDK 11 No Kettle

Windows Server 2016 Oracle JRE 8 No Kettle

Exported Date: Thu, 20 Feb 2020 17:13:49 GMT

©Copyright 2020, Adaptive Insights, a Workday Company. All rights reserved.
2
 OS JDK Pentaho Data Integration (Kettle) Version

Windows Server 2016 Oracle JDK 8 Kettle 8.2

Windows Server 2016 Oracle JDK 8 Kettle 7.1

Windows Server 2016 Oracle JDK 8 Kettle 6.1

Windows Server 2016 Oracle Java SE 11 No Kettle

Windows Server 2019 Oracle Java SE 8 No Kettle

Windows Server 2019 Oracle Java SE 11 No Kettle

Kettle Spoon starts with a parameter setting of Max Heap Size 2048MB if you don't specify your own.
When Spoon launches with a 32-bit JDK, this parameter prevents successful start-up. For 32-bit JDKs set
the Max Heap Size using: set PENTAHO_DI_JAVA_OPTIONS="-Xmx1024m"

Disk Space
60 GB of disk space is recommended. This is used for temporary files and disk caching and actual size needed will vary
based on the needs of the customer’s implementation.

Memory
A minimum of 8GB is recommended. If a virtual machine is used to host the data agent, 12GB is recommended.

Connectivity
The data agent uses HTTPS to communicate with the Adaptive Insights servers. Port 443 (default port for HTTPS) is
used by the Data Agent Service Manager to communicate with the Adaptive Insights servers and other web-based
sources.

Geographies
One machine running the agent service cannot serve tenants in multiple geographies.

Domain Whitelisting
Traffic balancing and data sovereignty/data residency management requires whitelisting *.adaptiveplanning.com
domains.

Exported Date: Thu, 20 Feb 2020 17:13:49 GMT

©Copyright 2020, Adaptive Insights, a Workday Company. All rights reserved.
3