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
- Backup options on the Hyper-V tab
- 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
- 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 restoring individual files
- Restoring individual files to a host that has a NetBackup client
- Restore Marked Files dialog for restore of individual files
- Restoring individual 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 files
- Problems with restore of the full 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
Creating a Hyper-V policy from the NetBackup Policies utility
Before you configure a policy, make sure that the Hyper-V server is online. NetBackup must be able to communicate with the Hyper-V server.
Use the following procedure to create a policy to back up the Hyper-V virtual machines that you select manually.
To create a policy that selects virtual machines automatically:
See Creating a Hyper-V policy for automatic virtual machine selection.
To create a Hyper-V policy through manual selection of virtual machines
- In the NetBackup Administration Console, click Policies and click Actions > New > Policy.
- Select Hyper-V as the policy type.
- Select a policy storage unit or storage unit group (or Any Available).
- In most cases, you can leave the Disable client-side deduplication option at the default (unchecked).
The Disable client-side deduplication option is described in the NetBackup Administrator's Guide, Volume I.
- Use the Schedules tab to define a schedule.
On the Schedules Attributes tab, you can select Full backup, Differential Incremental Backup, or Cumulative Incremental Backup.
For the VSS backup method on the Hyper-V tab, incremental backups require selection of the Enable file recovery from VM backup option.
- Use the Hyper-V tab to set Hyper-V options.
The following backup methods are available:
Hyper-V Host 2008 SP2 or later (VSS)
For Hyper-V hosts running Windows Server 2008 SP2 or later (including Windows Server 2016). Select this method for older Hyper-V hosts. This method does not support block-level incremental backups or Accelerator.
Hyper-V Host 2016 or later (WMI)
A new backup method in NetBackup 8.0 and later that enables the faster Hyper-V backup features. This method is for Hyper-V hosts running Windows Server 2016 Technical Preview 5 or later. The virtual machines must be at a VM configuration version later than 5.
Note:
This WMI method is recommended for Windows Server 2016 or later and is required for block-level incremental backups and Accelerator.
For the options on this dialog, further information is available:
See Backup options on the Hyper-V tab.
See Hyper-V - Advanced Attributes.
The available options depend on the backup method that is selected, as follows.
Hyper-V Host 2008 SP2 or later (VSS):
Hyper-V Host 2016 or later (WMI):
- Click the Clients tab.
- On the Clients tab: select the Server Type.
This option designates the type of environment in which NetBackup searches for the VMs to back up.
Hyper-V Standalone/Cluster
A standalone Hyper-V server or cluster.
System Center Virtual Machine Manager
An SCVMM server that manages Hyper-V servers or clusters.
This procedure uses the Hyper-V Standalone/Cluster option only. For assistance with the System Center Virtual Machine Manager option:
See About backup of virtual machines in an SCVMM environment.
See Creating a Hyper-V policy for automatic virtual machine selection.
- On the Clients tab: For Server Name, enter the name of the Hyper-V server or cluster. This host must contain a NetBackup client to perform backups of the virtual machines.
Important: IPv6 addresses are not supported for Server Name. Use fully qualified domain names (FQDN) or host names instead.
On the Clients tab: Select the virtual machines to back up.
To manually select the virtual machines to back up, click Select manually then click New....
To set up the rules that select virtual machines automatically, click the Select automatically through Hyper-V Intelligent Policy query option. This option is required for VMs that an SCVMM server manages.
Automatic selection of virtual machines is explained in different topics:
See About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup).
See Options for selecting Hyper-V virtual machines.
See About backup of virtual machines in an SCVMM environment.
- The virtual machines you selected appear in the Clients tab.
For manual selection of virtual machines: In the Browse for Virtual Machines dialog, do the following:
Under Enter the VM display name, type the name of the virtual machine to back up.
Or, click Browse for Virtual Machines, and click the appropriate check boxes to select the virtual machines to back up.
If NetBackup cannot obtain the IP address of the virtual machine, the IP address is displayed as NONE.
More information is available on these fields:
Click OK.
Note:
The Backup Selections tab is set to ALL_LOCAL_DRIVES. Individual drives cannot be specified.
- Click OK to save the policy.
A validation process examines the policy and reports any errors. If you click Cancel, no validation is performed.