dis_diag is diagnostic utility can be used to perform diagnostic of the local PCI Express network controller and network. It will report various events and situations as errors or warnings. dis_diag should on a well configured and functional network not report any errors or warnings.

dis_diag supports various options, please run dis_diag -h for details

[root@scox-2 ~]# dis_diag  -h
dis_diag version 5.2.0 ( Fri Jun 10 11:16:26 CEST 2016 )

Usage: dis_diag  [options]
Options:
   -help        This Help
   -v           Verbose output (Max)
   -n           Skip diagnostic. Print local configuration information
   -P           Skip probing of remote nodes / topology investigation
   -A           Skip use of dishosts.conf file. Probe all nodes.
   -a (adapter) Perform diagnostic only for selected adapter
   -V (level)   Verbose Level 0 - 9
   -clear       Clear IRM statistics only
   -noVer       Skip the driver version check
    
[root@scox-2 ~]# 

Below you will find an example running dis_diag with verbose level 9. We have added some comments to help explaining some of the details. A high level of PCIe chip knowledge is required to fully understand all details. If you have problems and need help, please send the output of dis_diag -V 9 to support.

[root@Dakar-A ~]# dis_diag -V 9
===========================================================================
      Dolphin diagnostic tool --  dis_diag version 5.2.0 ( Fri Jun 17 18:05:30 CEST 2016 )
===========================================================================

******************** VARIOUS INFORMATION              ********************

dis_diag compiled in 64 bit mode
Driver : Dolphin IRM (GX) 5.2.0.0 Jun 16th 2016 (rev  37746)
Date   : Fri Jul 15 04:11:50 CEST 2016
System : Linux Dakar-A 2.6.32-573.22.1.el6.x86_64 #1 SMP Wed Mar 23 03:35:39 UTC 2016
         x86_64 x86_64 x86_64 GNU/Linux


>>>> Version information both on the driver (release version and date, 
>>>> SVN revision), and Node software.


Number of configured local adapters found: 1

Hostbridge :  , 0x0

Adapter 0 > Type                       : PXH810
            NodeId                     : 4
            Serial number              : PXH810-CD-000103
            PXH chip family            : PLX_DRACO_2
            PXH chip vendorId          : 0x10b5
            PXH chip device            : 0x8717
            PXH chip revision          : 0xCA
            EEPROM version NTB mode    : 0007
            Card revision              : CD

>>>> Basic information on this Adapter. Multiple adapters can be shown for 
>>>> systems with more than one adapter. NodeId shows the NodeId of this 
>>>> Adapter.


            Topology type              : Direct 2 nodes
            Topology Autodetect        : No
            Number of enabled links    : 1
            PCIe slot state            : x8, Gen3 (8 GT/s)

>>>> Shows the connection the adapter has to the system - should match 
>>>> documentation.


            Clock mode slot            : Port
            Clock mode link            : Global
            Max payload size (MPS)     : 128
            Multicast group size       : 2 MB
            Prefetchable memory size   : 256 MB (BAR2)
            Non-prefetchable size      : 64 MB (BAR4)

>>>> Firmware-configurable settings for this adapter.


******************** PXH ADAPTER 0 LINK 0 STATE       ********************

            Link 0 uptime              : 2366245 seconds
            Link 0 state               : ENABLED
            Link 0 state               : x8, Gen3 (8 GT/s)

>>>> Shows the connection the adapter has to this fabric (other adapter/SBC or
>>>> switch/switchboard). Also shows the state of this link - here, enabled, 
>>>> and up for several days. For adapters supporting more than one link, the 
>>>> information is displayed pr link.

            Link 0 cable inserted      : 1
            Link 0 port active         : 1
            Link 0 configuration       : NTB


******************** PXH ADAPTER 0 STATUS             ********************

            Adapter state              : 1
            Chip temperature           : 0 C
            EEPROM init done           : 0


******************** PXH ADAPTER 0, PARTNER INFORMATION FOR LINK 0 ********************


            Partner adapter type       : PXH810
            Partner serial number      : PXH810-000112
            Partner link no            : 0
            Partner number of ports    : 1

>>>> Shows what the information collected from the other adapter/switch/
>>>> switchboard on this link.


******************** TEST OF ADAPTER 0                ********************

OK: PXH chip alive in adapter 0.
OK: Link alive in adapter 0.
==> Local adapter 0 ok.

******************** TOPOLOGY SEEN FROM ADAPTER 0     ********************

Adapters found: 2
----- List of all nodes found:

Nodes detected:   0004  0008


>>>> Lists NodeIds of nodes detected on this fabric. The NodeId of this node 
>>>> (configured above) should be present. Nodes expected to be reachable but 
>>>> missing will cause a warning to be displayed.