Welcome to the Dell Technologies Avamar “How to” series.
How to Run the “getlogs” Utility to Gather Avamar Server Logs. Reference: Dell Knowledge Article # 22859. This video was created to demonstrate how to run the getlogs utility on an Avamar grid. It will also show you how to locate any files associated with a previous rollback.
The first part of this video shows the following: how to determine the currently running version of the GSAN on the Avamar grid how to load the ssh-keys (based on the GSAN version) how to run getlogs and how to check the log file size. The second part of the video shows you where to check for logs associated with a grid rollback.
It is possible that you will be asked to provide the logs by the Dell EMC technical support engineer to assist with troubleshooting. You may also be asked to provide any logs associated with a previous rollback. Before you begin, you will need to know the IP address and the admin password of the Avamar utility node.
You will also require programs such as PuTTY and WinSCP for connection and file transfer. It should be noted that as the logs can grow quite large the utility should be run from the /admin/home directory. Log in as user admin. If you don’t know which version of Avamar you are running type the command “gsan --version | head -1”.
As shown on the screen, this Avamar grid is running version 19.1 so we would load the ssh-keys by typing “ssh-agent bash” and “ssh-add .ssh/admin_key”.
If the GSAN was running version 7.2 or lower the commands to load the keys would be “ssh-agent bash” and “ssh-add .ssh/dpnid”. To run the getlogs utility you can specify how many days of logs you require by use of the “server=” switch. In our example running “getlogs --server=3” will provide three days of logs. The utility will run and you will see similar outputs to those shown on the screen.
Highlighted is the log file generated from our example and the file you would provide to the Dell EMC technical support team. To determine the size of the log file type “ls -lh” followed by the log file name. If the size is less than two gigabytes it can be attached to the service request directly.
If the size exceeds two gigabytes it will need to be uploaded to an FTP site. This information would be provided to you by your Dell EMC technical support engineer if needed. If you are looking for logs related to a previous rollback type “ls -lh /user/local/avamar/var/log/rollback”.
The results will show up to the three most recent rollback logs. The size will again determine if the logs can be attached directly to the service request or uploaded to an FTP site. If you have any questions please reach out to a Dell EMC technical support engineer who will be more than happy to assist.
Thank you for watching!