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
Increasing the WMI create disk time-out value
It can take a long time to create a large virtual disk of type fixed (as opposed to a dynamic virtual disk). If a Hyper-V VM with a large fixed disk was backed up with the WMI method and is then restored, note: The restore job may time out before the restored virtual disk is fully written. The restore job fails with status 2821 and the VM's data is not restored.
Note:
The default time-out period for Hyper-V disk creation is 24 hours.
Do the following to allow the restore job to complete.
To increase the WMI create disk time-out value
- Use the NetBackup nbsetconfig command as follows:
nbsetconfig -h host
Where host is the name of the NetBackup master server where the configuration is to be updated.
- At the nbsetconfig prompt, enter the following to allow more time for creation of the virtual disk.
This example sets the period to 48 hours:
HYPERV_WMI_CREATE_DISK_TIMEOUT = 48
The range for HYPERV_WMI_CREATE_DISK_TIMEOUT is 0 hours to 240 hours.
Note:
A value of 0 means the restore job never times out during virtual disk creation.
- To escape the command, enter the following:
On UNIX: ctl-D
On Windows: ctl-Z
More information on the nbsetconfig command is available in the NetBackup Commands Reference Guide.