Porttest - Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base Command Reference Manual

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 in a single replaceable element and to trace problems to
near-end terminal equipment, far-end terminal equipment, or the transmission line. You can
perform this test on a daily basis or as needed to verify the persistence of a failure detected earlier.
This command verifies the functional operation of the switch by sending frames from a port's
transmitter, and looping the frames back through an external fiber cable into the port's receiver,
thus exercising all the switch components from the main board, to the fibre 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 type: a short-wavelength media (switch)
port should be connected to another short-wavelength media (device) port using a
short-wavelength cable; a long-wavelength port should be connected to a long-wavelength port,
and a copper port should be 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.
Only the following port types are supported:
•
•
•
•
This command performs the following operations:
1. Initiates tests on certain ports (portTest command).
2. Stops active tests on certain ports (stopPortTest command).
3. Takes a snapshot of the test result (portTestShow command).
Use the stopPortTest command to stop the test. Refer to the stopPortTest help page for more
information.
Use the portTestShow command to view the current progress of portTest. Refer to the
portTestShow help page for more information.
If there is a port type change during portTest execution, the test continues 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 ports on a given
switch, portTest starts a new test appropriate for the new port type.
Notes The portTest command does not run correctly on shared-area ports. Make sure that the list of
ports specified in the -ports parameter does not include shared-area ports.
On platforms that are enabled for Virtual Fabrics, this test can only be executed from the default
switch. Ports that are not on the default switch cannot be tested. Valid port connections for this test
are:
•
Fabric OS Command Reference
53-1001186-01
E_Ports
F_Ports (must support ELS Echo)
L_Ports
N->N loopback ports
From the default switch to legacy switches that do not support Virtual Fabrics.
2
portTest
661