Veritas NetBackup™ for Hyper-V Administrator's Guide
- Introduction
- Notes and prerequisites
- NetBackup for Hyper-V prerequisites
- NetBackup for Hyper-V notes and restrictions
- NetBackup character restrictions for Hyper-V virtual machine display names
- NetBackup character restrictions for vhd or vhdx names and the VM path when the Enable file recovery from VM backup option is used
- Notes on Linux virtual machines
- Configure NetBackup communication with Hyper-V
- Configure NetBackup policies for Hyper-V
- Creating a Hyper-V policy from the Policy Configuration Wizard
- Creating a Hyper-V policy from the NetBackup Policies utility
- Limit jobs per policy on the Attributes tab (for Hyper-V)
- Virtual machine host names and display names should be unique if VMs are selected manually in the policy
- Hyper-V backup options
- Hyper-V - Advanced Attributes
- Provider Type configuration parameter (VSS)
- Snapshot Attribute configuration parameter (VSS)
- Virtual disk selection parameter (WMI)
- Existing snapshot handling parameter (WMI)
- Consistency level parameter (WMI)
- About the exclude disk options for virtual disk selection
- Virtual disk selection options: an example to avoid
- Restoring data from the backups that excluded the boot disk or data disks
- Configuration parameters for Hyper-V
- Browse for Hyper-V virtual machines
- Prerequisites for alternate client backup of a virtual machine (VSS)
- Configuring alternate client backup of virtual machines
- Requirements for a NetBackup client inside the virtual machine
- Configure Hyper-V Intelligent Policies
- About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup)
- The basics of a NetBackup query rule
- Important notes on Hyper-V Intelligent Policy
- NetBackup requirements for Hyper-V Intelligent Policy
- Setting up Hyper-V Intelligent Policy: Task overview
- Options for selecting Hyper-V virtual machines
- Creating a Hyper-V policy for automatic virtual machine selection
- Editing a query in Basic Mode
- Using the Query Builder in Advanced Mode
- AND vs. OR in queries
- Examples for the NetBackup Query Builder
- The IsSet operator in queries
- About selecting virtual machines by means of multiple policies
- Order of operations in queries (precedence rules)
- Parentheses in compound queries
- Query rules for virtual machine Notes that contain a newline character
- Query Builder field reference
- Test Query screen for Hyper-V
- Test Query: Failed virtual machines
- Effect of Primary VM identifier parameter on Selection column in Test Query results
- Effect of Primary VM identifier parameter on VM Name column in Test query results
- Restoring a VM that was backed up with a Hyper-V Intelligent Policy and that has a pass-through disk
- NetBackup Hyper-V for SCVMM
- Windows Server failover cluster support
- About virtual machines on Windows 2008, 2012, and 2016 failover clusters
- Notes on CSV backup and restore
- Creating a policy for virtual machines in a cluster
- Location of the restored virtual machine in a cluster
- Virtual machine maintenance after a restore
- Hyper-V restore may fail if the VM was created on a CSV and the CSV is a reparse point on the destination drive
- Back up and restore Hyper-V
- Backing up Hyper-V virtual machines
- WMI backup method: State of the virtual machine before and after restore
- Notes on individual file restore
- Notes on full virtual machine restore
- About restore of individual Hyper-V files
- Restoring individual Hyper-V files to a host that has a NetBackup client
- Restore Marked Files dialog for restore of individual Hyper-V files
- Restoring individual Hyper-V files to a shared location on the virtual machine
- Restoring the full Hyper-V virtual machine
- Restore Marked Files dialog for restore of the Hyper-V virtual machine
- About restoring common files
- The BAR interface may list Hyper-V snapshot files when you browse to restore Hyper-V VM files
- Use Accelerator to back up Hyper-V
- About the NetBackup Accelerator for virtual machines
- Accelerator: full vs. incremental schedules
- How the NetBackup Accelerator works with virtual machines
- Accelerator notes and requirements for virtual machines
- Accelerator forced rescan for virtual machines (schedule attribute)
- Accelerator requires the OptimizedImage attribute
- Accelerator backups and the NetBackup catalog
- Accelerator messages in the backup job details log
- NetBackup logs for Accelerator with virtual machines
- About reporting the amount of Accelerator backup data that was transferred over the network
- Replacing the Accelerator image size with the network-transferred data in NetBackup command output
- Best practices and more information
- Troubleshooting
- NetBackup logs for Hyper-V and how to create them
- Errors during policy creation
- NetBackup status codes related to Hyper-V
- Backup job hangs for multiple virtual machines
- Viewing or resizing Windows NTFS shadow storage
- The Hyper-V integration component is not installed
- LDM volumes and status code 1
- Hyper-V snapshots (avhd or avhdx files) and status code 1
- Unable to log in to the NetBackup Administration Console
- When backing up the virtual machines that reside on the same CSV, Windows warning 1584 can be ignored
- Problems with alternate client backup
- Restored virtual machine fails to start
- Problem with a restart of a restored virtual machine: Why did the computer shut down unexpectedly?
- Problems with restore of individual Hyper-V files
- Problems with restore of the full Hyper-V virtual machine
- Unable to change virtual disk settings for a VM after restore if the VM had user checkpoints during a backup that used the WMI method
- Increasing the WMI create disk time-out value
- Linux VMs and persistent device naming
- Appendix A. VSS backup method: Hyper-V online and offline backups
- Appendix B. Hyper-V pass-through disks
- About Hyper-V pass-through disks with NetBackup
- Configurations for backing up pass-through disks
- Requirements for backing up Hyper-V pass-through disks
- Restrictions for Hyper-V pass-through disks
- Configuring a local snapshot backup of Hyper-V pass-through disks
- About alternate client backup of pass-through disks
- Configuring an alternate client backup of Hyper-V pass-through disks
- Important note on VSS and disk arrays
- Appendix C. NetBackup commands to back up and restore Hyper-V virtual machines
- Using NetBackup commands to create a Hyper-V policy
- Using NetBackup commands to create a Hyper-V Intelligent Policy
- The bpplinfo options for Hyper-V policies
- bpplinclude options for modifying query rules in Hyper-V policies
- Examples of nbrestorevm for restoring VMs to Hyper-V
- The nbrestorevm -R rename file for Hyper-V
- Notes on troubleshooting the nbrestorevm command for Hyper-V
- Logs for troubleshooting the nbrestorevm command
Setting global limits on the use of Hyper-V resources
You can use the NetBackup Resource Limit dialog to control the number of simultaneous backups that can be performed on a Hyper-V resource type. The settings apply to all NetBackup policies for the master server.
For example, to avoid overloading the Hyper-V server, you can place a limit on the number of concurrent snapshots per server.
Note:
The Resource Limit screen applies only to policies that use automatic selection of virtual machines (Query Builder). If virtual machines are selected manually on the Browse for Virtual Machines screen, the Resource Limit settings have no effect.
Note:
To limit the number of simultaneous jobs per policy, use the setting on the policy Attributes tab. The effect of this option depends on how the policy selects virtual machines.
See Limit jobs per policy on the Attributes tab (for Hyper-V).
Table: Hyper-V resource types and limits
Resource type | Backup method | Resource limit |
|---|---|---|
Active Snapshots Per Server | VSS | Controls the maximum number of active backup jobs per Hyper-V server. Applies to a standalone Hyper-V server as well as to every Hyper-V server in a cluster. The typical setting for this resource type is 2. See the following examples. Example 1:
The NetBackup Activity Monitor shows 32 snapshot jobs. 12 snapshot jobs and their backup jobs are active. 20 snapshot jobs are queued. As active backup jobs are completed, queued snapshot jobs become active. Example 2:
The NetBackup Activity Monitor shows 64 snapshot jobs. 12 snapshot jobs for VMs on Node1 are active and another 12 snapshot jobs for VMs on Node2 are active. 40 snapshot jobs are queued. As active backup jobs are completed, queued snapshot jobs become active. |
Active Snapshots Per Cluster | VSS | Controls the maximum number of active backup jobs per Hyper-V cluster. The typical setting for this resource type is 4. Example 1:
The NetBackup Activity Monitor shows 60 snapshot jobs. For the VMs in the cluster, 20 snapshot jobs are active. 40 snapshot jobs are queued. As active backup jobs are completed, queued jobs become active. Example 2:
The NetBackup Activity Monitor shows 60 snapshot jobs. 10 snapshot jobs for the VMs in Node1 and Node2 are active. 50 snapshot jobs are queued. Even though the setting is higher, the setting controls the number of active jobs. |
Snapshot Operations Per Server | VSS | Controls the maximum number of simultaneous VSS operations such as create snapshot and delete snapshot on a Hyper-V server or a Hyper-V server in a cluster. Applies only during the snapshot creation and snapshot deletion phase of a backup. Does not control the number of simultaneous backup jobs. The typical setting for this resource type is 1. Each VM backup consists of a snapshot job and a subsequent backup job. Note: Snapshot Operations Per Server controls VSS snapshot creation and deletion, which are part of the snapshot job. When snapshot creation is completed, the backup job starts. When the backup job is active, the snapshot job is still shown as active even though the snapshot creation is completed. Therefore, this resource does not control the number of active backup jobs. See the following examples. Example 1:
The NetBackup Activity Monitor shows 32 snapshot jobs. 2 snapshot jobs are active and 30 snapshot jobs are queued. When the first snapshot job completes the snapshot creation, its backup job starts and the third snapshot job becomes active. When the second snapshot job completes snapshot creation, its backup job starts and the fourth snapshot job becomes active. When all the snapshots are created, there are 32 active backup jobs. Example 2:
The NetBackup Activity Monitor shows 32 snapshot jobs. 2 snapshot jobs are active and 30 snapshot jobs are queued. When the first snapshot job completes snapshot creation, its backup job starts and the third snapshot job becomes active. When the second snapshot job completes snapshot creation, its backup job starts and the fourth snapshot job becomes active. This process continues until there are 10 active snapshot jobs and their backup jobs. When the first backup job completes, the eleventh snapshot job becomes active, and so forth. |
Snapshot Operations Per Cluster | VSS | Controls the maximum number of simultaneous VSS operations such as create snapshot and delete snapshot within a cluster. Applies only during the snapshot creation and snapshot deletion phase of a backup. Does not control the number of simultaneous backup jobs. For example:
The NetBackup Activity Monitor shows 60 snapshot jobs. 5 snapshot jobs are active and 55 snapshot jobs are queued. When the first snapshot job completes snapshot creation, the corresponding backup job starts and the sixth snapshot job becomes active. When the second snapshot job completes snapshot creation, its backup job starts and the seventh snapshot job becomes active, and so forth. When 12 backup jobs are active, the thirteenth and following backup jobs are queued because is set to 12. |
Active Backups Per Hyper-V Server | WMI | Controls the maximum number of active backup jobs per Hyper-V server. Applies to a standalone Hyper-V server as well as to every Hyper-V server in a cluster. The typical setting for this resource type is 2. Example 1:
The NetBackup Activity Monitor shows 32 snapshot jobs. 12 snapshot jobs and their backup jobs are active. 20 snapshot jobs are queued. As active backup jobs are completed, queued snapshot jobs become active. Example 2:
The NetBackup Activity Monitor shows 40 snapshot jobs. 10 snapshot jobs for VMs on Node1 are active and 12 snapshot jobs for VMs on Node2 are active. 18 snapshot jobs are queued for the VMs on Node2. |
Active Backups Per Hyper-V Cluster | WMI | Controls the maximum number of active backup jobs per Hyper-V cluster. The typical setting for this resource type is 6. Example 1:
The NetBackup Activity Monitor shows 60 snapshot jobs. 20 snapshot jobs for VMs on the cluster are active. 40 snapshot jobs are queued. As active backup jobs are completed, queued snapshot jobs become active. Example 2:
The NetBackup Activity Monitor shows 60 snapshot jobs. 10 snapshot jobs for VMs on Node1 and Node2 are active. 50 snapshot jobs are queued. Even though the setting is higher, the setting controls the number of active jobs. |
To set limits on the use of Hyper-V resources
- In the NetBackup Administration Console, click Host Properties > Master Servers and double-click the NetBackup master server.
- Under Properties, click Resource Limit.
- Click Hyper-V.
- Click in the Resource Limit column to change the limit for a resource. The settings apply to all policies for the master server.
For each resource type, the default is 0, No limit.
Table: Hyper-V resource types and limits describes the limits.
More Information
Creating a Hyper-V policy from the NetBackup Policies utility