Search results for:
Table of Contents
Included in our VPSes (managed and unmanaged) is the Hostwinds Cloud Agent, a suite of tools that interface the OS inside the VPS to the API for Cloud Control. The Cloud Agent is responsible for setting the IP address, root/Administrator password, hostname, and SSH keys inside the VPS OS. It runs automatically during boot to make sure changes within Cloud Control are reflected inside the server. In addition, the Cloud Agent is used for setting up Cloud Backups and keeps your OS software up to date.
The Cloud Agent has several routines:
The first 8 routines are enabled by default on a new VPS install but can be manually modified below.
The Cloud Agent is a command-line tool that can be run from the VNC console, SSH, or inside a cmd or PowerShell window. As shown by the --help option, the normal usage is:
hwagent routine ROUTINE [arguments]
Of note, the run-all argument will only run all the routines already set to run automatically at boot.
To see more information about a specific routine and the arguments available, run
hwagent routine ROUTINE
with no arguments.
To view the status of Cloud Backups on your server:
hwagent routine backups --status
This will show if the backups are enabled/installed, the location, retention period, number of backups available, and the time/date of the most recent backup.
If you've purchased the Cloud Backups service, a ticket will be auto-generated for our team to run the backups install command and verify it's set up and configured. Once this has been done, you will receive an update through our ticketing system that this has been set up and is ready for use during the next scheduled backup within the next 24 hours. You may also run this set up anytime if you need to re-initiate backups for your Cloud VPS server:
hwagent routine backups --install
If you want to manually run a backup without waiting for the next cron to run, run.
hwagent routine backups --run
This will take a few minutes to complete, depending on how much has changed in the server since the last backup.
You can also change the retention period for your Cloud Backups:
hwagent routine backups --retention DAYS
Where DAYS is the number of days worth of restic snapshots to retain. If the number is lower than the current number of restic snapshots, the system will prune older snapshots the next time backups run. You can, of course, use hwagent routine backups --run to prune them immediately.
If, for some reason, you want to remove the backup service from the OS, run
hwagent routine backups --uninstall
This will remove restic and the cron job, but it will not cancel the service or any charges. Please make a ticket to the Billing department to cancel the Cloud Backups add-on.
Similarly, if you want to uninstall restic AND remove the storage for Cloud Backups from your Object Storage, run.
hwagent routine backups --uninstall --purge
Note: This cannot be run after --uninstall, and will not completely remove the Object Storage container. Just delete the contents of it. If you want to stop being billed for Object Storage, you will have to delete the container manually.
After either variant of --uninstall has been run, you can run hwagent routine backups --install to reinstall restic and add the backup cron job to the OS again.
The other routines include several simpler tools that can be disabled, enabled, or run manually:
Note that these all require root/Administrator permissions as they modify system files/properties. The command structure is:
hwagent routine ROUTINE --[enable|disable|run]
For example, if you have a custom hostname set up in your server and don't want it to be reset to hwsrv-XXXX on reboot, run
hwagent routine hostname --disable
Or if you've changed the password or SSH keys in Cloud Control and don't want to reboot the server to set them, use
hwagent routine password --run
hwagent routine ssh_keys --run
It is not recommended to disable the network routinely, but if you do and lose connection to the server, you can log in through Actions -> Get VNC in the Cloud Portal and re-enable it with
hwagent routine network --enable hwagent routine network --run
By default, all of the routines are enabled, and run each bootup in the order listed above, with hostname, ssh-keys, and password run in parallel.
We hope you enjoy this glimpse into the automation running behind the scenes to make your VPS run smoothly and have found the tools provided to be useful. If you have any questions or need any assistance, please reach out to our Support Team 24/7/365 by opening a Support Ticket.
Written by Hostwinds Team / June 5, 2021