Link Search Menu Expand Document

The Veeam Cookbook Series

A simple step by step no frills approach to achieving your goal

Recipe: Create a Hyper-V Backup Job with Guest Processing for Linux VMs

Expected deliverables:

A Veeam Backup Job to backup Hyper-V VMs data with Guest application-aware processing enabled.

Time to complete: 5 minutes


  • Hyper-V infrastructure must have been added to the backup infrastructure and properly configured. That means adding a source Hyper-V Cluster.
  • If you want to perform backup in the off-host backup mode, then at least one Off-host Backup Proxy for backup processing.
  • A Backup repository with enough capacity to keep backup files for the retention period. You can also consider the use of Scale-Out Backup Repository.
  • A user account with root privileges if Guest Processing will be enabled

Before you start:

The target Repository must have enough free space to store Backup files.


It’s assumed that you already have a Veeam Backup Server fully working in your environment. It’s assumed that you have supported Pre-freeze and Post-thaw scripts.


  1. Open the Veeam Backup & Replication Console.
  2. On the Home tab, click Backup Job > Virtual machine > Microsoft Hyper-V.
  3. At the Name step, specify a job name and description. Click Next.
  4. At the Virtual Machines step, select VMs and VM containers (Hyper-V hosts, clusters, SCVMM, SCVMM tags, SCVMM host groups, VM groups, or volumes) that you want to back up. Click Add, then in the Add Object window select the necessary VMs or VM containers and click Add. Click Next.
  5. At the Storage step, select backup infrastructure components for the job:
    • Click Choose next to the Backup proxy field to select whether you want to use On-host backup mode or Off-host backup mode, otherwise keep the default setting (Automatic proxy selection)
    • From the Backup repository list, select a backup repository where the created backup files must be stored. Make sure it has enough free space.
    • In the Retention Policy field, specify retention policy settings whether based in Days or Restore Points.
    • If you want to enable GFS for Long-Term retention, then select the Keep some periodic full backups longer for archival purposes check box and configure GFS options.
    • By default Backup mode is Incremental with weekly Synthetic full backup. If you want a different backup mode, click in Advanced Settings and use the desired settings.
  6. At the Guest Processing step, check Enable application-aware processing option:
    • From the Guest OS credentials list, select a user account that has enough permissions. If you have not set up credentials beforehand, click the Manage accounts link or click the Add button to add credentials.
    • Click Applications, select a VM for which you want to configure scripts and then click Edit.
    • Click the Scripts tab and select Require successful script execution.
    • In the Linux scripts section, specify paths to scripts for Linux VMs (Pre-freeze and Post-thaw scripts).
    • Click OK twice.
    • To check whether Veeam can connect to VMs using the specified guest OS credentials and can deploy the non-persistent runtime components on the guest OSes, click Test Now. Click Next.
  7. At the Schedule step, select to run the backup job manually or schedule the job to run on a regular basis. Click Apply.
  8. At the Summary step, review details of the backup job. If you want to start the job right after you close the wizard, select the Run the job when I click Finish check box, otherwise leave the check box unselected. Then click Finish to close the wizard

Links to Resources:

Back to top

Copyright © 2023 Solutions Architects, Veeam Software.