Skip to main content

logoCorrectSize.png

Adaptive Insights LLC.

Data Agent will not provision after sandbox refresh

This article includes suggestions and workarounds. Content may not be accurate for all use cases or represent best practices for the latest release. 

Question

Why is my Data Agent not provisioning after a recent migration, clone, or refresh?

Answer

Data Agents that were previously provisioned in a sandbox might not exist after a sandbox refresh because the refreshed sandbox is a copy of another instance and the integration configuration may be different from what was previously configured in the sandbox.

The on-premise Data Agent software does not automatically remove local configuration files related to the old sandbox agents; however, it will still allow a user to try to provision the new sandbox agents which may have the same name and internal identifier as the old sandbox agents. This can cause the Data Agent on the server to enter a "provisioning" state indefinitely meaning that it will never complete successfully or terminate with an error. 

This can be observed in your new instance via Integration > Data Designer > Data Agent when the agent shows as un-provisioned even though it seems like it is provisioned within the Adaptive Data Agent Service Manager (ADASM) program.

To provision a new agent for a new instance (or recently refreshed instance):
  1. Log in to the Data Agent machine and open the ADASM program

  2. Go to the Backup/Unprovision tab

  3. In the Select Active Agent dropdown menu, select each agent that starts with the production instance code and click Unprovision Agent. You can find the instance code by logging in to the sandbox and going to Administration > General Setup.
    • ADASM.png
  4. After all agents with the production instance code have been unprovisioned, close the ADASM

  5. Log in to the instance and create a new agent in Data Designer

  6. Open the Services program, right-click on Adaptive Data Agent, and click Restart

    • Services.png

  7. After the service has restarted open the ADASM again and provision the production agent via the normal process

The key is to follow the above steps before attempting to provision any agents after the sandbox is refreshed. If the old agents are unprovisioned locally and the service is restarted beforehand, provisioning should work without issue.

  • Was this article helpful?