NVP-vProxy: How to use health check tool ProxyHC on vProxy appliance

Summary: Utility provides an automated, efficient, and human-readable way to perform first-step or basic self-diagnostic for vProxy appliance.

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

Purpose:

Utility provides an automated, efficient, and human-readable way to perform first-step or basic self-diagnostic for vProxy appliance. The ProxyHC utility can be copied to the vProxy and run from the NetWorker Troubleshooting.


The ProxyHC utility is not included on the vProxy by default. The ProxyHC utility can be downloaded from the following support tools page: https://central.dell.com/solutions/Networker-Tools

NOTE:This uses your Dell support site credentials. For internal Dell employees, this uses your corp credentials. For vProxy 4.3.0.x (SuSE 12 SP5) you can use ProxyHC-2.7.19. Starting vProxy version 4.4.0.x (SuSE 15 SP4), you must use ProxyHC-2.7.19.v2.

 

The utility can be copied using the following methods:

  • WinSCP:
    • Host: vProxy Hostname
    • Protocol: SCP
    • Username: admin
      NOTE: root login over SSH is typically blocked by default)
    • Path: /home/admin/
       
  • Windows Server 2019 (and later) has SCP command line capabilities:
scp ProxyHC admin@vProxyHostname:/home/admin/ProxyHC
image.png

How to Use:

1. Connect to the vProxy appliance using SSH, log in as admin.
2. Switch to root user: 
sudo su -
3. Make ProxyHC executable: 
chmod +x /home/admin/ProxyHC

4. Run ProxyHC: 
/home/admin/ProxyHC flags
Usage examples: 
my-vproxy:/home/admin # /home/admin/ProxyHC vCenter --help
usage: ProxyHC vCenter [-h] --name NAME --user USER [--pwd PWD] [--vm VM]
                       [--nsruser NSRUSER] [--nsrpwd NSRPWD]
                       [--nsrauthc NSRAUTHC] [--allproxies ALLPROXIES]
                       [--DDhost DDHOST]
                       {auth,port,perm,disk,hotadd,migration,listsession,annotation,cleanup,kb524127,all,layout,tasks,datastore,vmsnapchain,vmdisksize,termsoapsession}
                       ...

positional arguments:
  {auth,port,perm,disk,hotadd,migration,listsession,annotation,cleanup,kb524127,all,layout,tasks,datastore,vmsnapchain,vmdisksize,termsoapsession}
                        sub-command help
    auth                test authentication against vCenter server
    port                check open ports to ESXi hosts in cluster and data
                        domain systems
    perm                check vCenter access permissions
    disk                check & release extra disks from vProxy
    hotadd              check for hotadd access to provided VM
    migration           check vCenter for stale migration locks
    listsession         print login session list to log
    annotation          check vCenter for stale backup locks(annotations)
    cleanup             remove left over artifacts(extra disks,
                        locks/annotations) and find migration locks.
    kb524127            check for invalid state of vProxy VM
    all                 All vCenter tools(combination of port, perm and
                        cleanup)
    layout              check for description of files that make up VM
    tasks               check orphaned tasks in vCenter
    datastore           look for datastores with unsupported names
    vmsnapchain         check if any protected VM has excessive child disks
    vmdisksize          check if any protected VM has irregular disk size i.e.
                        trailing .5 KB
    termsoapsession     terminate soap session to vCenter from NWS

optional arguments:
  -h, --help            show this help message and exit
  --name NAME           hostname of the vCenter server
  --user USER           user name for login to vCenter server
  --pwd PWD             password for login to vCenter server
  --vm VM               DNS name of VM(as shown in vSphere)
  --nsruser NSRUSER     user name for login to NetWorker server
  --nsrpwd NSRPWD       password for login to NetWorker server
  --nsrauthc NSRAUTHC   Remote AuthC server
  --allproxies ALLPROXIES
                        specify to do work on peer vProxies registered
  --DDhost DDHOST       provide DD IP/hostname for port connectivity tests
NOTE: You can use multiple flags in one ProxyHC command, for example: /home/admin/ProxyHC auth port perm tasks disk cleanup hotadd

 

5. The log file is generated under /tmp/proxy-hc.log.

Additional Information

Affected Products

NetWorker

Products

NetWorker
Article Properties
Article Number: 000022590
Article Type: How To
Last Modified: 29 Sept 2025
Version:  14
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.