Veritas NetBackup™ for Hyper-V Administrator's Guide

To use NetBackup commands to create a Hyper-V policy

1. Create a policy.

   bppolicynew policyName

   For example:

   bppolicynew HVpolicy1

2. 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:

     See The bpplinfo options for Hyper-V policies.

3. 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

4. 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.

5. 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

6. Use the bpbackup command to start the backup.

   For details on bpbackup, see the NetBackup Commands Reference Guide.