Avamar Proxy and Snapshots – Useful Commands

Avamar Proxy’s are the life blood of Avamar VMware Image backups!  When they work, they work great.  Then comes the not so great and the darn terrible.  Here are a few useful commands that can help troubleshoot and repair problems with Avamar Proxy servers.

*** Please note that proxcp.jar is a very powerful tool!  I would highly recommend engaging EMC Support or an EMC Partner for assistance when using it.

To register the proxy you can do this 1 or 2 ways.  Reboot the proxy and press a any key when it tells you too or you can run the following command from CLI on the proxy.

/usr/local/avamarclient/etc/initproxyappliance.sh –start

Then provide your Avamar FQDN, the domain to register the proxy and the Avamar software root password (going back to same proxy leave blank).

To test your proxy appliance against a VM is useful for determining if the proxy has all the

First you will need the proxycp.jar which you can get from EMC.  To download it directly to your Avamar run the following command:

cd /tmp
Curl -O ftp://avamar_ftp:anonymous@ftp.avamar.com/software/scripts/proxycp.jar 

Checking proxy servers hotadd against virtual machines.  There are 11 items that need to pass in order for HOTADD to function.  To verify a proxy is working correctly and the VM that will use the proxy you can use the following command:

java -jar proxycp.jar –hotadd –vm *VM NAME* –proxy *Proxy-name*

Sometimes you are having snapshot issues.  One option is to find and clean any hidden snapshots.

java -jar proxycp.jar -listsnapshots 2>/dev/null | grep “Hidden Snapshot File”

You can also cleanup hidden snapshot files as well.  *Be aware* If you do not know what you are doing you can be very destructive.  Use at your own risk!  Contact EMC support if you are unsure.

java -jar proxycp.jar –listsnapshots –cleanup

Can also consolidate snapshots but I will not list this command.  I would suggest doing this through your vCenter or contact your VMware staff.

Another useful command is used to clean snapshots off the proxy server.  This is a quick way to prepare the proxy server for a reboot or other services.

java -jar proxycp.jar –listproxydisk –cleanup

I have used all these commands on Avamar Gen4 and Gen4s nodes running Avamar 7.1.1-145.

Please feel free to drop me a line with any questions!

~Chad

Leave a comment