Command Reference Guide

622 Fabric OS Command Reference
53-1002746-01
portBeacon
2
portBeacon
Sets port beaconing mode.
SYNOPSIS portbeacon --enable [slot/]port
portbeacon --disable [slot/]port
portbeacon --show [slot/]port
portbeacon --help
DESCRIPTION Use this command to enable or disable beaconing mode on a specified port.
When beaconing mode is enabled on a port, the port LED flashes amber and green for 2.5 seconds each
in an alternating pattern. The beaconing mode continues until you turn it off. Beaconing mode is useful if
you are trying to locate a specific port.
Beaconing mode takes over the port LEDs. The normal flashing LED pattern associated with an active,
faulty, or disabled port is suppressed, and only the beaconing pattern is shown. Other commands are still
executable and functional. However, if diagnostic frame-based tests such as portLoopbackTest are
executed, the diagnostic LED pattern is interleaved with the beaconing pattern. Running switch
beaconing or HBA- side (E2E) beaconing also overwrites the pattern.
The portBeacon command is one of three commands that control beaconing. Each command has a
clearly defined scope of action:
• The portBeacon command enables or disables beaconing on a specified port.
• The switchBeacon command enables or disables beaconing on all ports in the current logical
switch.
• The chassisBeacon command to enables or disables beaconing on all ports in the chassis.
The actions of the beaconing commands are independent and mutually exclusive. Existing portBeacon
settings remain unaffected if you enable or disable beaconing on the switch or on the chassis. Failure to
disable existing beaconing commands before using a different type of beaconing may cause the
commands to interfere with each other in unexpected ways.
Issue the portBeacon --show [slot/]port command to display beaconing for a specific port. The
switchShow command displays the status of the switchBeacon command only.
NOTES The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may be in
place. Refer to Chapter 1, "Using Fabric OS Commands" and Appendix A, "Command Availability" for
details.
OPERANDS This command has the following operands:
slot
For bladed systems only, specifies the slot number of the port group to display,
followed by a slash (/).
port
Specifies the number of the port to be configured, relative to its slot for bladed
systems. Use switchShow for a listing of valid ports.
--enable
Enables beaconing mode on the specified port.
--disable
Disables beaconing mode on the specified port.