Recast Agent not Connecting

There are times when a Recast Agent attempts to connect to a Recast Management Server, but is unable. You'll see a warning in the Recast Management Server telling you that there is an Agent that is trying to connect, but it is not approved. This most often occurs if you delete the Agent from the Recast Management Server manually. Because the Agent information is deleted, there is no way to approve this Agent.

Error: A Recast Agent is trying to connect, but is not approved.

Agent Trying to Connect to RMS


Forcing the Agent to re-enroll gives you a way to approve an Agent, allowing it to connect again.

To re-enroll an Agent:

1. Log onto the computer where the Agent is not connecting.

2. Navigate to the agent.sqlite file location:

Version 5.X Recast Agent: C:\ProgramData\Recast Software\Recast Agent

Version 4.X Recast Agent: C:\Windows\System32\config\systemprofile\AppData\Roaming\Recast Software\Recast Agent

3. Delete the agent.sqlite file in that folder.

4. Restart the Recast Agent Service.Restarting the Recast Agent Service

The Agent Computer should appear on the Recast Agents page in the Remote Software Center and in the Recast Management Server interface. The Agent will be auto-approved or available to be approved depending on the settings in your Recast Management Server.Recast Agent is Back!

Builder Action


PowerShell Script

Stop-Service -DisplayName “Recast Agent Service”
Remove-Item “C:\Windows\System32\Config\Systemprofile\Appdata\Roaming\Recast Software\Recast Agent\agent.sqlite”
Start-Service -DisplayName “Recast Agent Service”