NVP-vProxy: How to perform a VM restore from the command line

Summary: The NetWorker VMware Protection (NVP) integration is configured with the vProxy appliance. In certain situations, it is necessary to perform a restore from the command line (CLI). This article provides general information about performing a Virtual Machine (VM) Image Restore using nsrvproxy_recover. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

The NetWorker VMware Protection (NVP) integration is configured with the vProxy appliance. In certain situations, it is necessary to perform a restore from the command-line interface (CLI). The NetWorker Command Reference Guide provides information regarding nsrvproxy_recover. NetWorker documentation is available through: Support for NetWorker | Manuals & Documents
 

  1. Identify the save set ID (SSID) you want to restore. This can be done using one of the following approaches:
  • Using the NetWorker Management Console (NMC) Media tab in the Save Sets section.
  • NetWorker server command-line: mminfo -avot -q vmname=VMNAME
  1. Use an mminfo command with the "-S" option to query the complete information about the save set from the NetWorker Server media database: 
mminfo -S -q ssid=<SSID>
NOTE: Alternatively, use the following method to generate the command needed for CLI restore: NVP vProxy: How to get the exact command syntax for running a VM recovery from CLI with debug
  1. Using the information obtained from the mminfo output in step 3 to create the nsrvproxy_recover command.
    Syntax:
nsrvproxy_recover [-vvv] [-D<Debug_Level>] -c <vCenter FQDN> -S <ssid> -m <recovery method> -M <vm-moref> -V <Desired recovered VM name> -A <datacenter moref> -C <compute resource moref> -H <host moref> -E <datastore moref> [-k] [> output_file.log]
    • -vvv (optional) additional verbosity
    • -D (optional) added debugging levels, see: NetWorker: Debug information levels
    • -m Recovery methods:
      • R (Revert Virtual Machine) Revert an existing virtual machine back to a point-in-time. If Change Block Tracking (CBT) is enabled, it moves only the data that have changed.
      • I (Virtual Machine Image Recovery): Recover the selected virtual machine, as a new virtual machine.
      • D (Virtual Machine Disk Recovery): Recover one or more disks to an existing virtual machine.
      • N (Instant Recovery): Use instant access to recover the selected virtual machine, as a new virtual machine. The datastore is located in the Data Domain device that the save set is stored. Once the nsrvproxy_recover process is terminated, the datastore is reclaimed automatically. In order to preserve the virtual machine, use Storage vMotion to migrate the virtual machine to another datastore.
      • E (Emergency Recovery): Recover the selected virtual machine to an ESXi host.
    • -k (optional) concurrent VMDK restore.
    • > output_file.log (optional) redirect the nsrvproxy_recover command output to a log file in a location of your choosing.
    • Additional options are detailed in the nsrvproxy_recover section of the NetWorker Command Reference Guide

Example command Syntax of performing a Virtual Machine Recovery:

nsrvproxy_recover -vvv -D9 -m I -c vcsa.amer.lan -M vm-4007 -V rhel-client01_RESTORE -A datacenter-3 -L domain-c8 -F group-v4 -E datastore-12 -S 1971497009 -k
NOTE: If you use the ESXi host MoRef and datastore MoRef from the mminfo output, this restores to the same ESXi host and datastore as the original VM resided on when it was backed up. Ensure that this ESXi host has available resources and the datastore has sufficient space available. If the session is closed or the prompt is canceled, the restore session is terminated.

You can run the command in the background so that it is not terminated by session or prompt closure:

Linux:

nohup nsrvproxy_recover [-vvv] [-D<Debug_Level>] -c <vCenter FQDN> -S <ssid> -m <recovery method> -M <vm-moref> -V <Desired recovered VM name> -A <datacenter moref> -C <compute resource moref> -H <host moref> -E <datastore moref> [-k] > /tmp/nsrvproxy_recover-$(date -I).log &
Windows (PowerShell):  
Start-Process powershell.exe `
  -ArgumentList "-Command nsrvproxy_recover [-vvv] [-D<Debug_Level>] -c '<vCenter>' -S '<ssid>' -m '<method>' -M '<vm-moref>' -V '<vmname>' -A '<dc-moref>' -C '<compute>' -H '<host>' -E '<datastore>' [-k] *>> C:\temp\nsrvproxy_recover.log" `
  -WindowStyle Hidden `
  -NoNewWindow

To stop the job, you must kill the PID for the nsrvproxy_recover process. Alternatively you can kill the nsrvproxy_recover job id from the NetWorker server jobkill command prompt.

  1. If the restore initiates properly, you can monitor the progress in the prompt, NMC Monitoring tab, nsrwatch command, or vSphere.

Additional Information

Affected Products

NetWorker

Products

NetWorker
Article Properties
Article Number: 000158471
Article Type: How To
Last Modified: 16 شعبان 1447
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.