The bpplinfo options for Hyper-V policies
Table: The bpplinfo options for Hyper-V describes the options that are available on the NetBackup bpplinfo command.
Table: The bpplinfo options for Hyper-V
Option | Backup method | Values | Required? | Navigation in policy editor of NetBackup Administration Console |
|---|---|---|---|---|
-use_virtual_machine | WMI, VSS | 2 | Y | |
-hyperv_server | WMI, VSS | The name of the Hyper-V server | Y | Clients tab > Hyper-V server |
-application_discovery | WMI, VSS | 0 disabled, 1 enabled | N (only for automatic selection of VMs through a query rule) | Clients tab > Select automatically through Hyper-V Intelligent Policy query |
-blkincr | WMI | For block-level incremental backup 0 disabled, 1 enabled | N (required for Accelerator) | Hyper-V tab |
-use_accelerator | WMI | 0 disabled, 1 enabled | N | Hyper-V tab |
-snapshot_method | WMI, VSS | HV (for WMI) Hyper-V_v2 (for VSS) | Y | Hyper-V tab |
-offhost_backup | VSS | 0 No off-host backup (default) 1 Use off-host backup method (for alternate client) | N | Attributes tab > Perform off-host backup |
-use_alt_client | VSS | 0 No alternate client 1 Use an alternate client | Y (with -offhost_backup option) | Attributes tab > Perform off-host backup > Use |
alt_client_name | VSS | The name of the alternate client | Y (with use_alt_client) | Attributes tab > Perform off-host backup > Machine |
snapshot_method_args | WMI, VSS | keyword=value, keyword=value,... | N |
Table: Keywords and values for snapshot_method_args describes the keywords for -snapshot_method_args.
Table: Keywords and values for snapshot_method_args
Keyword | Backup method | Values | Navigation in policy editor of NetBackup Administration Console |
|---|---|---|---|
Virtual_machine_ backup= | WMI, VSS | 1 Disable file-level recovery 2 Enable file-level recovery | Hyper-V tab > Enable file recovery from VM backup |
nameuse= | WMI, VSS | 0 Use VM host name to identify backup image 1 Use VM display name to identify backup image 2 Use VM GUID to identify backup image | Hyper-V tab > Primary VM identifier |
allow_offline_ backup= | VSS | 0 Do not allow offline backup of non-VSS virtual machines 1 Allow offline backup of non-VSS virtual machines | Hyper-V tab > Enable offline backup of non-VSS VMs |
csv_timeout= | VSS | Determines how many minutes the backup job waits, in case another node in the cluster backs up the same shared volume at the same time. The default is 180 (wait for 3 hours). A wait of 3 hours is recommended if you have multiple virtual machines on one CSV. The Windows 2008 R2 cluster node owns the CSV for the entire duration of the backup. If you do not want NetBackup to wait for another backup to release the shared volume, set the value to 0. If at the same time another node in the cluster backs up a shared volume that this backup requires, the backup fails with status 156. Note: On Windows server 2012, cluster nodes can back up the same CSV simultaneously. As a result, NetBackup does not use this option if the cluster is on Windows 2012. | Hyper-V tab > Cluster shared volumes timeout |
prov_type= | VSS | 0 Automatic selection of provider. Allows VSS to use the best possible provider for the snapshot. 1 Use system provider 2 Use software provider 3 Use hardware array provider | Hyper-V tab > Advanced > Provider Type |
snap_attr= | VSS | 0 (default) 1 Differential. Use copy-on-write snapshot method. 2 Plex. Use clone or mirror snapshot method. | Hyper-V tab > Advanced > Snapshot Attribute |
file_system_ optimization= | WMI | 0 Disable file system optimization 1 Enable file system optimization | File system optimization is enabled if either or both of the following are selected: Hyper-V tab > Exclude deleted blocks Hyper-V tab > Exclude swap and paging files |
exclude_swap= | WMI | Reduces the size of the backup image by excluding the data in the guest OS system paging file (Windows) or the swap file (Linux). 0 Disable 1 Enable | Hyper-V tab |
snapact= | WMI | 3 Abort if NetBackup snapshots exist | Hyper-V tab > Advanced > Existing snapshot handling |
drive_selection= | WMI | 0 Include all disks 1 Exclude boot disk 2 Exclude data disks | Hyper-V tab > Advanced > Virtual disk selection |
hv_snapshot_ consistency_level= | WMI | Determines whether the VM's file system data is consistent (quiesced) before the backup starts. 0 Application Consistent Then Crash Consistent 1 Application Consistent 2 Crash Consistent | Hyper-V tab > Advanced > Consistency level |