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
- 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)
- Configure an 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
- Edit or remove 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
- 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 Hyper-V files to a host that has a NetBackup client
- Restore options for restore of Hyper-V individual files (NetBackup web UI)
- Restoring individual Hyper-V files to a shared location on the virtual machine
- Restoring the full Hyper-V virtual machine
- Restore Options
- 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
- 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
- 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
- Notes on Hyper-V policy attributes when you use the NetBackup commands
- The bpplinfo options for 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
NetBackup for Hyper-V notes and restrictions
The following notes and restrictions apply to NetBackup for Hyper-V:
For VSS with disk arrays:
To use a hardware array snapshot, make sure that the hardware array's VSS provider supports the snapshots that involve the Hyper-V writer. Consult the release notes of the array vendor or VSS provider.
NetBackup for Hyper-V does not support the NetBackup Instant Recovery feature.
The following is due to a Microsoft limitation: NetBackup for Hyper-V does not support VSS or WMI backup or restore of the vhdx files that are shared among multiple VMs.
To perform Hyper-V backups with the SAN Client feature, install SAN Client on the Hyper-V server. Do not install SAN Client on the virtual machines. For more information on SAN Client with Hyper-V, see the NetBackup SAN Client and Fibre Transport Guide.
Note:
The SAN Client feature for Hyper-V is only supported for the VSS backup method (not for WMI).
The following is due to a Microsoft limitation: If the VM's virtual disk files reside in a volume or folder that is compressed, NetBackup cannot use the WMI backup method to create a snapshot of the VM. The snapshot job fails with status 156, "snapshot error encountered."
As a workaround, remove compression from the volume or folder where the virtual disk resides and rerun the backup.
NetBackup for Hyper-V supports Windows NTFS file encryption and compression, for backup and restore. However, it does not support NetBackup's compression or encryption options (in the NetBackup policy attributes).
For UNIX or Linux guest operating systems: NetBackup for Hyper-V does not support any type of compression or encryption, whether they are set in NetBackup or in the guest OS.
Note:
The compressed Windows NTFS files are backed up and restored as compressed files.
If a policy is changed from manual selection to Intelligent policy (or vice versa), note: The next backup of the VM is a regular full backup, even if a backup already exists for that VM.
For example:
In a new Hyper-V policy, the option on the Clients tab is used to select a VM. The first backup from the policy runs.
If the primary VM identifier is a host name, ensure that you configure Microsoft failover cluster with FQDN of VM getting protected.
In the policy, an Intelligent Policy query is used to select the same VM, and the VM is backed up a second time. Because of the switch from manual selection to query-based selection, this second backup is a regular full backup. Note that for a policy that uses (BLIB) or BLIB plus Accelerator, the backup processing is not limited to changed blocks only.
For the second backup, the Detailed status log includes a message similar to the following:
Sep 29, 2016 11:16:53 AM - Info bpbrm (pid=13680) There is no complete backup image match with track journal, a regular full backup will be performed.
The same backup behavior occurs if the policy's VM selection is switched from query-based to manual selection: The second backup is a regular full backup.
For the WMI backup method with the option (with or without Accelerator): If the VM has multiple virtual disks that have the same disk UUID, NetBackup performs a full backup of those disks. It does not perform an incremental backup of them. The disks that have unique IDs undergo an incremental backup, as expected. In the Activity Monitor, the job details include messages such as the following:
The virtual machine (Name: testVM, GUID: 98321741-A936-4128-8AB0-07099B23E25C) uses multiple disks with the same disk Id. Disk Id: 7198C033-AB5D-4585-905D-0DA68D26F9C5 Disk path: E:\VMs\testVM\testVM1.vhdx Disk Id: 7198C033-AB5D-4585-905D-0DA68D26F9C5 Disk path: E:\VMs\testVM\testVM2.vhdx You may lose optimization during the backups for the above listed disks.
To perform incremental backup of these virtual disks, assign a unique ID to each disk. For example, you can use the Set-VHD PowerShell cmdlet to reset the disk ID for testVM1 as follows:
Set-VHD -Path E:\VMs\testVM\testVM1.vhdx - ResetDiskIdentifier
In the case of the differencing disks, you must run additional commands to re-create the disk chain. For more details on the Set-VHD cmdlet, see the following Microsoft TechNet article:
Additional notes are available on Accelerator:
See Accelerator notes and requirements for virtual machines.
The following is due to a Microsoft limitation: NetBackup for Hyper-V does not support backup of encrypted vhd or vhdx files.
The following is due to a Microsoft limitation; this note applies to the VSS backup method only. For the virtual machines that have a FAT or FAT32 file system, NetBackup supports only Hyper-V offline backup.
The WMI backup method (for Hyper-V Server 2016 and later) does not employ online vs offline backups.
See WMI backup method: State of the virtual machine before and after restore.
For the VSS backup method: If a virtual machine is in the Paused state when the backup starts, the virtual machine is placed in the Saved state after the backup completes.
The WMI backup method supports the option (on the policy's Hyper-V tab under Advanced). The available settings are , , and .
For the WMI backup method, note the following:
If a virtual machine is in the Paused state during backup and is set to , the backup fails during snapshot creation. If is set to or , the backup succeeds. The virtual machine is in the Off state after the restore.
If a virtual machine is in the Saved state during backup and is set to , the backup fails during snapshot creation. If is set to or , the backup succeeds. The virtual machine is in the Saved state after the restore.
NetBackup for Hyper-V has certain character restrictions for virtual machine display names.
See NetBackup character restrictions for Hyper-V virtual machine display names.
NetBackup for Hyper-V does not support restores with the Fibre Transport data transfer method.
More information is available on the restore of Hyper-V virtual machines.
More information about NetBackup for Hyper-V support is available in the following documents:
The NetBackup Software Compatibility List:
Support for NetBackup in virtual environments: