Brocade Fabric OS Command Reference Manual - Supporting Fabric OS v5.3.0 (53-1000436-01, June 2007)

542 Fabric OS Command Reference Manual
53-1000436-01
portTest
2
portTest
Performs a functional test of a switch in a live fabric.
Synopsis porttest [-ports itemlist][-iteration count][-userdelay time][-timeout time][-pattern pattern]
[-patsize size][-seed seed][-listtype porttype]
Description Use this command to isolate problems to a single replaceable element and isolate problems to
near-end terminal equipment, far-end terminal equipment, or transmission line. Diagnostics can be
executed every day or on demand.
This command verifies the intended functional operation of the switch by sending frames from port
M's transmitter, and looping the frames back through an external fiber cable into port M's receiver,
thus exercising all the switch components from the main board, to the fiber cable, to the media (of
the devices and the switch), and back to the main board.
The cables and media connected should be of the same technology: a short-wavelength media
(switch) port is connected to another short-wavelength media (device) port using a
short-wavelength cable; a long wavelength port is connected to a long-wavelength port, and a
copper port is connected to a copper port.
Only one frame is transmitted and received at a time. The port LEDs flicker green while the test is
running.
The following port types are supported:
E_Ports
F_Ports (must support ELS Echo)
L_Ports
N->N loopback ports
This command will not run on any other port type.
The command performs the following actions:
Initiate tests on certain ports (portTest command).
Stop active tests on certain ports (stopPortTest command).
Get the snapshot of the test result (portTestShow command).
Once portTest is triggered, you can use stopPortTest to stop the test. Refer to the stopPortTest
command for more information.
View the current progress of portTest by running portTestShow. Refer to the portTestShow
command for more information.
If there is a port type change during portTest execution, the test will continue on a given port as
long as it can be supported and it is asked to do so. If a request was made to test all possible ports
on a given switch, portTest will start a new test using the new port type to start a appropriate test.
The execution of this command is subject to Admin Domain restrictions that may be in place.
Operands This command has the following operands:
-ports itemlist Specify a list of user ports to test. By default, all the user ports in the switch
are tested. Refer to itemList help pages for further details.