NVP-vProxy: How to use the vmconfig utility

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

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

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

Additional Information

Affected Products

NetWorker

Products

NetWorker Family
Article Properties
Article Number: 000034594
Article Type: How To
Last Modified: 22 Jun 2025
Version:  4
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.