NVP-vProxy: How to use the vmconfig utility

Riepilogo: This KB provides instructions for how to use the vmconfig utility to troubleshoot Virtual Machine (VM) protection failures.

Questo articolo si applica a Questo articolo non si applica a Questo articolo non è legato a un prodotto specifico. Non tutte le versioni del prodotto sono identificate in questo articolo.
Scopri le altre risorse

Istruzioni

Overview:

The vmconfig utility is troubleshooting utility that can be used to identify potential impacts to NetWorker VMware Protection (NVP) operations. For example, it can list if a VM is still locked from backup; or if the VM has VMware Change Block Tracking (CBT) enabled or disabled. Additional uses are detailed in the below Instructions field. The ProxyHC utility can also be used to perform many of the same functions; however, vmconfig is provided on the vProxy by default where ProxyHC must be downloaded and placed on the vProxy. For more information about ProxyHC, see the Additional Info section of this article.

 

Instructions:

 

1. Log in to the vProxy as admin, then switch to root:

sudo su -

2. Change to the bin directory:

cd /opt/emc/vproxy/bin

3. Run the command below to load the library path:

source ../unit/vproxy.env

NOTE: "error while loading shared libraries" may appear while using vmconfig if the above step is not performed.

4. Run the vmconfig command. 

Syntax: 

VM Config
Missing argument(s)...
  -D string
        Enable detail logging for package, "-D common/example""
  -L string
        Log level { debug, trace, info, warn }
  -c string
        Commands: "cancel-sdm-snapshot" | "cleanup-vddk" | "disable-cbt" | "disable-migration" | "disable-sdm" | "enable-cbt" | "enable-migration" | "enable-sdm" | "info" | "lock-vm" | "reset-backup" | "unlock-vm"
  -d value
        Disk key: [ -d <int> ], ...
  -f    Force command to take effect, ignoring current state
  -k string
        Lookup key associated with lookup mode.  Note: for lookup by path use [<datacenter-folder>/]<datacenter-name>/vm/[<vapp-name>]/<vm-name>.
  -l string
        Lookup mode: { "dns" | "ip" | "moref" | "path" }
  -logsdir-owner-group string
        owner group name of the log folders and files
  -m string
        Hypervisor mode: { "VMC" | "vSphere"  } (default "vSphere")
  -p string
        User password
  -s string
        Snapshot UUID
  -u string
        User name
  -v string
        vCenter host name
  -vddk-hotadd-threshold int
        Threshold for logging warnings indicating too many concurrent VDDK hotadd sessions. (default 24)
Example: 
nsr-vproxy01:/opt/emc/vproxy/bin # ./vmconfig -c info -k "vm-17023" -l moref -u administrator@vsphere.local -p '!Password1' -v vcsa.amer.lan
VM Config
vCenter: "vcsa.amer.lan", User: "administrator@vsphere.local", Password: "!Password1", Lookup Mode: "moref", Lookup Key: "vm-17023", HypervisorMode: "vSphere", Command: "info"
Logged into vCenter 'vcsa.amer.lan'.
Connected to session on vCenter 'vcsa.amer.lan' Version '8.0.3 build-24322831, API:8.0.3.0', Uuid:e5390e5f-912e-4818-ad6e-ea9b878ff57d.
Found virtual machine 'rhel-client01.amer.lan' with MORef 'vm-17023'.
vm-17023: Name: "rhel-client01.amer.lan".
vm-17023: CBT Enabled: true.
vm-17023: Migration Enabled: true.
vm-17023: Backup Locked: false.
Disconnected from session on vCenter 'vcsa.amer.lan'.
Logged out from vCenter 'vcsa.amer.lan'.

Informazioni aggiuntive

Prodotti interessati

NetWorker

Prodotti

NetWorker Family
Proprietà dell'articolo
Numero articolo: 000034594
Tipo di articolo: How To
Ultima modifica: 22 giu 2025
Versione:  4
Trova risposta alle tue domande dagli altri utenti Dell
Support Services
Verifica che il dispositivo sia coperto dai Servizi di supporto.