Veritas NetBackup™ for Hyper-V Administrator's Guide

Last Published:
Product(s): NetBackup (9.1)
  1. Introduction
    1.  
      About Hyper-V
    2.  
      NetBackup for Hyper-V environment
    3.  
      Hyper-V terminology related to backup
    4.  
      Basic phases in a NetBackup backup of a Hyper-V virtual machine
    5.  
      NetBackup administrator tasks for Hyper-V
    6.  
      Quick reference for troubleshooting
  2. Notes and prerequisites
    1.  
      NetBackup for Hyper-V prerequisites
    2.  
      NetBackup for Hyper-V notes and restrictions
    3.  
      NetBackup character restrictions for Hyper-V virtual machine display names
    4.  
      NetBackup character restrictions for vhd or vhdx names and the VM path when the Enable file recovery from VM backup option is used
    5.  
      Notes on Linux virtual machines
  3. Configure NetBackup communication with Hyper-V
    1.  
      Changing the NetBackup Legacy Network Service logon (vnetd.exe) to the domain user account
    2.  
      Setting global limits on the use of Hyper-V resources
  4. Configure NetBackup policies for Hyper-V
    1.  
      Creating a Hyper-V policy from the Policy Configuration Wizard
    2.  
      Creating a Hyper-V policy from the NetBackup Policies utility
    3.  
      Limit jobs per policy on the Attributes tab (for Hyper-V)
    4.  
      Virtual machine host names and display names should be unique if VMs are selected manually in the policy
    5. Backup options on the Hyper-V tab
      1.  
        Optimization options (Hyper-V)
      2.  
        Primary VM identifier option (Hyper-V)
      3.  
        Enable offline backup of non-VSS VMs (Hyper-V with VSS)
      4.  
        Cluster shared volumes timeout (Hyper-V with VSS)
    6. Hyper-V - Advanced Attributes
      1.  
        Provider Type configuration parameter (VSS)
      2.  
        Snapshot Attribute configuration parameter (VSS)
      3.  
        Virtual disk selection parameter (WMI)
      4.  
        Existing snapshot handling parameter (WMI)
      5.  
        Consistency level parameter (WMI)
      6.  
        About the exclude disk options for virtual disk selection
      7.  
        Virtual disk selection options: an example to avoid
      8.  
        Restoring data from the backups that excluded the boot disk or data disks
    7. Browse for Hyper-V virtual machines
      1.  
        About cached names for virtual machine backup
    8.  
      Prerequisites for alternate client backup of a virtual machine (VSS)
    9.  
      Configuring alternate client backup of virtual machines
    10.  
      Requirements for a NetBackup client inside the virtual machine
  5. Configure Hyper-V Intelligent Policies
    1.  
      About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup)
    2.  
      The basics of a NetBackup query rule
    3.  
      Important notes on Hyper-V Intelligent Policy
    4.  
      NetBackup requirements for Hyper-V Intelligent Policy
    5.  
      Setting up Hyper-V Intelligent Policy: Task overview
    6.  
      Options for selecting Hyper-V virtual machines
    7.  
      Creating a Hyper-V policy for automatic virtual machine selection
    8.  
      Editing a query in Basic Mode
    9.  
      Using the Query Builder in Advanced Mode
    10.  
      AND vs. OR in queries
    11.  
      Examples for the NetBackup Query Builder
    12.  
      The IsSet operator in queries
    13.  
      About selecting virtual machines by means of multiple policies
    14.  
      Order of operations in queries (precedence rules)
    15.  
      Parentheses in compound queries
    16.  
      Query rules for virtual machine Notes that contain a newline character
    17.  
      Query Builder field reference
    18.  
      Test Query screen for Hyper-V
    19.  
      Test Query: Failed virtual machines
    20.  
      Effect of Primary VM identifier parameter on Selection column in Test Query results
    21.  
      Effect of Primary VM identifier parameter on VM Name column in Test query results
    22.  
      Restoring a VM that was backed up with a Hyper-V Intelligent Policy and that has a pass-through disk
  6. NetBackup Hyper-V for SCVMM
    1.  
      About backup of virtual machines in an SCVMM environment
    2.  
      Notes on NetBackup for Hyper-V with SCVMM
    3.  
      Creating a query to back up VMs in a localized SCVMM environment
  7. Windows Server failover cluster support
    1.  
      About virtual machines on Windows 2012 and 2016 failover clusters
    2.  
      Notes on CSV backup and restore
    3.  
      Creating a policy for virtual machines in a cluster
    4.  
      Location of the restored virtual machine in a cluster
    5. Virtual machine maintenance after a restore
      1.  
        Removal of cluster resources during restore
  8. Back up and restore Hyper-V
    1.  
      Backing up Hyper-V virtual machines
    2.  
      WMI backup method: State of the virtual machine before and after restore
    3.  
      Notes on individual file restore
    4.  
      Notes on full virtual machine restore
    5.  
      About restoring individual files
    6.  
      Restoring individual files to a host that has a NetBackup client
    7.  
      Restore Marked Files dialog for restore of individual files
    8. Restoring individual files to a shared location on the virtual machine
      1.  
        Setting up NetBackup Client Service for restore to a shared location on the virtual machine
    9.  
      Restoring the full Hyper-V virtual machine
    10.  
      Restore Marked Files dialog for restore of the Hyper-V virtual machine
    11.  
      About restoring common files
    12.  
      The BAR interface may list Hyper-V snapshot files when you browse to restore Hyper-V VM files
  9. Use Accelerator to back up Hyper-V
    1.  
      About the NetBackup Accelerator for virtual machines
    2.  
      Accelerator: full vs. incremental schedules
    3.  
      How the NetBackup Accelerator works with virtual machines
    4.  
      Accelerator notes and requirements for virtual machines
    5.  
      Accelerator forced rescan for virtual machines (schedule attribute)
    6.  
      Accelerator requires the OptimizedImage attribute
    7.  
      Accelerator backups and the NetBackup catalog
    8.  
      Accelerator messages in the backup job details log
    9.  
      NetBackup logs for Accelerator with virtual machines
    10.  
      About reporting the amount of Accelerator backup data that was transferred over the network
    11.  
      Replacing the Accelerator image size with the network-transferred data in NetBackup command output
  10. Best practices and more information
    1.  
      Best practices
  11. Troubleshooting
    1. NetBackup logs for Hyper-V and how to create them
      1.  
        Enabling VxFI logging
      2.  
        Configuring VxMS and vhd logging
      3.  
        Format of the VxMS core.log and provider.log file names
    2. Errors during policy creation
      1.  
        NetBackup policy validation failed
    3. NetBackup status codes related to Hyper-V
      1.  
        Snapshot error encountered (status code 156)
    4.  
      Backup job hangs for multiple virtual machines
    5.  
      Viewing or resizing Windows NTFS shadow storage
    6.  
      The Hyper-V integration component is not installed
    7.  
      LDM volumes and status code 1
    8.  
      Hyper-V snapshots (avhd or avhdx files) and status code 1
    9.  
      Unable to log in to the NetBackup Administration Console
    10.  
      When backing up the virtual machines that reside on the same CSV, Windows warning 1584 can be ignored
    11.  
      Problems with alternate client backup
    12.  
      Restored virtual machine fails to start
    13.  
      Problem with a restart of a restored virtual machine: Why did the computer shut down unexpectedly?
    14.  
      Problems with restore of individual files
    15.  
      Problems with restore of the full virtual machine
    16.  
      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
    17.  
      Increasing the WMI create disk time-out value
    18.  
      Linux VMs and persistent device naming
  12. Appendix A. VSS backup method: Hyper-V online and offline backups
    1.  
      About Hyper-V online and offline backups for VSS
    2.  
      Conditions that determine online vs. offline backup for VSS
    3.  
      Additional notes on offline backups with VSS
    4.  
      Hyper-V 2012 R2 virtual machines may be in the Off state when restored
  13. Appendix B. Hyper-V pass-through disks
    1.  
      About Hyper-V pass-through disks with NetBackup
    2.  
      Configurations for backing up pass-through disks
    3.  
      Requirements for backing up Hyper-V pass-through disks
    4.  
      Restrictions for Hyper-V pass-through disks
    5.  
      Configuring a local snapshot backup of Hyper-V pass-through disks
    6.  
      About alternate client backup of pass-through disks
    7.  
      Configuring an alternate client backup of Hyper-V pass-through disks
    8.  
      Important note on VSS and disk arrays
  14. Appendix C. NetBackup commands to back up and restore Hyper-V virtual machines
    1.  
      Using NetBackup commands to create a Hyper-V policy
    2.  
      Using NetBackup commands to create a Hyper-V Intelligent Policy
    3.  
      The bpplinfo options for Hyper-V policies
    4.  
      bpplinclude options for modifying query rules in Hyper-V policies
    5. Examples of nbrestorevm for restoring VMs to Hyper-V
      1.  
        Hyper-V examples of restore to original location
      2.  
        Hyper-V examples of restore to alternate locations
    6.  
      The nbrestorevm -R rename file for Hyper-V
    7.  
      Notes on troubleshooting the nbrestorevm command for Hyper-V
    8.  
      Logs for troubleshooting the nbrestorevm command
  15.  
    Index

A

Accelerator, About the NetBackup Accelerator for virtual machines
and the NetBackup catalog, Accelerator backups and the NetBackup catalog
and the WMI backup method, How the NetBackup Accelerator works with virtual machines
logs for, NetBackup logs for Accelerator with virtual machines
messages in the backup job details log, Accelerator messages in the backup job details log
replacing image size with network-transferred data in command output, Replacing the Accelerator image size with the network-transferred data in NetBackup command output
reporting network-transferred data in command output, About reporting the amount of Accelerator backup data that was transferred over the network
Accelerator, policy option, Optimization options (Hyper-V)
administrator tasks
NetBackup, NetBackup administrator tasks for Hyper-V
Advanced Mode
Query Builder, Using the Query Builder in Advanced Mode
alternate client backup
issues, Problems with alternate client backup
of pass-through disks, About alternate client backup of pass-through disks
of virtual machines
prerequisites, Prerequisites for alternate client backup of a virtual machine (VSS)
alternate client backup of pass-through disks
configuring, Configuring an alternate client backup of Hyper-V pass-through disks
alternate client backup of virtual machines
configuring, Configuring alternate client backup of virtual machines
AND vs OR, Order of operations in queries (precedence rules)
Join field in Query Builder, AND vs. OR in queries
Application Consistent, Consistency level parameter (WMI)
automatic selection of virtual machines
about, About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup)
Advanced Mode, Using the Query Builder in Advanced Mode
Basic Mode, Creating a Hyper-V policy for automatic virtual machine selection
Clients tab, Options for selecting Hyper-V virtual machines
examples, About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup), Examples for the NetBackup Query Builder
for VMs in SCVMM, About backup of virtual machines in an SCVMM environment
notes on, Important notes on Hyper-V Intelligent Policy
Query Builder fields, Query Builder field reference
requirements, NetBackup requirements for Hyper-V Intelligent Policy
task overview, Setting up Hyper-V Intelligent Policy: Task overview
testing, Test Query screen for Hyper-V
with multiple policies, About selecting virtual machines by means of multiple policies

B

backing up pass-through disks
configurations, Configurations for backing up pass-through disks
requirements, Requirements for backing up Hyper-V pass-through disks
restrictions, Restrictions for Hyper-V pass-through disks
backup
Hyper-V virtual machines, Backing up Hyper-V virtual machines
backup and restore
Cluster Shared Volumes (CSV), Notes on CSV backup and restore
backup job hangs
for multiple virtual machines, Backup job hangs for multiple virtual machines
backups
Hyper-V online and offline, About Hyper-V online and offline backups for VSS
replacing Accelerator image size with network-transferred data in command output, Replacing the Accelerator image size with the network-transferred data in NetBackup command output
reporting network-transferred data for Accelerator, About reporting the amount of Accelerator backup data that was transferred over the network
Basic Mode
edit rule in Query Builder, Editing a query in Basic Mode
Query Builder, Creating a Hyper-V policy for automatic virtual machine selection
basic phases
in NetBackup backup of a Hyper-V virtual machine, Basic phases in a NetBackup backup of a Hyper-V virtual machine
Block-level incremental backup (BLIB), Optimization options (Hyper-V)

C

cached names
for virtual machine backup, About cached names for virtual machine backup
catalog
and use of Accelerator, Accelerator backups and the NetBackup catalog
Clients tab
automatic selection of virtual machines, Options for selecting Hyper-V virtual machines
description of fields for queries, Query Builder field reference
cluster resources
removal during restore, Removal of cluster resources during restore
Cluster Shared Volume (CSV)
backup of virtual machines that reside on same CSV, When backing up the virtual machines that reside on the same CSV, Windows warning 1584 can be ignored
Cluster Shared Volumes (CSV)
backup and restore, Notes on CSV backup and restore
common files
restore, About restoring common files
compound query rules, Parentheses in compound queries
conditions
that determine online vs offline backup, Conditions that determine online vs. offline backup for VSS
configuration
of auto selection of virtual machines, Options for selecting Hyper-V virtual machines, Creating a Hyper-V policy for automatic virtual machine selection
configurations for backing up pass-through disks, Configurations for backing up pass-through disks
configuring
a Hyper-V policy, Creating a Hyper-V policy from the NetBackup Policies utility
alternate client backup of virtual machines, Configuring alternate client backup of virtual machines
an alternate client backup of pass-through disks, Configuring an alternate client backup of Hyper-V pass-through disks
local snapshot backup of pass-through disks, Configuring a local snapshot backup of Hyper-V pass-through disks
Consistency level parameter (WMI), Consistency level parameter (WMI)
Crash Consistent, Consistency level parameter (WMI)
Cumulative Incremental Backup, Creating a Hyper-V policy from the NetBackup Policies utility

E

edit rules in Query Builder, Editing a query in Basic Mode
enable
VxFI logging, Enabling VxFI logging
Enable block-level incremental backup, Optimization options (Hyper-V)
Enable file recovery from VM backup, Optimization options (Hyper-V)
environment
NetBackup for Hyper-V, NetBackup for Hyper-V environment
errors
during policy creation, Errors during policy creation
escape character
use of in Query Builder, Query Builder field reference
Exclude deleted blocks, Optimization options (Hyper-V)
exclude disks from backup, About the exclude disk options for virtual disk selection
Exclude swap and paging files, Optimization options (Hyper-V)
Existing snapshot handling parameter (WMI), Existing snapshot handling parameter (WMI)

F

failed virtual machines
in test query, Test Query: Failed virtual machines
failure
NetBackup policy validation, NetBackup policy validation failed
Field keywords
Query Builder, Query Builder field reference
file restore
individual, Notes on individual file restore
file-level recovery, Optimization options (Hyper-V)
full virtual machine
restore, Notes on full virtual machine restore, Restoring the full Hyper-V virtual machine
restore problems, Problems with restore of the full virtual machine

I

individual files
restore, About restoring individual files
restore problems, Problems with restore of individual files
individual files to a host that has a NetBackup client
restore, Restoring individual files to a host that has a NetBackup client
individual files to a shared location on the virtual machine
restore, Restoring individual files to a shared location on the virtual machine
Intelligent Policy, About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup)
introduction
Hyper-V, About Hyper-V
IsSet operator examples, The IsSet operator in queries

J

Join field in Query Builder, AND vs. OR in queries

K

keywords
in Query Builder, Query Builder field reference

L

LDM volumes
and status code 1, LDM volumes and status code 1
limits on Hyper-V resources, Setting global limits on the use of Hyper-V resources
Linux virtual machines
notes, Notes on Linux virtual machines
local snapshot backup of pass-through disks
configuring, Configuring a local snapshot backup of Hyper-V pass-through disks
location of virtual machine
restored in a cluster, Location of the restored virtual machine in a cluster
logging
Accelerator, NetBackup logs for Accelerator with virtual machines
VxMS, Configuring VxMS and vhd logging

M

maintenance after a restore
virtual machine, Virtual machine maintenance after a restore
multiple policies
for auto selection of VMs, About selecting virtual machines by means of multiple policies
multiple virtual machines
backup job hangs, Backup job hangs for multiple virtual machines

N

nbdiscover command, Test Query screen for Hyper-V
to test a query, Important notes on Hyper-V Intelligent Policy, Setting up Hyper-V Intelligent Policy: Task overview, Options for selecting Hyper-V virtual machines
NetBackup
administrator tasks, NetBackup administrator tasks for Hyper-V
NetBackup and Hyper-V
additional information, Best practices
NetBackup backup of a Hyper-V virtual machine
basic phases, Basic phases in a NetBackup backup of a Hyper-V virtual machine
NetBackup client
inside the virtual machine, Requirements for a NetBackup client inside the virtual machine
NetBackup for Hyper-V
environment, NetBackup for Hyper-V environment
NetBackup logs
creating, NetBackup logs for Hyper-V and how to create them
NetBackup policies
more information, Backing up Hyper-V virtual machines
NetBackup policy validation
failed, NetBackup policy validation failed
NetBackup status codes
related to Hyper-V, NetBackup status codes related to Hyper-V
notes
Linux virtual machines, Notes on Linux virtual machines
notes and restrictions
Hyper-V, NetBackup for Hyper-V notes and restrictions

P

parentheses
for grouping rules in Query Builder, Using the Query Builder in Advanced Mode
for rules in Query Builder, Parentheses in compound queries
pass-through disks
alternate client backup, About alternate client backup of pass-through disks
Hyper-V, About Hyper-V pass-through disks with NetBackup
policy
configure for auto VM selection, Creating a Hyper-V policy for automatic virtual machine selection
multiple, for auto VM selection, About selecting virtual machines by means of multiple policies
Policy Configuration wizard
creating a backup policy, Creating a Hyper-V policy from the Policy Configuration Wizard
policy creation
errors, Errors during policy creation
for virtual machines in a cluster, Creating a policy for virtual machines in a cluster
with the Policies utility, Creating a Hyper-V policy from the NetBackup Policies utility
with the Policy Configuration wizard, Creating a Hyper-V policy from the Policy Configuration Wizard
Policy dialog box, Creating a Hyper-V policy from the NetBackup Policies utility
precedence, Order of operations in queries (precedence rules)
prerequisites
Hyper-V, NetBackup for Hyper-V prerequisites
Primary VM identifier parameter
and IsSet operator, The IsSet operator in queries
and multiple policies, About selecting virtual machines by means of multiple policies
and testing query rules, Test Query: Failed virtual machines, Effect of Primary VM identifier parameter on Selection column in Test Query results
and VM Name column in Test query, Effect of Primary VM identifier parameter on VM Name column in Test query results
Provider Type
configuration parameter, Provider Type configuration parameter (VSS)

R

requirements
for backing up Hyper-V pass-through disks, Requirements for backing up Hyper-V pass-through disks
Resource Limit dialog, Setting global limits on the use of Hyper-V resources
restart
of a restored virtual machine
unexpected shutdown message, Problem with a restart of a restored virtual machine: Why did the computer shut down unexpectedly?
restore
common files, About restoring common files
enter new display name, Restore Marked Files dialog for restore of the Hyper-V virtual machine
full virtual machine, Notes on full virtual machine restore, Restoring the full Hyper-V virtual machine
individual file, Notes on individual file restore
individual files, About restoring individual files
individual files to a host that has a NetBackup client, Restoring individual files to a host that has a NetBackup client
individual files to a shared location on the virtual machine, Restoring individual files to a shared location on the virtual machine
problems with full virtual machine, Problems with restore of the full virtual machine
problems with individual files, Problems with restore of individual files
removal of cluster resources, Removal of cluster resources during restore
setting up NetBackup Client Service to a shared location on the virtual machine, Setting up NetBackup Client Service for restore to a shared location on the virtual machine
Restore Marked Files
dialog box (Hyper-V), Restore Marked Files dialog for restore of the Hyper-V virtual machine
restored
virtual machine location in a cluster, Location of the restored virtual machine in a cluster
restored virtual machine
fails to start, Restored virtual machine fails to start
restart, Problem with a restart of a restored virtual machine: Why did the computer shut down unexpectedly?
restrictions
for backing up pass-through disks, Restrictions for Hyper-V pass-through disks
Retain original GUID, Restore Marked Files dialog for restore of the Hyper-V virtual machine
rules in Query Builder
about, The basics of a NetBackup query rule
configuring, Creating a Hyper-V policy for automatic virtual machine selection
editing, Editing a query in Basic Mode
examples, The basics of a NetBackup query rule
examples with parentheses, Parentheses in compound queries
IsSet operator examples, The IsSet operator in queries
manual entry of, Using the Query Builder in Advanced Mode
order of evaluation, Using the Query Builder in Advanced Mode
order of operations, Order of operations in queries (precedence rules)
testing, Test Query screen for Hyper-V
testing failued, Test Query: Failed virtual machines

S

SCVMM
About backup of VMs, About backup of virtual machines in an SCVMM environment
create policy by means of NetBackup commands, Using NetBackup commands to create a Hyper-V Intelligent Policy
Field keywords in Query Builder, Query Builder field reference
notes on backup policy for, Notes on NetBackup for Hyper-V with SCVMM
policy configuration, Creating a Hyper-V policy for automatic virtual machine selection
select automatically through query
virtual machines, About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup)
Server type
for auto selection of VMs, Query Builder field reference
setting global limits on Hyper-V resources, Setting global limits on the use of Hyper-V resources
setting up NetBackup Client Service
for restore to a shared location on the virtual machine, Setting up NetBackup Client Service for restore to a shared location on the virtual machine
Snapshot Attribute
configuration parameter, Snapshot Attribute configuration parameter (VSS)
snapshot error encountered
status code 156, Snapshot error encountered (status code 156)
snapshot handling, Existing snapshot handling parameter (WMI)
snapshot parameter values
VSS and disk arrays, Important note on VSS and disk arrays
state of virtual machine before and after restore, WMI backup method: State of the virtual machine before and after restore
status code 1
and Hyper-V snapshots (avhd or avhdx files), Hyper-V snapshots (avhd or avhdx files) and status code 1
and LDM volumes, LDM volumes and status code 1
status code 156
snapshot error encountered, Snapshot error encountered (status code 156)
swap and paging files, exclude, Optimization options (Hyper-V)

V

values
in Query Builder, Query Builder field reference
view or resize
Windows NTFS shadow storage, Viewing or resizing Windows NTFS shadow storage
Virtual disk selection parameter (WMI), Virtual disk selection parameter (WMI)
virtual machine
maintenance after a restore, Virtual machine maintenance after a restore
NetBackup client inside, Requirements for a NetBackup client inside the virtual machine
virtual machine backup
cached names, About cached names for virtual machine backup
Virtual machine quiesce option, Consistency level parameter (WMI)
virtual machines
alternate client backup, Prerequisites for alternate client backup of a virtual machine (VSS)
backup on the same CSV, When backing up the virtual machines that reside on the same CSV, Windows warning 1584 can be ignored
configure for auto selection of, Creating a Hyper-V policy for automatic virtual machine selection
notes on query builder, Important notes on Hyper-V Intelligent Policy
on Windows failover clusters, About virtual machines on Windows 2012 and 2016 failover clusters
requirements for auto selection, NetBackup requirements for Hyper-V Intelligent Policy
select automatically through query, About Hyper-V Intelligent Policy (automatic selection of virtual machines for backup)
testing auto selection of, Test Query screen for Hyper-V
virtual machines in a cluster
creating a policy, Creating a policy for virtual machines in a cluster
VM Name column in Test Query screen, Effect of Primary VM identifier parameter on VM Name column in Test query results
VSS and disk arrays
snapshot parameter values, Important note on VSS and disk arrays
VSS backup method, Creating a Hyper-V policy from the NetBackup Policies utility
VxFI logging
enable, Enabling VxFI logging
VxMS logging, Configuring VxMS and vhd logging