Frequently Asked Questions for the Virtual Server Agent with VMware
How can I calculate the number of licenses required for VMware?
Generate a Virtual Machine Infrastructure Report to get a summary of protected and unprotected virtual machines that you can use as a basis for requesting capacity licenses or socket licenses for VM protection.
How does the virtualization client perform automatic load balancing of backup jobs?
Why is the backup throughput very low during the full backup?
If you are performing a full backup of virtual machines which have thin provisioned disks on NFS datastore, the backup throughput may become very low. VMware does not support the retrieving allocated blocks on NFS volume. Therefore, if a NFS datastore has a thin provisioned disk, the software reads the complete disk during the full backup. This reduces the backup throughput during the full backup. In case of incremental backups, software uses Change Block Tracking (CBT) and thus reads and backs up only the changed data.
For more information, refer to “Changed Block tracking on Virtual disks" section in the following document:
If the Thin provisioned disk is on VMFS volume, the software reads and backs up only the allocated part of the disk.
How can I force an agentless restore to use the backup LAN?
By default, for agentless restores the VSA proxy goes through the vCenter to determine the IP address for an ESX host. You can configure the nUseHostnameForTransferToGuest additional setting to force the VSA proxy to access the ESX server directly using a DNS entry on the proxy machine. The DNS entry on the proxy can specify an IP address that goes through the backup LAN, preventing it from using an IP address that goes through the production LAN.
- To the VSA proxy computer, add the nUseHostnameForTransferToGuest additional setting as shown in the following table.
For instructions about adding an additional setting from the CommCell Console, see Adding or Modifying Additional Settings from the CommCell Console.
- Create a DNS entry on the VSA proxy that maps the ESX server to an IP address for the backup LAN.
Can I back up fault tolerance virtual machines using the Virtual Server Agent?
You can back up fault tolerant virtual machines that meet the following requirements:
- Configured as fault tolerant in the vSphere Web client
- Hosted on ESX 6.x or later
- VM hardware version 11 or later
For earlier versions of ESX or VM hardware, use an in-guest agent.
For more information about backing up fault tolerance virtual machines, refer to Backing up Fault Tolerance virtual machines (1016619).
Why is an incremental backup converted to a full backup after an in-place restore?
After performing an In-place restore, the first run backup job will always be converted to a Full backup. The system assumes that it is a newly created virtual machine and hence defaults to a full backup.
How do I manually install a new version of VDDK on a VSA proxy?
Multiple VDDK versions are included with the Virtual Server Agent. The appropriate VDDK for the vSphere version is loaded automatically when required. For more details, see VDDK Support for the Virtual Server Agent.
Installing the Latest VDDK Included with the VSA
If necessary, you can override the VDDK version that is loaded automatically based on the vSphere version, and load the latest VDDK that is available for the proxy.
- To the VSA proxy, add the bUseLatestVDDKVersionPath additional setting as shown in the following table.
For instructions about adding an additional setting from the CommCell Console, see Adding an Additional Setting from the CommCell Console.
Installing a Newer External VDDK
If necessary, you can install a newer VDDK that is not yet available with the Virtual Server Agent.
- VDDK files should never be placed in the VDDK installation in the Commvault base directory.
- Only install a newer version of the VDDK for proxies running on Windows. For Linux proxies, use a VDDK version that is included with the Virtual Server Agent package.
To install a newer version of VDDK on a Windows 64-bit computer, perform the following steps:
- Create a new VDDK install folder on the proxy computer (for example, C:\Program Files\VMware\VMware Virtual Disk Development Kit\).
This folder structure already exists if a previous manual 64-bit installation has been performed.
- Download the VDDK package from the VMware download site and extract the files. Copy the bin and lib folders to the new VDDK install folder on the proxy computer.
- Create the following registry key:
HKEY_LOCAL_MACHINE\SOFTWARE\VMware, Inc.\VMware Virtual Disk Development Kit
- Under that registry key, create the InstallPath string and set the value as the VDDK install folder you created for the VDDK executables (for example, C:\Program Files\VMware\VMware Virtual Disk Development Kit\).
- Go to the bin folder under the new VDDK install folder and run the file vstor2install.bat file to install the file-level driver.
For more information see the following VMware pages:
- Virtual Disk Development Kit 6.0.2 Release Notes
- Virtual Disk Development Kit Release Notes for vSphere 6.5
- vSphere 6.7 Release Notes
How do backup and restore operations handle independent/RDM disks?
If a virtual machine undergoing a backup job includes independent disks or physical RDMs, those disks are skipped.
If a subclient contains virtual machines with independent disks or physical RDMs, the backup job completes with the status "Completed w/ one or more errors". However, if you configure the IgnoreUnsupportedDisks additional setting on the proxy computer, the backup job completes without error.
- If the Unconditionally overwrite VM with the same name option is used when restoring from a backup of a virtual machine that had independent disks, the independent disks and their VMDKs are not restored, and are removed from the source datastore.
- You can protect Raw Device Mappings (RDMs) and independent disks in IntelliSnap backup operations. For more information, see Include RDMs and Independent Disks in IntelliSnap Backup Operations.
How do backup and restore operations handle virtual RDM disks?
Virtual RDMs are protected by the backup job. However at the time of restore, the data is restored as a regular VMDK on a datastore. A virtual RDM is not re-created and the data is not restored to the virtual RDM's device.
Note: You can protect Raw Device Mappings (RDMs) and independent disks in IntelliSnap backup operations. For more information, see Include RDMs and Independent Disks in IntelliSnap Backup Operations.
Using the Virtual Server Agent in HotAdd mode configurations
- When deploying the Virtual Server Agent, install the software on a datastore with the largest VMFS block size. This is necessary to ensure that the Virtual Server Agent can mount and back up virtual machines residing on all datastores.
- Helper virtual machines are not required for HotAdd Virtual Server Agent servers using VADP.
What happens if a virtual machine is deleted in the vCenter and a new virtual machine with the same name is created?
In this scenario, even though the name of the virtual machine is same, the new virtual machine will have different GUID/UUID. Therefore, it is recommended to perform following steps:
- In the CommCell console, delete the virtual machine client from the list of client computers
- Perform the backup of the virtual machine. A client will get created again for the virtual machine.
If you do not perform these steps, a new client will get created for the virtual machine with name as follows: <original_virtual_machine_name>_1.
How is white space handled in virtual machine capacity licensing?
When capacity licensing is used, the used space as reported by the guest OS for the virtual machine is reported against licensed capacity. For example, if the guest OS shows 20GB used on a 100GB disk, 20GB is what counts against the licensed capacity. This is the case even if a different figure is reported for VM disks on the datastore, and is not affected by deduplication or compression.
What are the requirements to enable thin provisioned disk restores?
Disk level backups can use allocated block tracking, which is part of VMware Changed Block Tracking (CBT). Allocated block tracking identifies portions of the virtual machine disk that have not been used, so those portions can be skipped during backup or restore. In 10.0, disk restores can reclaim unused space even if allocated block tracking is not enabled.
During disk restore operations, writes of empty data are automatically discarded if the target disk is thin or eager zeroed. This enables thin provisioned disks to be restored to and from NFS datastores or for other VMDKs. Depending on the state of the data inside the virtual machine, it may also be possible for the restore to discard empty data that was previously allocated. The restore recovers all space that is reported in use (not zeroed out), so the restored VMDK can be larger than the size that was reported by the guest OS.
How can I limit VSA user access to specific resource pools or ESX hosts?
You can define users and provide them with role-based privileges in vCenter at any desired level: vCenter, datacenter, ESX host, resource pool, or virtual machine.
- On the vCenter server, define a local user who should have access to a specific level.
- In vCenter, define a role with the required permissions.
- At the desired level in vCenter, add permissions for the user and role.
- In the CommCell, add the user information to the Virtual Server instance properties.
For detailed steps, see Add a Custom User with Limited Scope.
Are Storage Spaces supported for backups and restores?
Storage Spaces is a feature in Windows 8 and Windows Server 2012 that enables drives to be grouped into storage pools to appear as virtual drives in Windows File Explorer.
- For files stored on Windows Storage Spaces, you can perform a live browse to view and restore guest files and folders, with the following considerations:
- The VSA proxy or MediaAgent that is used for the live browse must be running on Windows Server 2012 or later.
- The MediaAgent that is used for the live browse cannot be part of a clustered environment.
- You cannot simultaneously browse two cloned VMs that use the same storage space information.
How is capacity licensing calculated for virtual machines?
Virtual machine backup job data for capacity licensing usage is calculated as follows:
- For streaming backups and backup copy jobs, the capacity usage is based on the guest size for all virtual machines being backed up.
- For IntelliSnap backups, the capacity usage is based on the application size for the virtual machines being backed up.
In the License Summary Report, the Job Size column lists guest sizes for virtual machines included in full or synthetic full streaming backups (including backup copy jobs) and application sizes for snapshots.
Capacity usage is summarized as follows:
- Virtual machine streaming backups are included in the Backup license count (depending on the storage policy configuration).
- Backup copy operations are included in the Backup license count.
- Archived VMs are included in the Archive license count.
- IntelliSnap backups are included in the Snapshot count.
When the same virtual machine is included in multiple backup jobs, only one of the jobs counts against capacity usage. If a virtual machine is included in multiple subclients, the latest backup provides the size included in overall capacity usage. If a virtual machine is included in both backups and archiving jobs, the guest size for the VM counts toward the Backup license.
Note: Logical volume manager (LVM) metadata processing for volumes encrypted using BitLocker is currently not supported. Decrypting contents of such volumes may not be feasible during backup because decryption requires a recovery password or a decryption key. Because metadata collection for the volume fails, the reported guest size for virtual machines with encrypted volumes may be incorrect and a file-level browse operation for the encrypted volume cannot display file information.
When capacity licensing is used, the used space as reported by the guest OS for the virtual machine is reported against licensed capacity. For example, if the guest OS shows 20 GB used on a 100 GB disk, 20 GB is what counts against the licensed capacity. This is the case even if a different figure is reported for VM disks on the datastore, and is not affected by deduplication or compression.
For more information about virtual machine sizes, see Size Measures for Virtual Machines.
Verifying Backup Job Data for Virtual Machines
To review backup information for virtual machines, generate a VM Backup Report.
Alternatively, you can log in to the CommServe host using qlogin and run the following stored procedure on the CommServe database:
qoperation execscript -sn QS_CLAGetVSADetails –cs commserve_host_name –file file_name -format csv
The resulting output shows the size of the latest backup job for each virtual machine. The size value is the guest size for the VM, or the used space if guest size is unavailable; the size value for all VMs is used in the overall capacity licensing calculation.
The output also shows which license category each VM counts against, and provides instance, backup set, subclient, and job information for each VM.
Why is my backup data showing volume numbers instead of drive letters?
If hard disk filtering was used for the backup and the drive that contains the operating system was excluded from the backup, the backup is unable to obtain information about drive letters. You can still browse and restore backed up files on the volumes that were backed up.
Do backups take a snapshot of virtual machine memory?
Virtual Server Agent backups do not snapshot VM memory during backups.
If the File System and Application Consistent option is configured in the Backup Options tab for the subclient, the guest file system and applications are quiesced before taking a hardware snapshot for the backup to ensure data consistency.
Can error and warning messages in guest VMs during backups be ignored?
During VMware backups that create quiesced snapshots of Windows virtual machines, error or warning messages are generated within guest VMs, but the backups complete successfully. These messages can be ignored, because they occur during read-only operations and do not result in any changes to the volumes identified in the messages.
The following errors or warnings might be shown for the guest VMs:
The default transaction resource manager on volume xxx encountered a non-retryable error and could not start. The data contains the error code.
Disk xxx has been surprise removed.
[Delayed Write Failed] Windows was unable to save all the data for the file xxx. The data has been lost. This error may be caused by a failure of your computer hardware or network connection. Please try to save this file elsewhere.
Last modified: 2/23/2018 8:42:20 PM