VM-Centric Operations for Virtual Server Agent with vCloud Director (VSA V2)

The Virtual Server Agent (VSA) for vCloud Director supports VM-centric backup and restore operations using Indexing Version 2. (This feature is also called VSA V2 or VSA Indexing V2.)

This feature is supported for streaming backups of VMs running in vCloud Director, from the Command Center and the CommCell Console.

For a new Commvault deployment with Service Pack 16 or more recent service packs, Indexing Version 2 is enabled by default, and new virtualization clients automatically use Indexing Version 2 to support VM-centric operations.


  • Collecting file and folder information during backups is not supported with Indexing Version 2. Browse and restore operations use the live browse method to get file and folder information.

  • Guest file restores from tape backups are not supported with Indexing Version 2, because file details are not collected in backups and live browse operations are not supported from tape copies.

  • In 11.20 and later feature releases, current throughput will not be updated at the parent VSA job level. You should check the VM status to confirm current throughput for each job.

Key Features

  • VM clients:

    • Automatically create clients, backup sets, and subclients for each virtual machine during discovery. These entities are visible to end users as well as administrators.

    • Associate VM backup sets with the parent backup set.

    • Enable or disable activity (backup, restore, and data aging) for individual VMs.

    • Specify security settings for individual VMs. In the CommCell Browser, end users can see only clients for virtual machines for which they have appropriate ownership and permissions.

    • To delete the backup history for a VM, delete the VM client.

  • Backups:

    • Perform streaming backup operations.

    • A backup operation for a subclient automatically creates child jobs with unique IDs for each VM, and commits VM-specific backup data as each child job finishes.

    • Distribute VM backup jobs across the available VSA proxies and MediaAgents, with a separate stream for each job.

    • Index extents are backed up for each VM. Subclient indexes are archived after all VM backups finish.

    • Changed block tracking (CBT) information is included as part of the index metadata. Cyclic redundancy check (CRC) information is stored as part of the extent header for each extent, and changed extents are backed up.

    • Run synthetic full backup operations for individual VMs.

    • Perform multi-stream synthetic full backup operations.

    • For streaming backups, incremental backups are maintained when VMs are moved to a different subclient within the same backup set.

  • Job control:

    • Perform job control operations for each VM.

    • Set the job priority for each VM.

  • Restores:

    • Browse and restore VMs or files from the client or subclient for an individual VM, or from the backup set for a subclient.

    • For a restore job that includes multiple VMs, the restore operation can use up to 10 streams (one stream per VM).

    • Customized options for end user restores.

  • Other operations:

    • Customize retention and data aging for each VM.

    • Identify a subset of VMs for secondary copy operations.

    • Generate reports for specific VMs.