| SunVTS 6.2 Test Reference Manual for x86 Platforms
|
   
|
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.
|
Note - 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 test
- Receive FIFO test
- SRAM test
- Misc. Register tests
Run 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
|
Note - 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.
|
| SunVTS 6.2 Test Reference Manual for x86 Platforms
|
819-6456-10
|
|
Copyright © 2006, Sun Microsystems, Inc. All Rights Reserved.