Skip to main content
Documentation
Documentation
Adaptive Planning
Last Updated: 2026-07-24
Reference: Integration Data Agent Technical Requirements

Reference: Integration Data Agent Technical Requirements

Data Agents

The data agent is a component of Integration that runs on an Adaptive Planning 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 Planning. 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 Planning on the cloud.
The 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 Planning Gateway. The gateway server brokers communication through the firewall to on-premises instances of the Agent Service. This gateway receives requests from Adaptive Planning 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 Workday Adaptive Planning Data Agent Manager, a desktop utility the customer uses to initially setup and configure the Agent Service.
The on-premises data agents get managed and controlled from the cloud using the agent UI. The agent UI is part of the Adaptive Planning data designer, 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. 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 Concept Integration.

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 Planning Professional Services consultant.
Operating System
Supported platforms:
  • Windows 2022 Server
  • Windows 2019 Server
  • Windows 2016 Server
  • Windows 11
  • Windows 10
Data Agent Support for Pentaho Kettle and Java version:
Data Agent Version
Java Version (64 bit Recommended)
Pentaho Data Integration (Kettle) Version
2026R1 Data Agent v20
OpenJDK 11, Azul Zulu OpenJDK 11
9.3
2025R1 Data Agent v19
OpenJDK 11, Azul Zulu OpenJDK 11
9.3
2024R2 Data Agent v18
OpenJDK 8, Azul Zulu OpenJDK 8
8.3
2024R1 Data Agent v17
OpenJDK 8, Azul Zulu OpenJDK 8
8.3
2023R2 Data Agent v16
OpenJDK 8, Azul Zulu OpenJDK 8
8.3
2023R1 Data Agent v15
OpenJDK 8, Azul Zulu OpenJDK 8
8.3
2022R2 Data Agent v14
OpenJDK 8, Azul Zulu OpenJDK 8
8.3
2022R1 Data Agent v13
OpenJDK 8, Azul Zulu OpenJDK 8
8.3
2021R2 Data Agent v12
OpenJDK 8, Azul Zulu OpenJDK 8
8.3
2021R1 Data Agent v12
OpenJDK 8, Azul Zulu OpenJDK 8
8.2
2020R2 Data Agent v10
OpenJDK 8, Azul Zulu OpenJDK 8
8.2
2019.3 Data Agent v8
OpenJDK 8, Azul Zulu OpenJDK 8
8.2
2017.1 Data Agent v6 and v7x
OpenJDK 8, Azul Zulu OpenJDK 8
6.1
Legacy Data Agent earlier than v6 - Not Supported
Not Supported
Not Supported
If you don't use Kettle scripts, you can also use Java Version 11.
Disk Space
We recommend 60GB of available space on the C: drive to install the Data Agent and store temporary files and cached data. You can't use another drive for this space.
  • A minimum of 2GB dedicated to the Data Agent is required.
  • Additional disk space required for temporary files and cached data depends on your specific 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 Planning servers. Port 443 (default port for HTTPS) is used by the Data Agent Service Manager to communicate with the Adaptive Planning servers and other web-based sources.
Geographies
One machine running the agent service cannot serve tenants in multiple geographies.
Restricting Access by Domain
Traffic balancing and data sovereignty/data residency management requires access to
*.adaptiveplanning.com
 domains.