This document describes the summ tool, its options and use cases for summarizing and decoding AIX I/O error messages.
Diagnostic tool for decoding and summarizing AIX I/O error messages
summ [Flags] [Filename]
-e Include FC driver error numbers for each error.
-p Paginate the output.
-r Reverse the order of output.
-s Include sequence numbers in each line's header.
NOTE: summ --help displays the flags presented above.
"summ" is an AIX only diagnostic tool used to decode fibre-channel and SCSI disk AIX error report entries. It is an invaluable tool that can aid in diagnosing storage array or SAN fabric related problems providing the source of the error.
The script generates single line error messages enhancing the readability of the AIX error report. This is the same tool used by IBM Support worldwide and is considered safe to run in a production environment.
From a file:
# errpt -a > errpt.out
From standard input:
Use continuous errpt option flag to watch errors in real time while the messages are logged to the AIX error report:
# errpt -ac | summ
The summ command depends on the version of the perl command shipped with AIX. Perl fileset is available in each level of AIX as shown at the following link:
NOTE: The summ script is provided as a courtesy, and it is provided as-is, without warranty and without guarantee of having no defects. Support for this script is not available.
Click on this summ link to download the summ utility. After downloading the summ_version_1.tar file, transfer this file to your AIX system into the /tmp directory as /tmp/summ_version_1.tar. While logged in as the root user, execute the following commands to install the summ command into the /usr/local/bin directory:
# cd /usr/local/bin
# tar -xvf /tmp/summ_version_1.tar
# chmod 755 summ
The following snippet of data is an output generated upon running summ on an AIX Server. These are just some of the common decoded errors available and are presented below for exemplification purposes only:
Jul 4 16:18:27 fcs1 I FCA_ERR12 INFO: Adapter link up recovery;link failure cnt 0000000A
Jul 4 16:15:55 fcs1 T FCA_ERR4 Adapter link up failure
Jun 21 09:54:07 hdisk10 P SC_DISK_ERR7 path 4 path failure; WRITE(10) (0xLogical_Block_Address, <Transfer Length Value>) transport dead
Jun 21 09:54:07 fscsi3 T FCP_ERR4 Adapter driver rejected I/O request for port 0xSCSI_ID; ENETDOWN
May 10 04:13:48 fscsi0 I FCP_ERR10 Target port 0xSCSI_ID <WWPN#> has recovered
May 10 03:54:05 hdisk9 P SC_DISK_PCM_ERR8 path # path failure
May 10 03:35:10 fscsi0 T FCP_ERR14 NS GID_PN reject wwpn <WWPN#>; Port Name not registered
Apr 11 22:07:25 hdisk11 I SDDPCM_PATH_RECOVER Path ID 5
Apr 11 22:05:54 hdisk11 P SC_DISK_ERR7 path 5 path failure; WRITE(10) (0xLogical_Block_Address, <Transfer Length Value>) command timeout
Apr 11 22:04:31 hdisk11 T SC_DISK_ERR4 path 5 READ(10) (0xLogical_Block_Address, Transfer Length Value) transport fault
Apr 11 22:04:30 fscsi0 T FCP_ERR4 Error detected receiving from port 0xSCSI_ID (possible marginal link)
Mar 12 18:26:44 hdisk1 T SC_DISK_ERR9 path 6 WRITE(10) (0xLogical_Block_Address, <Transfer Length Value>) RESERVATION CONFLICT
Mar 12 18:26:42 hdisk1 P SC_DISK_ERR10 path 7 TEST UNIT READY RESERVATION CONFLICT
Feb 21 16:29:43 fscsi3 T FCP_ERR4 dynamic tracking failed for port 0xSCSI_ID; ENETDOWN
Feb 21 16:29:43 fscsi3 T FCP_ERR4 Relogin <NPIV Client WWPN#> to port 0xFFFFFC rejected; ENETDOWN
25 March 2020