Veeam Support Knowledge Base
Appliance Mode (Hotadd) Requirements and Troubleshooting

Appliance Mode (Hotadd) Requirements and Troubleshooting

KB ID:	1054
Product:	Veeam Backup & Replication \| 6.5 \| 7.0 \| 8.0 \| 9.0 \| 9.5 \| 10 \| 11 \| 12 \| 12.1 \| 12.2 \| 12.3 \| 12.3.1 \| 12.3.2
Published:	2011-07-19
Last Modified:	2025-04-25

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

Oops! Something went wrong.

Please, try again later.

Requirements

Known Issues

If the VM disk resides on a vVol, the Veeam VMware Backup Proxy's VM configuration file (vmx) must be on the same vVol.
The Veeam VMware Backup Proxy VM must be located on a host with access to the datastore containing the VM's disks being backed up or replicated, or in the case of a restore operation, where the disks of the restored VM will be placed.

For example, when backing up or restoring to a datastore that is local only to a single host, hotadd will only function if the Veeam VMware Backup Proxy VM is located on that same host so that it can attach the VMDK file to itself.
Ensure that VMware Tools is up-to-date for the Veeam VMware Backup Proxy VM.
To ensure maximum compatibility, the Veeam VMware Backup Proxy VM's configuration version must be updated.
A single SCSI controller can have a maximum of 15 disks attached. To run multiple concurrent jobs with more than 15 disks, add more SCSI controllers to your Veeam VMware Backup Proxy server that is responsible for hot-adding the disks.
VMware KB 1037094: Adding a SCSI controller to the virtual machine
HotAdd may fail if any disk was created with a newer hardware version than the VM being backed up. For example, if a disk was moved from a hardware version 8 VM to a hardware version 7 VM. To resolve this, upgrade the hardware version of the VM.
In the case of a standalone host connection (no vCenter added to the console), only disks of VMs that are located on the same host as the Veeam VMware Backup Proxy can be hot-added. This may require additional proxy servers to be configured on each host in the environment.
HotAdd may fail if you are trying to back up the VM through the host added as a standalone server into Veeam Backup Infrastructure, which is actually being managed by vCenter. The following error message can be found in the source agent log:
```
"Reconfigure attempt failed for VM "" with Vmomi::MethodFault::Exception ("vim.fault.HostAccessRestrictedToManagementServer")"
```
If you plan to process VMs that store disks on an NFS 3.0 datastore, deploying a backup proxy on the same ESX(i) host where these VMs reside is advisable. Veeam KB1681: VM Loses Connection During Snapshot Removal
Virtual Appliance backup job fails after you’ve cloned or restored your VBR server. The reason for that is the incorrect UUID reference for the Veeam Backup VM, which can be found in the following registry key of the Veeam server.
Veeam KB1332: Hot-Add/Virtual Appliance Failures
HotAdd fails if VM disks being backed up don't have unique disk UUIDs across the vCenter, for example, if such VMs were deployed from a single template to different hosts. VMware previously documented this issue in KB 2006865, and it was observed to occur even in vSphere 7. For assistance with investigating and resolving duplicate disk UUIDs, please get in touch with VMware Support.
Backup in HotAdd mode may fail if a SATA controller is configured on a proxy virtual machine. Please refer to the VMware KB article for details: VMware KB 2151091: HotAdd mode throws error while using SATA controller with proxy virtual machine.
Hotadd may fail if a replica of the VBR server or any proxies exist under the same vCenter server as the VBR servers or proxies processing the job.
Veeam KB2159: Appliance Mode (Hotadd) isn't available if proxy VM and its replica are running under the same vCenter

Troubleshooting

Test to see if the disk of the VM to be backed up can be manually hotadded to the proxy. See: http://www.veeam.com/kb1184
Check all Veeam Proxies for unmounted HotAdded disks and release them manually. See: http://www.veeam.com/kb1775
Disable Automount option on the backup proxy, as documented in http://www.veeam.com/kb1882.

Please contact Veeam Technical Support for further assistance.

To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

Product

Topic

Description

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

I would like to receive a follow-up email regarding my feedback

Verify your email to continue your product download

We've sent a verification code to:

An email with a verification code was just sent to

Didn't receive the code? Click to resend in sec

Didn't receive the code? Click to resend

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.