C H A P T E R  8
Emulex HBA Test ( emlxtest )

emlxtest verifies the proper functioning of the Emulex LP10000 Dual and Single Port 2 Gigabyte Fibre Channel PCI host bus adapters (HBAs). The supported HBAs are 133 MHz PCI-X 2 Gigabyte Fibre Channel based on the Emulex LP10000-S (Amber-2r) and LP10000DC-S (Crystal-2r) HBAs, which are the single and dual channel versions of the Emulex LP10000 line of products.

emlxtest is supported on both Sun Ultra SPARC and x86 AMD64 architectures.

emlxtest must be performed as a standalone test. Ensure that no other tests are running at the same time as the emlxtest.

emlxtest Options

To reach the following dialog box, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system might not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.

FIGURE 8-1 emlxtest Test Parameter Options Dialog Box

The following table lists the test parameter options for emlxtest.

TABLE 8-1 emlxtest Options

emlxtest Options

Description

Online Selftest Evaluates the functionality of ISP hardware by performing the following tests:Transmit FIFO testReceive FIFO testSRAM testMisc. Register testsRun by default, but can be deselected.
Internal Loopback Test Performs internal loopback test within the host adapter ISP hardware at the interface. This test is done with data sourcing from the system memory and going to the system memory. The desired data pattern, transfer length, and iteration count can be selected with the test parameters menu. Run by default, but can be deselected.
External Loopback Test Performs an external loopback test. This test is performed with data sourcing from the system memory and going to the system memory. The desired data pattern, transfer length, and iteration count can be selected via the test parameters menu. This is an intervention test, because a loopback cable is needed from the transceiver to the receiver of the Emulex port when testing this port by itself. This subtest can also test the entire fibre channel loop when the loop is connected to the storage to be tested. Not run by default, but can be selected.
Loopback Iteration Count Sets the number of times to loop the internal 10-bit, internal 1-bit, and external loopback tests. Default value is 10.
Loopback Data Pattern Selects the data pattern to loop for the internal 10-bit, internal 1-bit, and external loopback tests. Default value is 0x7e7e7e7e.

emlxtest Test Modes

TABLE 8-2 emlxtest Supported Test Modes

Test Mode

Description

Connection Opens and closes the Emulex port.
Exclusive Performs the full set of tests.

emlxtest Command-Line Syntax

/opt/SUNWvts/bin/emlxtest standard-arguments
-x -v -o dev=device-name,run-connect=Yes|No,selftest=Enable|Disable,ilb=Enable|Disable,elb=Enable|Disable,lbfcount=iteration-count, lbfpattern=hex-pattern

The -x option must be used from the command line.

TABLE 8-3 emlxtest Command-Line Syntax

Argument

Description
dev=device-name The name of the device to test.
selftest=Enable|Disable Enables or disables the selftest command. Evaluates the functionality of the ISP hardware. Enabled by default.
ilb=Enable|Disable Enables or disables the internal test. Performs internal loopback test within the host adapter ISP hardware at the 1-bit interface. Enabled by default.
elb=Enable|Disable Enables or disables the external loopback test. The desired data pattern, transfer length, and iteration count can be selected on the test parameters menu. Requires a cable for this intervention test. Disabled by default.
lbfcount=iteration-count Controls the number of times the loopback test will run, for example, 100. Default value is 10.
lbfpattern=hex-pattern Lists the data pattern to loop, for example, 0x7E7E7E7E. Default value is 0x7E7E7E7E.
Note -

64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname, or the relative path to which you installed SunVTS. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to the "32-Bit and 64-Bit Tests" section of the SunVTS 5.1 Test Reference Manual (816-5145-10).