Using NetBackup commands to create a Hyper-V policy
This topic describes how to use NetBackup commands to create a backup policy that includes the new features for Hyper-V on Windows Server 2016: Block-level incremental backup and Accelerator. Note that this topic explains how to create a policy that selects virtual machines manually.
For a policy that automatically selects virtual machines through a query rule, see the following:
See Using NetBackup commands to create a Hyper-V Intelligent Policy.
The NetBackup commands for policy creation are in the following directory:
Windows: |
|
UNIX or Linux: |
|
Run these commands on the NetBackup primary server.
Note:
To run virtual machine backups, a NetBackup client must be installed on the Hyper-V server.
To use NetBackup commands to create a Hyper-V policy
- Create a policy.
bppolicynew policyName
For example:
bppolicynew HVpolicy1
- Set the policy attributes.
To accept the default attributes, enter the following:
bpplinfo policyName -set -pt Hyper-V -use_virtual_machine 2 -hyperv_server "hyper-v_server" -fi 1 -snapshot_method "HV" -blkincr 1 -use_accelerator 1
To specify additional options, enter the following with -snapshot_method_args:
bpplinfo policyName -set -pt Hyper-V -use_virtual_machine 2 -hyperv_server "Hyper-V_server" -fi 1 -snapshot_method "HV" -blkincr 1 -use_accelerator 1 -snapshot_method_args "nameuse=1, Virtual_machine_backup=2,file_system_optimization=1,exclude_swap=1, drive_selection=0,snapact=3,hv_snapshot_consistency_level=0"
Notes:
The -hyperv_server option specifies the Hyper-V host, Hyper-V cluster, or SCVMM server that contains the VMs to back up.
The option -snapshot_method "HV" specifies the WMI snapshot method for VMs on Hyper-V Server 2016. (-snapshot_method "Hyper-V_v2" specifies the VSS method, which does not support block-level incremental backup or Accelerator.)
The option -blkincr: 1 enables block-level incremental backup (BLIB).
The option -use_accelerator: 1 enables Accelerator. (This option also enables BLIB.)
The -snapshot_method_args option is a comma-delimited list of keywords that define the Hyper-V snapshot and policy.
The available keywords and values for -snapshot_method_args are described in a separate topic:
- Create a policy schedule.
bpplsched policyName -add sched_label -st sched_type
For the -st option, the available schedule types are FULL (full), INCR (differential incremental), or CINC (cumulative incremental).
For example:
bpplsched policy1 -add Full -st FULL
- Select the virtual machines to back up.
bpplclients policyName -add VM_to_back_up
On this command, specify one virtual machine at a time. Specify the virtual machine's display name, host name, or GUID. You can use the Hyper-V management console to obtain the display name or GUID.
For example:
bpplclients policy1 -add prodvm1.acme.com
In this example, prodvm1.acme.com is the virtual machine to back up, including all of its local drives. Note: The backup selection is automatically set to ALL_LOCAL_DRIVES, which is the only option that is available for the Hyper-V policy type.
- Validate the policy.
bpclient -policy policyName -validate - fi
If the policy successfully validates, no output appears. Otherwise, the following error occurs:
Error code 48 : client hostname could not be found
- Use the bpbackup command to start the backup.
For details on bpbackup, see the NetBackup Commands Reference Guide.
The following topic contains examples of the nbrestorevm command to restore Hyper-V virtual machines: