Guest Processing

If you back up or replicate running VMs, you can enable guest processing options. Guest processing options are advanced tasks that help Veeam Backup & Replication to communicate with the VM guest OS. Using guest processing options, Veeam Backup & Replication creates transactionally consistent backups, replicas, and catalogs of files and folders on the VM guest OS.

To coordinate guest processing activities, Veeam Backup & Replication deploys non-persistent runtime components or uses (if necessary, deploys) persistent agent components on the VM guest OS. For more information, see the Non-Persistent Runtime Components and Persistent Agent Components section. The non-persistent runtime components run only during guest processing and are stopped immediately after the processing is finished (depending on the selected option, during the backup job session or after the backup job finishes).

Veeam Backup & Replication offers the following guest processing options:

Application-Aware Processing

By default, Veeam Backup & Replication does not process application logs and creates a crash-consistent backup of VMs with applications that use transaction logs for operations. You can create a transactionally consistent backup - in this case Veeam Backup & Replication will process application logs. In case a disaster strikes, Veeam Backup & Replication will use backups of logs to perform recovery operations. You can create transactionally consistent backups and replicas of VMs that run Microsoft Active Directory, Microsoft Exchange, Microsoft SharePoint, Microsoft SQL Server, Oracle Database or PostgreSQL instances. Transactionally consistent backups guarantee proper recovery of these applications without data loss. For information on supported applications, see Supported Platforms and Applications.

When you define the job settings, you can set up the following application-aware processing settings:

Transaction log backup for Microsoft SQL Server Log Backup, Oracle Log Backup and PostgreSQL WAL Files Backup — to back up transaction logs from Microsoft SQL Server, Oracle server and PostgreSQL server.

Transaction log truncation — to truncate transaction logs on the VM guest OS after the VM is successfully processed.
Pre-freeze and post-thaw scripts — to run pre-freeze and post-thaw scripts to quiesce VMs running applications that do not support Microsoft VSS.
VM guest OS files exclusion — to exclude or include individual files and folders from or to backup or replica.

VM Guest File System Indexing

You can set up the backup job to create a catalog of files and folders on the VM guest OS. The catalog lets you search for VM guest OS files and perform 1-click restore in Veeam Backup Enterprise Manager.

If you do not enable this option in the backup job settings, you will still be able to perform 1-click restore from backups created by the backup job. For more information, see the Preparing for File Browsing and Searching section in the Enterprise Manager User Guide.

Note

If you use Kerberos authentication, consider requirements and limitations described in section Kerberos Authentication.

Requirements and Limitations

Consider the following requirements and limitations for guest processing:

Check that accounts that you plan to use for guest processing have permissions described in section Permissions.

Veeam Backup & Replication excludes from application-aware processing Microsoft SQL databases that are mounted to the Microsoft SQL Server using a remote UNC path. If at least one file of the database is located on a network shared folder, this database will be backed up in the crash-consistent state. Other databases on this server will be backed up in the transactionally consistent state. For more information, see this Veeam KB article.
Veeam Backup & Replication excludes the master database from guest processing and does not process transaction logs for it.

If you want to exclude other databases from the transaction log processing workflow, see this Veeam KB article. Consider that exclusion configured this way will be treated as a global setting.

Transaction log backups cannot be copied to capacity tier.

[For Oracle databases except Oracle RAC] Check that databases that you want to back up are listed in the /etc/oratab file.
[For Oracle databases on Microsoft Windows VMs] Make sure that the PATH system variable on the machine with your Oracle database includes the path to the Oracle database software (%ORACLE_HOME%\bin). For example, C:\app\Administrator\product\19.0.0\client_1\bin or d:\oracle[...]\bin.

To back up Microsoft SQL transaction logs with Veeam Backup & Replication, you must make sure that the recovery model is set to Full or Bulk-logged recovery model for required databases on Microsoft SQL Server VMs. If the recovery model is set to Simple, Veeam Backup & Replication will not detect and process transaction logs on Microsoft SQL Server VMs.

To back up Oracle transaction logs with Veeam Backup & Replication, you must make sure that ARCHIVELOG is turned on for required databases on Oracle VMs. If ARCHIVELOG is turned off, Veeam Backup & Replication will not detect and process transaction logs on Oracle VMs.

Due to Microsoft limitations, you cannot use Microsoft Entra ID (formerly Azure Active Directory) credentials to perform guest processing on VMs running Microsoft Windows 10 (or later).
Veeam Backup & Replication supports backup of Microsoft Exchange, SharePoint and SQL Server databases existing in mount point volumes.