The ibhcatest
diagnostic test checks the functionality of the Sun Dual-Port 4x InfiniBand (IB) HCA PCI Express (PCIe) ExpressModule (EM). This test
can be run from the SunVTS user interface or from the command line. See the SunVTS 6.1 Test Reference Manual for more information about the
ibhcatest
test.
The Solaris 10 operating system provides SunVTS software and other diagnostic utilities for InfiniBand.
Updated versions of SunVTS software is released regularly. Check the Sun Download Center periodically for announcements of new releases and information about downloading the latest version of this tool.
The SunVTS software executes multiple diagnostic hardware tests from a single user interface, and is used to verify the configuration and functionality of most hardware controllers and devices. The SunVTS software operates primarily from a graphical user interface, enabling test parameters to be set quickly and easily while a diagnostic test operation is being performed.
Refer to the SunVTS documents in the following table for instructions on how to run and monitor the diagnostic software.
Title |
Descriptions |
---|---|
SunVTS 6.1 PS1 Documentation Supplement (Sun part number 819-1804) |
Describes the new SunVTS features and tests, including the |
SunVTS 6.1 User's Guide (Sun part number 817-7664) |
Describes the SunVTS diagnostic environment. |
SunVTS 6.1 Test Reference Manual (Sun part number 817-7665) |
Describes each SunVTS test and describes the various test options and command-line arguments. |
SunVTS 6.1 Quick Reference Card (Sun part number 817-7686) |
Provides an overview of the user interface. |
The ibhcatest
diagnostic test is included in the SunVTS 6.1 Patch Set 1 and subsequent SunVTS software releases. SunVTS 6.1 Patch Set 1 is available
for downloading from the SunSolve web site at SunSolve. Use the following patch number: patch 118961-01, or higher.
The adapter and Tavor device driver must be installed, and the IB port interface must be configured offline for the ibhcatest
to run. A loopback
cable is not needed because ibhcatest
includes an internal loopback test.
Use the following procedure to run ibhcatest
:
To ensure that the SunVTS software and the Tavor driver are installed on your system, enter the following command:
# pkginfo SUNWvts SUNWvtsx SUNWtavor
If a SunVTS software package is not installed, refer to the SunVTS 6.1 User's Guide for installation instructions.
To unplumb the interface from the system, enter the following command:
# ifconfig ibdn down unplumb
where n is the instance number of the interface.
Refer to SunVTS 6.1 PS1 Documentation Supplement for instructions on how to run ibhcatest
.
The following tasks can be useful when troubleshooting the IB EM and the link.
Enter the following command to verify that the InfiniBand software packages are installed on the host:
pkginfo -l | egrep “InfiniBand | Tavor | udapl”
Check that the following packages are installed:
SUNWib – Sun InfiniBand Framework
SUNWtavor – Sun Tavor HCA Driver
SUNWipoib – Sun IP over InfiniBand
SUNWudaplr – Direct Access Transport (DAT) registry package (root)
SUNWudaplu – Direct Access Transport (DAT) registry packages (usr)
SUNWudapltr – Service Provider for Tavor packages (root)
SUNWudapltu – Service Provider for Tavor packages
If an InfiniBand software package is not installed, check your Solaris Operating System documentation for software package information.
Check the system log or console for Tavor driver error messages.
See tavor(7D)
for error messages and descriptions. When the driver is attached to a port on the adapter, the following message is sent.
tavorn: port m up (link width 4x).
In the message, n is the instance of the Tavor device number and m is the port number on the adapter.
One way to check Tavor messages is by entering the following command:
# dmesg | grep tavor