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
- Hyper-V backup options
- 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
- Configuration parameters for Hyper-V
- 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 restore of individual Hyper-V files
- Restoring individual Hyper-V files to a host that has a NetBackup client
- Restore Marked Files dialog for restore of individual Hyper-V files
- Restoring individual Hyper-V 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 Hyper-V files
- Problems with restore of the full Hyper-V 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
Notes on individual file restore
This topic pertains to NetBackup for Hyper-V.
Note the following:
If you are running antivirus protection on Hyper-V virtual machines, Veritas recommends Symantec Endpoint Protection 11.0 Maintenance Release 4 (build 11.0.4000) or later. Restores of virtual machine files complete faster if the virtual machine is running this version as opposed to an earlier version of Endpoint Protection.
Cross-platform restore of individual files is not supported. You can restore Windows files to Windows guest operating systems only, not to Linux. You can restore Linux files to Linux guest operating systems only, not to Windows.
To restore files to a shared location on the virtual machine, note: Virtual machines must be in the same domain as the NetBackup client and master and media server.
To restore an individual file that is larger than approximately 2 GB, restore the file to a host that has a NetBackup client. NetBackup for Hyper-V does not currently support restores of large files by means of a shared location on the virtual machine. This file size restriction does not apply to restore of an entire virtual machine.
See Restoring individual Hyper-V files to a host that has a NetBackup client.
From a backup image that was made with the option: If you select individual files to restore, the selected files must have originally resided on the same virtual machine volume. If some files resided on one volume and other files resided on a different volume, the restore fails.
To restore Windows encrypted files, the NetBackup Client Service must be logged on as Administrator on the target host for the restore. Under services on the control panel, change the logon for the NetBackup Client Services from Local System Account to Administrator.
Files that use NTFS-file system features cannot retain those features if you attempt to restore the files to a FAT or FAT32 file system.
Note the following:
Files that were compressed under NTFS are restored as uncompressed files in a FAT or FAT32 file system.
Files that were encrypted under NTFS cannot be restored to a FAT or FAT32 file system.
Files that had NTFS-based security attributes are restored without those attributes in a FAT or FAT32 file system.
The restore fails with NetBackup status 2817 when the files that have alternate data streams are restored to a FAT or FAT32 file system.
On a restore, NetBackup recreates the linking between a hard link and its original file only if the link file and its target file are restored in the same job. If each file is restored individually in separate restore jobs, they are restored as separate files and the link is not re-established.
On a Linux virtual machine, a backup that was made with the option may have file-mapping issues if the virtual machine experiences heavy I/O. (Windows Hyper-V provides no mechanism for quiescing file system activity on Linux virtual machines.)
For Linux virtual machines, only the ext2, ext3, and ext4 file systems are supported for individual file restore. If a partition uses some other file system, the backup succeeds but files in that partition cannot be individually restored. Note: The "/" (root) partition must be formatted with ext2, ext3, or ext4 so that NetBackup can present mount points in the Backup, Archive, and Restore interface.
The Linux ext4 file system includes a persistent pre-allocation feature, to guarantee disk space for files without padding the allocated space with zeros. When NetBackup restores a pre-allocated file (to any supported ext file system), the file loses its preallocation and is restored as a sparse file.
To migrate an ext2 or ext3 file system to ext4: See the instructions under Converting an ext3 file system to ext4 on the following page of the Ext4 wiki:
https://ext4.wiki.kernel.org/index.php/Ext4_Howto#Converting_an_ext3_filesystem_to_ext4
If you do not follow these instructions, data in a newly created ext4 file is not promptly flushed from memory to disk. As a result, NetBackup cannot back up the data of recently created files in the ext4 file system. (The NetBackup snapshot captures the file as zero length.) As a workaround for the file systems that were not correctly migrated, note: Run the Linux sync command on the ext4 file system before starting each backup.
NetBackup supports backup of Linux FIFO files and socket files. Note however that NetBackup does not support restoring FIFO files and socket files individually. FIFO files and socket files can be restored along with the rest of the virtual machine data when you recover the entire virtual machine.
For Linux virtual machines, NetBackup cannot restore individual files from software RAID volumes. The files are restored when you restore the entire virtual machine
NetBackup supports backup and restore of Linux LVM2 volumes, including individual file restore from an LVM2 volume. Note however that NetBackup does not support individual file restore from a snapshot that was created by means of the snapshot feature in LVM2. If an LVM2 snapshot exists at the time of the backup, the data in the snapshot is captured in the backup. The data can be restored along with the rest of the virtual machine data when you recover the entire virtual machine.
For VMs on a Windows 2012 R2 Hyper-V server, the BAR interface may list Hyper-V snapshot files when you browse to restore VM files. In some cases, the snapshot file data is not application consistent and the file should not be restored.
To identify the snapshot file and to decide whether to restore it:
See The BAR interface may list Hyper-V snapshot files when you browse to restore Hyper-V VM files.
For Linux, additional notes apply.
NetBackup for Hyper-V does not support individual file restore by means of ClientDirect Restore.