Collect diagnostic information from AIX and PowerVM

Utilize the NetApp nSANity tool that comes in one of two formats, a Windows based GUI tool and a command line tool, available for both Windows and BASH command lines.

AIX hosts need to have data gathered from any host needing analyzed that has SAN access. If the LPAR is a PowerVM guest partition, the information will need to be gathered from the PowerVM hosts through hwich the LPAR makes connection to the SAN.

If the LPAR accesses the SAN through hdisks presented through vSCSI, it is still reccomended to gather LPAR data in addition to the PowerVM hosts.

In the GUI tool, you will need to populate each of the fields appropriate to all of the hosts involved. It is also requested that data be gathered from the fabric switches between the storage system and the SAN hosts as well.

If you are using the command line tool, the command to gather data from an AIX LPAR, two PowerVM hosts, and two Brocade switches will be:


nsanity.exe aix://username:*@aixhost powervm://padmin:password@powervmhost powervm://padmin:*@aixhost3 brocade://username:*@BrocadeSwitch brocade://username:*@BrocadeSwitch2 -f 2005123456.nsanity.xml.gz


./nsanity aix://username:*@aixhost aix://username:*@aixhost2 aix://username:*@aixhost3 brocade://username:*@BrocadeSwitch brocade://username:*@BrocadeSwitch2 -f 2005123456.<host|site|date>.nsanity.xml.gz

You can add and remove hosts as necessary and will need to update to the appropriate host name. The above command line will prompt for the password due to using the ‘*‘ character in the password field. Alternatively, if the host accepts passwordless SSH, that could be used as well. Also, the output file should have ‘2005123456’ changed to the appropriate NetApp case number, as well as a unique identifier placed in it of: host, site, or date/time information.

It is recommended to use the root access account for LPARs (or an appropriate pseudo account) and padmin for PowerVM hosts. You can add and remove the number of each type of host as necessary as well as change the switch type. The download link for the command line tool contains the full syntax for each type of host or switch. If requested on pre-Data ONTAP 8.3 versions, the storage system can have its data gathered as well.

Once the data collection is complete, it can be uploaded to NetApp Support.

If you wish to view the collected data that can be done in one of three ways:

  1. Decompress the file and view the raw xml based output.
  2. Run the nSANity tool with the -x option to parse the data collected into folders with individual text files for each output.
    Example: ./nsanity -x 2005123456.nsanity.xml.gz
  3. Use the NetApp DataCenter Planner to parse the output file.


View all posts by