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
Creating a Hyper-V policy for automatic virtual machine selection
NetBackup can automatically select Hyper-V virtual machines for backup based on the criteria that you enter. You specify the criteria (rules) in the Query builder on the NetBackup policy Clients tab. You can set up rules to include certain virtual machines for backup, or to exclude virtual machines. The Query builder can operate in Basic node or in Advanced mode.
When the backup job runs, NetBackup creates a list of the virtual machines that currently meet the query rules and backs them up.
To configure automatic virtual machine selection in Basic mode
- Open the NetBackup web UI.
- On the left, select Protection > Policies.
- Select the Add button.
- On the Attributes tab, select Hyper-V for the policy type.
- Make other policy selections as needed (for example, create a Schedule).
- Select the Clients tab, and select the option Select automatically through Hyper-V Intelligent Policy query.
If you had used the Select manually option to select virtual machines, those virtual machines are removed from the policy.
- 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.
- For Server name, enter the name of the Hyper-V server, cluster, or SCVMM server.
Important: IPv6 addresses are not supported for Server Name. Use fully qualified domain names (FQDN) or host names instead.
Another topic describes the requirements for SCVMM:
See About backup of virtual machines in an SCVMM environment.
For a clustered environment, note the following:
Enter the name of the cluster (or one of the Hyper-V cluster nodes) in the Server Name field.
Set the NetBackup Legacy Network Service logon to the domain user account:
See Changing the NetBackup Legacy Network Service logon (vnetd.exe) to the domain user account.
The NetBackup primary server should not be installed on any Hyper-V nodes in the cluster. If the primary server resides on one of the nodes, you cannot log on to the NetBackup web UI.
- Select the Basic mode tab. To create a rule, make selections from the Query Builder fields.
For the first rule, you can start with the Field list, depending on the type of rule. For the first rule, the only selections available for the Join field are blank (none), or NOT.
Select a keyword for Field.
Select an Operator.
Indicate a Value.
You can enter the value manually (enclose the value in single quotes or double quotes).
As an alternative, you can click the folder icon to browse for values. Depending on the Field keyword, you can use the Value list to select the value.
Note that browsing with the folder icon may take some time in large environments.
See Query Builder field reference.
The arrow icon resets the Join, Field, Operator, and Value fields to blank.
- Select the Add button to add the rule to the Query pane.
- Create more rules as needed.
- To see which virtual machines NetBackup currently selects based on your query, click Test query.
The virtual machines in your current environment that match the rules for selection in the policy are labeled Included. Note however that the Test query option does not create the backup list for the policy. When the next backup runs from this policy, NetBackup rediscovers virtual machines and consults the query rules. At that time, NetBackup backs up the virtual machines that match the query rules.
The list of virtual machines is saved but the virtual machines are not displayed in the policy's Clients tab.