Summary
This article provides a reference for agent exit codes, reasons for failures, and recommended resolutions during agent operations such as initialization, dry run, and uninstall processes.
Problem
During agent installation, initialization, dry run, or uninstallation, various exit codes may be reported. Each exit code indicates a specific problem with the agent environment, files, or functions.
Cause
Exit codes occur due to issues such as:
Missing agent folders or files.
Invalid or corrupt
spsanercontroller.dll.Failure during agent dry run or initialization.
Loading previous agent versions.
Resolution
| Exit Code | Reason | Resolution / Action | Comments |
|---|---|---|---|
| 1 | No active version detected | Ensure an active agent version is installed | — |
| 2 | Agent/<active-version>/bin folder missing | Verify the folder structure for the active version | — |
| 3 | spsanercontroller.dll missing in active version | Confirm DLL exists in bin folder | — |
| 4 | Agent/<previous-version>/bin folder missing | Verify folder structure for previous version | — |
| 5 | spsanercontroller.dll missing in previous version | Confirm DLL exists in previous version folder | — |
| 6 | Invalid spsanercontroller.dll | Replace the DLL with a valid copy | — |
| 7 | Failed to load agent dry run function | Ensure all dependencies are available | — |
| 8 | Agent dry run failed | Check agent logs to identify issues | — |
| 9 | Agent initialization failed | Verify installation integrity and system requirements | — |
| 10 | Agent loaded with previous version | Update to the latest agent version if required | — |
| 11 | (AgentUninstall) No active version detected | Verify agent installation before uninstall | — |
| 12 | (AgentUninstall) 2 | Check folder structure of active version | — |
| 13 | (AgentUninstall) 3 | Check DLL file existence | — |
| 14 | (AgentUninstall) 4 | Verify previous version folder structure | — |
| 15 | (AgentUninstall) 5 | Confirm previous version DLL file | — |
| 16 | (AgentUninstall) 6 | Replace invalid DLL | — |
| 17 | (AgentUninstall) 7 | Ensure dry run function can be loaded | — |
| 18 | (AgentDryRun) 4 | Verify previous version folder for dry run | — |
| 19 | (AgentDryRun) 5 | Confirm previous version DLL file for dry run | — |
| 20 | (AgentDryRun) 6 | Replace invalid DLL for dry run | — |
| 21 | (AgentDryRun) 7 | Ensure dry run function loads successfully | — |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article