NVP-vProxy: How to use the vmconfig utility
Résumé: This KB provides instructions for how to use the vmconfig utility to troubleshoot Virtual Machine (VM) protection failures.
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
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)
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'.