Performing an Application-Based Backup

Perform a backup from the subclient for the VM that hosts an application.


Perform full or incremental backups for VM groups (subclients) that are configured for application-based backups. Synthetic full backups are not supported. Scheduled synthetic full backups are converted automatically to full backups for VM groups and subclients that are configured for application-based backups.

An application-based backup includes two main operations:

  • The virtual machine is backed up.

  • The application is discovered and the in-guest agent is automatically installed via a push operation.

Before You Begin

  • Review the Requirements for Application-Based Backups.

  • The VSA subclient must be configured for application-based backup, and must specify a storage policy that has a Snap copy defined.

  • In a firewalled environment with restricted network settings or where WMI ports are not open, see Remote Installation Requirements for Application-Based Backups to enable remote installations during application-based backups.

  • To perform an integrity check for Microsoft Exchange databases during an application-based backup, create the dwVSAExchangeIntegrityCheck additional setting on the Commvault client for the virtual machine that is running Exchange and set the value to 1. This option applies only when running an IntelliSnap backup from a VSA subclient. Ensure that the VSA proxy used for the backup has Exchange management tools installed.


Do not filter virtual machine disks. If a virtual machine disk is filtered, the VSA backup job completes with errors and the application backup job fails. You will not be able to restore application data.


  • If remote installation fails for any virtual machines during the initial backup, the VSA backup job status shows as "Completed with errors." For any virtual machines that already had an application agent installed, application-based backups and restores can still be performed.

  • If the first application-based backup installs a plug-in for Oracle for Windows, the backup fails. Restart Oracle services on the virtual machine where Oracle is running after the application-based workflow completes and then retry the backup.

  • After a SharePoint plug-in is installed as part of an application-based backup, set SharePoint Timer service account information in the SharePoint server properties.

Performing the Backup

Perform the backup from the Virtual Server Agent subclient that has been configured for application-based backups using the standard backup procedure for streaming or IntelliSnap backups.

Backups use the default proxy for the instance or subclient. Streaming backups can take advantage of multiple proxies for load balancing or failover. All proxies that are available for the operation must meet the requirements for application-based backups.

During the backup, you can see the following jobs for the application-based backups from the Job Controller or Backup History:

  • A job for the Virtual Server backup.

  • A job for VSAAppAwareBackupWorkflow.

If you display the Virtual Machine Status tab in Job Details, you can check the App Based Status value to verify whether applications were successfully backed up as part of the application-based backup.


Application-based backup jobs run according to the Plan schedules.

To restore application databases, see Restore Operations for a SQL Database.