Skip to main content


Workday Adaptive Planning KB

Configure the Data Agent Manager

After you install the Adaptive Data Agent Manager on your PC, you must launch and configure it.

Adaptive Data Agent Setup

Before You Begin

  • Required permissions: Integration > Data Designer
  • Verify you downloaded and installed the Adaptive Data Agent Manager 
  • Verify you have access to a valid Adaptive Insights username and password
  • Verify your network whitelists * domains, and that port 443 is open on your computer

How You Get There

Compass.png Go to nav menu navicon.gif > Integration > Design Integrations

Basic Steps

  1. Launch the Adaptive Data Agent Service Manager and verify connectivity.
  2. Configure the Adaptive Data Agent Manager.

Launch the Adaptive Data Agent Manager and Verify Connectivity

Adaptive Data Agent Manager - Network Settings

  1. Search for and launch the Adaptive Data Agent Manager on your local computer.
  2. Select Diagnose and Configure Network in the login prompt to open the settings and cluster URLs dialog.
  3. Provide proxy settings if your network requires, and select Update Proxy Settings to save them.
  4. Select Test Service Internet Access then Test Your Internet Access to verify your connectivity.
  5. Select Cluster URLs and review the settings. By default, the Admin and Server URLs use Adaptive Insights domains.
  6. Log in with a valid Adaptive Insights username and password to open the Data Agent Manager.
    If your instance is Workday-enabled and you synchronized users from Workday to Adaptive Insights, you must use your Workday credentials. See Log into the Data Agent with Workday Credentials.
  7. View the Service Internet Connection field to verify that Service Internet Connection status is bright green and Healthy. 

From the Data Agent Manager Setup tab, select Refresh to reestablish the connection to your selected server. You can also select Diagnose and Configure Network to adjust network settings.

Port 443 must be open on the computer running the Data Agent Manager to communicate with Adaptive Insights. Also verify that * domains are whitelisted for your network. See Data Residency Requirements and Domain Whitelisting for more information.

(Optional) Set Appliance Cluster Base URL 

The Diagnose and Configure button lets you set the URL for an appliance cluster base if your Dashboards runs as an appliance in a custom cluster. This button also lets you set the URLs for your Adaptive Insights server information. Contact Adaptive Insights Support before changing them.

  1. Select Set as Required for this Cluster to save a change to the cluster base URL.
  2. Select Apply Cluster Settings to save changes to the Adaptive Insights server information or select Restore Defaults to restore the default values. 
  3. Verify the Service Internet Connection field in the Adaptive Data Agent Manager Setup tab turns green and indicates Healthy. 

Gateway URL and Geography

Gateway URL and geography fields automatically populate when you install and provision agents.

The Switch Geography button activates in the Cluster URLs tab if the Recommended Actions in the Setup tab indicates a gateway geography conflict.

  Contact Adaptive Insights support before modifying Gateway and Geography settings.

Configure the Adaptive Data Agent Manager

After you establish the network connection, set the Adaptive Data Agent Manager service and information options. 

Adaptive Data Agent Services Info

  1. Select Service Info & Options in the Adaptive Data Agent Manager.
  2. Select Refresh a few times if you adjusted your network settings and you don't see the changes.
  3. Review your settings:
  • Remote Access URL (Host Hint): (Read-only) the URL uniquely identifies the gateway connecting the Adaptive Data Agent Man­ager with the Adaptive Integration server.
  • Data Agent Service Id: (Read-only) uniquely identifies the specific agent service. When the agent service ID appends to the remote access URL, the resulting URL gives the full URL addressing the specific Adaptive Data Agent service.
  • Max Disk Storage per Agent (MB): Disk storage in megabytes for storing the information extracted by each agent. Enter -1 for unlimited.
  • Number of Kettle Job Runners: Number of Kettle job runners allowed on this computer, usually just 1. Best Practice: Fewer is better because more runners use more RAM.
  • Max Memory per Job Runner (MB): Maximum memory in megabytes per job runner.
  • Max Temp Disk Size per Job Runner (MB): Maximum temporary disk size in megabytes per job runner. Enter -1 for unlimited.
  • Trusted Tenants: Tenants allowed to create new agents on this computer over the Internet without logging in to this computer. You can also select Users from any Tenant can create Agents on this PC (not recommended), but doing so does not guarantee you control access to your data.
  • Restrict Job Runner Access to Files: Selected by default. Restricts access to local files directly under control of the data agent. Uncheck to access files throughout the file system.
  • Verbose Logging: Select for verbose logging.
  • Log all Comms: Logs entries for all database and net­work communication between the Adaptive Data Agent Manager and the agents.
  • Scrub Non-printing characters: Removes or transforms illegal XML characters and unwanted characters from input text streams. Requires a scrubbingRules.txt file for removing additional characters you do not want. See the Remove Specified Characters from Input Text Streams in JDBC and Microsoft Dynamics GP  section of this article for details.
  1. Troubleshoot any connection problems by selecting Show Data Agent Service Log to display the log files.
  2. Select Apply Data Agent Service Settings to apply changes.
  3. Continue with Create a Data Agent.
Remove Specified Characters from Input Text Streams in JDBC and Microsoft Dynamics GP

When a Data Agent loads data via a JDBC data source or Microsoft Dynamics GP data source, the data writes to the local hard disk as XML. This XML may contain control characters:

  • TAB (0x9)
  • New Line (0xA)
  • Carriage Return (0xD)
  • Other non-printing characters

Data Agents stream data into these XML files without encoding. If control characters outside of the XML character range stream in, errors show up. You can remove or transform illegal XML and other unwanted characters from input text streams by using a scrubbingRules.txt file.

  1. Create a text file named scrubbingRules.txt in C:\Program Files\Adaptive Data Agent.
  2. List the characters you want removed or transformed in the scrubbingRules.txt file. 
  • Each line must contain the old character and the new value separated by "=".
  • Leave the new value empty if you to remove the character. Each character must be rep­resented by its Unicode value.
  • Lines starting with a # get treated as a comment.

Example scrubbingRules.txt file content:

#Tab, New Line and CR





  1. Launch the Adaptive Data Agent Manager.
  2. Select the Service Info & Options tab and select Scrub Non-printing Characters.
  3. Select Apply Data Agent Service Settings.

If you select Scrub Non-printing Characters, all illegal XML characters disappear from the input data, even if those characters don't appear in your scrubbingRules.txt file.

  1. Restart the Adaptive Data Agent windows service.

Scrub Non-printing Characters does not affect Scripted Data Sources. Use scripting to remove or transform characters as needed.

Locate Logs for Troubleshooting Adaptive Data Agent Issues

If you need to troubleshoot issues, or if Support asks for them, you can find logs within:

C:Windows\System32\config\systemprofile\AppData\Local\Adaptive AgentService\Agents\<agentId>\Logs\AgentLog.txt


  • Was this article helpful?