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:	`install_path\Veritas\NetBackup\bin\admincmd`
UNIX or Linux:	`usr/openv/netbackup/bin/admincmd`

Run these commands on the NetBackup master 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:
  See The bpplinfo options for Hyper-V policies.
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:

See Examples of nbrestorevm for restoring VMs to Hyper-V.

Using NetBackup commands to create a Hyper-V policy

Feedback

Feedback