NVP-vProxy: How to use the vmconfig utility

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

Dieser Artikel gilt für Dieser Artikel gilt nicht für Dieser Artikel ist nicht an ein bestimmtes Produkt gebunden. In diesem Artikel werden nicht alle Produktversionen aufgeführt.

Weisungen

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

Weitere Informationen

Betroffene Produkte

NetWorker

Produkte

NetWorker Family
Artikeleigenschaften
Artikelnummer: 000034594
Artikeltyp: How To
Zuletzt geändert: 22 Juni 2025
Version:  4
Antworten auf Ihre Fragen erhalten Sie von anderen Dell NutzerInnen
Support Services
Prüfen Sie, ob Ihr Gerät durch Support Services abgedeckt ist.