KB ID: | 4237 |
Product: | Veeam Backup for Nutanix AHV 3.0, Veeam Backup for Nutanix AHV 2.1, Veeam Backup for Nutanix AHV 2.0 |
Challenge
After installing Veeam Backup & Replication 11a (11.0.1.1261) one or more of the following may occur:
- An AHV Backup Proxy is listed as Unavailable in the Veeam Backup & Replication console.
- The AHV Backup Proxy's Web Console dashboard lists the backup server as unavailable.
- Accessing the AHV Backup Proxy's Web Console results in a page that displays a 502 Gateway Timeout.
- The update wizard or the Veeam Updater displays an error stating "Failed to update Ubuntu to version 18.04.6 LTS"
- AHV Backup jobs fail to run.
- Restore to an AHV cluster is not possible.
Cause
After updating Veeam Backup & Replication to 11a, the AHV Backup Proxy is updated to Veeam Backup for Nutanix AHV v3. The AHV Backup Proxy update process updates the proxy components as well as the appliance's operating system from Ubuntu 16.04 LTS to 18.04 LTS. If the appliance operating system or one of the proxy components fails to update during this upgrade it can leave the proxy in a malfunctioning state.
The following have been identified by Veeam Support to cause the described symptoms :
- The software update removed some custom entries in /etc/hosts file on the proxy.
- Ubuntu failed to update to 18.04 LTS.
- The Nginx component failed to update.
Solution
Find the scenario and solution described below that best fits your situation.
AHV Backup Proxy Web Console and Veeam Backup & Replication list each other as Unavailable
The AHV Backup Proxy is unable to resolve the hostname of the Veeam Backup & Replication server to the correct IP address. If there were custom entries added to the /etc/hosts file before the upgrade, they may need to be added again, as the Ubuntu OS update may have removed them.
Check whether DNS servers are shown in the network configuration, and if they are not - add them back. If they are not there, and the checkbox for automatic obtaining is ticked and greyed out - it helps to check-uncheck the same checkbox for IP-address parameters 1-3 times.
For more information, review Configuring Network Settings and Configuring Hostname Resolution in the Veeam Backup for Nutanix AHV 3.0 user guide.
The AHV Backup Proxy update displays an error message about being unable to download updates.
Ensure that the repositories listed in Used Ports can be reached by the AHB Backup Proxy, then run the update again.
AHV Backup Proxy Web Console displays a 502 Gateway Timeout error
This typically means the update process failed. Reboot the proxy by going into Prism and choosing "Guest Reboot". If the 502 Gateway Timeout errors persist, a new AHV Backup Proxy must be deployed. Expand the section below, and follow the steps.