Examples of nbrestorevm for restoring VMs to Hyper-V
To restore VMs, you can use the nbrestorevm command on the master server or on the recovery host. The command is located in the following directory:
Windows
install_path\NetBackup\bin\nbrestorevm.exe
UNIX and Linux:
/usr/openv/netbackup/bin/nbrestorevm
The following nbrestorevm options are used in the examples in this topic:
- vmhv
Indicates a restore to the original location.
-vmhvnew
Indicates a restore to a different location (instead of - vmhv).
-vmhvstage
Indicates a restore to a staging or temporary location.
-vmncf
For a VM that uses files in common with other VMs, this option restores the VM but does not restore the common files.
-C virtual_machine_to_restore
Identifies the VM to restore. The VM name must match the type of name that was selected in the option of the backup policy. For example, if the VM was backed up by its VM display name, use the VM's display name on the -C option.
Note:
Spaces in the VM name must be represented as %20 on the -C option. If the VM's name is acme vm1, enter acme%20vm1.
-vmid
For restore to an alternate location, retains the original GUID for the restored VM (prevents the creation of a new GUID).
-R absolute_path_to_rename_file
For restore to an alternate location, describes the path to a text file (the rename file) that contains directives for restoring the VM's files. The rename file specifies the original paths and the new paths for the restored VM files (xml, bin, vsv, vhd). The rename file must specify paths for all four VM file types.
See Hyper-V examples of restore to alternate locations.
Further notes are available on the rename file:
-vmserver Hyper-V_server
Specifies a different server as the target for the restore. The default is the Hyper-V server that backed up the VM. To restore to the Hyper-V server that backed up the VM, omit this option.
- S master_server
Specifies the master server that made the backup (if different from the current master).
-O
Overwrites the VM and the associated resources if they already exist. This option is required if the VM exists in the target location.
-w [hh:mm:ss]
The nbrestorevm command waits for completion of the restore before it returns to the system prompt.
Without the -w option, nbrestorevm initiates the restore and exits. You can verify the job completion status in the Activity Monitor of the NetBackup Administration Console.
-L progress_log_file [-en]
Specifies an existing file to contain debug information about the restore. If the server where you run nbrestorevm is configured for a non-English locale, the -en option creates an additional log file in English.
Following are examples for nbrestorevm.