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
Restoring the full Hyper-V virtual machine
This topic pertains to NetBackup for Hyper-V.
You can restore the entire virtual machine to the original Hyper-V server or to a different Hyper-V server.
For important notes on restoring the full virtual machine, see the following:
See Notes on full virtual machine restore.
To restore the entire Hyper-V virtual machine
- Start the NetBackup web UI.
- On the left, click Recovery > Regular recovery and click Start recovery.
- On the Basic properties tab, select the following.
Policy type
Enter Hyper-V.
Restore type
Select Virtual machine backups.
Source client
Enter the Hyper-V virtual machine that was backed up.
Destination client
Enter a physical host or a virtual machine. The host or virtual machine must contain a NetBackup client.
You must use a different procedure to restore the files to a virtual machine that does not have a NetBackup client.
See Restoring individual Hyper-V files to a shared location on the virtual machine.
- Click Next.
- NetBackup automatically displays the most recent backups available. Or, you can select a date range or Use backup history.
- Select the backup of the virtual machine that you want to restore.
Click Next.
- Select the recovery options. See the table below for different options:
Hyper-V virtual machine GUID
Shows the Hyper-V hostname and GUID (Globally Unique Identifier) of the virtual machine that was backed up. Use this value to verify that this backup represents the virtual machine that you want to restore. The GUID is a unique string for a virtual machine in addition to the hostname.
Restore Options
Restore to Hyper-V server
Restores the virtual machine to its original location on the original Hyper-V server.
Restore to different locations on same / different Hyper-V server
Restores the virtual machine to a different location on the original Hyper-V server, or restores it to a different Hyper-V server.
Restore to staging location
Restores the virtual machine files to the staging location on the server that you specify under Hyper-V server and Restore everything to different directory. Use this option if:
You do not want to restore an entire virtual machine
You do not want NetBackup to start the virtual machine after the restore
For instance, you can use this option to add restored files as a .vhd volume to a virtual machine other than the one from which they were backed up.
Overwrite virtual machine
(If you selected Restore to staging location, this option is Overwrite existing files)
If you selected Restore to Hyper-V server or Restore to different locations on same / different Hyper-V server, note the following:
If a virtual machine with the same GUID exits on the destination server, that virtual machine is removed along with its configuration and snapshot files. Any existing .vhd files for the virtual machine on the destination server are overwritten. The virtual machine that you selected to restore is restored from the backup.
If the Overwrite virtual machine option is not selected and a virtual machine with the same GUID exists on the destination server: the restore fails with NetBackup status code 5.
If the Overwrite virtual machine option is not selected and .vhd file(s) for the virtual machine still exist on the destination: the .vhd file(s) from the backup are not restored.
If you selected Restore to staging location, note the following:
If the .vhd file you want to restore already exists on the destination server in the location specified for the restore, that file on the destination server is overwritten.
If the Overwrite existing files option is not selected and any file you want to restore already exists in the location specified for the restore, the file is not overwritten. Any other files that are selected for restore are restored. The restore is reported as a partial success.
Restore Destinations
Hyper-V server
If you selected Restore to Hyper-V server (to restore to the original location), note: the restore destination is the name of the Hyper-V server from which the virtual machine was backed up. In this case, the destination cannot be changed.
For the other restore options (restore to a different location, or restore to staging location), specify the destination Hyper-V server for the restore.
List of backed up files (Source)
Lists the Hyper-V virtual machine files as they existed when the virtual machine was backed up. By default, all listed files are selected for restore.
If you do not want the restore to replace certain files on the current virtual machine on the destination server, uncheck those files. Leave a check mark next to the files that you want to restore. The files that are not checked are not restored. Note that virtual machine configuration files (.xml, .vsv, and .bin files) and .avhd files are not de-selectable in restores other than staging restores.
Note:
Replacing common files with earlier versions can be problematic for the virtual machines that rely on the common files. If you do not want to overwrite the common files on the Hyper-V server, uncheck the common files that you do not want to restore.
Note the following about the listed files:
If you do not select any .vhd files, NetBackup tries to find them in their original location. If they are missing at the original location, the restore fails. If a parent .vhd file was in E:\myVhds\ on the original machine and is not selected during restore, NetBackup looks for the parent .vhd file in E:\myVhds\ on the target machine. If the file does not exist, the restore fails.
For Restore to Hyper-V server or Restore to different locations on same / different Hyper-V server, you can uncheck any .vhd files in this list. All other files are pre-checked and cannot be unchecked.
For Restore to staging location, you can uncheck any files in the list.
Configuration files (such as xml, bin, vsv, and snapshot files) are always restored when you restore the full virtual machine.
Restore everything to different directory
This field is disabled if you selected Restore to Hyper-V server.
For restore to a different location or to staging location, enter the path on the server or other machine that you specified under Hyper-V server or Staging machine name. NetBackup creates the appropriate subdirectories.
View Paths
Displays the directories on the destination server in which the Hyper-V files are to be restored. You must specify a destination path in the Restore everything to different directory field.
Override default job priority
Determines the restore job's priority for restore resources. A higher priority means that NetBackup assigns the first available drive to the first restore job with the highest priority. Enter a number (maximum 99999). The default for all restore jobs is 0, the lowest priority possible. Any restore job with a priority greater than zero has priority over the default setting.
- Click Next dialog.
- Review the details.
- Click Start Restore.
When the restore is complete, the restored virtual machine is placed in the Saved or Off state. The state after restore depends on its state at the time of the backup and the type of Hyper-V backup that occurred.