Introduction
Sometimes, while using Valohai on an on-premise machine, you may encounter issues that require debugging. This documentation provides steps to debug common issues that may arise on an on-premise machine.
Steps to Debug Issues
1. SSH into the Machine
First, establish an SSH connection to the on-premise machine where Valohai is installed.
ssh username@your-onpremise-machine
Replace username with your username and your-onpremise-machine with the IP address or hostname of your on-premise machine.
2. Check the Status of Peon Service
Check the status of the Peon service to ensure it’s running properly.
sudo systemctl status peon
This command will display whether the Peon service is active or if there are any errors.
3. Check Logs for Peon Service
If there are no clear errors in the service status, inspect the logs for the Peon service to identify any issues.
sudo journalctl --all -u peon -r
This command retrieves logs related to the Peon service (-u peon) in reverse order (-r), displaying the newest logs first.
4. Restart the Peon Service
If there are no jobs running or if the Peon service seems stuck, you can attempt to restart the service.
sudo systemctl restart peon
This command restarts the Peon service, which may resolve any issues related to its functionality.
5. Contact Support
If none of the above steps helped in resolving the issue, please contact support@valohai.com. You can also provide additional assistance by sending over the logs for further analysis.
sudo systemctl restart peon
sudo journalctl --all --since "1 hour ago" > logs.txt
Attach the logs.txt file to your email, so we can help you quicker.
Conclusion
Debugging issues with an on-premise Valohai machine requires careful inspection of the Peon service status and logs. By following the steps outlined in this documentation, you can efficiently identify and resolve common issues encountered during the usage of Valohai on on-premise infrastructure.