ViPR Controller: How to use the Diagutils to collect ViPR data

Starting May, 03 2017, A new tool was introduced to collect all ViPR related logs. This tool includes the database dumps (Slither), ZK properties, ViPR System Properties, ViPR health information, backup utility, etc. 

Click on Diagutils data collection utility for ViPR Controller to download the tool. 

Instructions to use Diagutils:

1. Extract the zip file.
2. Copy the file diagutils to any directory on a ViPR C node.
3. Rename the file from diagutils to diagutils.sh --> mv diagutils diagutils.sh
4. Make this file executable --> chmod +x diagutils.sh
5. Run the file ./diagutils.sh with one or more of the below parameters as advised by EMC Support Engineer: 
   • ./diagutils -all_cfs -properties -health  zk will collect the ViPR Controller column family, properties, health, and zookeeper data.
   • ,.diagutils.sh -all_cfs will collect full slither logs 
   • ./diagutils.sh -min_cfs will collect the default database columns 
   • ./diagutils.sh -zk will collect ZK jobs and queues through zkutils
   • ./diagutils.sh -backup creates a new ViPR system backup/dump of DB and ZK through bkutils, which can be restored later (If the backup name is not specified, timestamp will be used instead and If the backup name already exists, the utility won't create a new backup, but copy the existing backup into the archive)
   • ./diagutils.sh -properties will collect system properties (version, node count, node names, etc.)
   • ./diagutils.sh -health will collect the system health information (e.g. node and service status, etc.), performance data of local node from top output.

- More than one parameter can be added to the execution command 
   eg. ./diagutils.sh -zk -all_cfs will collect the ZK and the full database dump. 

- If provided an FTP link with username and password by the Support Engineer, the diagutils can be run in the background by adding an FTP link to automatically upload the logs when done.
eg: ./diagutils.sh -ftp ftp.emc.com -u <user name> -p <password>
If specified, the output will be transferred to the external ftp/ftps server and removed from local storage after the transfer so it's suggested to always transter the output to the FTP to retain space in ViPR nodes

- This tool is built-in starting from ViPR v3.6. And for earlier versions you'll need to download the tool from the link mentioned in the instructions section.

- For more information, please check the Readme file included in the download zip file.

- For more information on what should be collected for a ViPR Controller case see the following article:

489896 - ViPR Controller: What information should a customer provide for ViPR Controller issues?