Overview
Guest Agent Errors occur when the virtual machine guest agent is temporarily unavailable or unresponsive.
The guest agent is responsible for handling management operations between the Softdrive platform and the virtual machine, such as status reporting, power actions, and system coordination.
When the guest agent is unavailable, certain actions may fail or display warning messages, even though the virtual machine itself may still be running.
In most cases, guest agent errors are temporary and recover automatically once internal system processes complete.
Applies To
- Softdrive Platform
- Softdrive Virtual Machines (vPCs)
- VM management actions (power, status, control)
Symptoms
- Errors when performing actions like restart, shutdown, or power operations
- VM status not updating correctly in the dashboard
- Messages indicating the guest agent is unavailable or not responding
Possible Causes
- Temporary internal processes running inside the virtual machine
- Guest agent service restarting or becoming momentarily unresponsive
- High system load or resource contention
- Operating system tasks such as updates, shutdowns, or startup routines
- Recent power or system state changes on the virtual machine
These errors are not typically caused by user actions, network connectivity, firewall rules, or client-side configuration.
Resolution
- Retry the action
- Wait a few moments and retry the operation
- Many issues resolve automatically once internal processes complete
- Allow time for system processes
- If the VM is starting, updating, or shutting down, wait until the process completes
- Reboot the virtual machine
- If the issue persists, restart the VM
- This typically restores guest agent functionality
Validation / Expected Result
- VM actions (restart, shutdown, etc.) complete successfully
- VM status updates correctly in the Softdrive dashboard
- No guest agent error messages are displayed
Troubleshooting Notes
- Guest agent issues are typically temporary and self-resolving
- Frequent occurrences may indicate VM performance or resource issues
- Rebooting is the most reliable recovery action
Escalation
If the issue persists, contact Softdrive Support and include the following:
- Error type: Guest Agent Error
- Date and time of occurrence
- Virtual machine name and organization
- Screenshot of the error message
- Description of actions being performed when the error occurred
Email: support@softdrive.co