NVP-vProxy: How to use the vmconfig utility

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

本文章適用於 本文章不適用於 本文無關於任何特定產品。 本文未識別所有產品版本。

說明

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

其他資訊

受影響的產品

NetWorker

產品

NetWorker Family
文章屬性
文章編號: 000034594
文章類型: How To
上次修改時間: 22 6月 2025
版本:  4
向其他 Dell 使用者尋求您問題的答案
支援服務
檢查您的裝置是否在支援服務的涵蓋範圍內。