Here is a list of common failures when deploying the Altaro Hyper-V Host Agent, and how to resolve each failure:
The host machine must have the full .NET4.0 installation.
From 7.6 onward, Altaro requires .NET4.0 to be installed on each host machine. Ensure that it's installed, if not you can find the installation link here: https://www.microsoft.com/en-us/download/details.aspx?id=17851
The host machine and Altaro server have a time offset of more than 5 minutes.
Correct the time and timezone of both machines to ensure they are in sync.
An old installer is getting pushed out.
Delete the C:\ProgramData\Altaro\AltaroBackupProfile\Installers folder from both the machine running Altaro and the Hyper-V host. Then re-attempt the deployment.
The agent was actually pushed and installed successfully but took longer to start than expected and the UI times out.
Click on the Discover Virtual Machines button on the host list in the UI. The connection will be refreshed and if the agent is installed and running then the UI will be corrected.
A previous install / uninstall of the Altaro Hyper-V backup software on this machine required a restart.
Restart the Hyper-V Host and try push the agent again.
Altaro Hyper-V Backup v4.x is running on the Hyper-V Host.
You must first uninstall v4.x before pushing a v5.0 agent to that machine. Uninstall v4 using the REMOVEALTARO command in command prompt or using the Windows Uninstall Control panel and then try the deployment again.
You have a newer version of the Altaro Hyper-V Host Agent software running on the Hyper-V Host.
You cannot push an Agent from an older version of Altaro Hyper-V Backup if the host is already running a newer version. You need to uninstall the Hyper-V Host agent using the REMOVEALTARO command in command prompt or using the Windows Uninstall Control panel and try again.
Windows Firewall is blocking ports required to copy over the installer files from the Altaro Hyper-V Backup machine to the Hyper-V Host.
Open the ports required (as below) on your firewall:
(a) to copy over the installer and invoke it: TCP 445 and UDP 445.
(b) for Altaro Hyper-V Backup and Altaro Hyper-V Host agent to communicate: TCP 35108 and 35221
The Host machine has other users logged to terminal services. Even though pushing the agent is successful, it still indicates that it requires an upgrade.
You need to uninstall the Hyper-V Host agent using the REMOVEALTARO command in command prompt or using the Windows Uninstall Control panel and try again.
If all else fails... you can easily install the agent manually