Reference Guide

Brocade Fabric OS Command Reference 817
53-1004112-02
portPeerBeacon
portPeerBeacon
Sets the port peer beaconing to physically identify the interconnections between ports.
Synopsis portpeerbeacon --enable [slot/]port
portpeerbeacon --disable [slot/]port
portpeerbeacon --show -all
portpeerbeacon --help
Description Use this command to turn on or off the port peer beaconing to physically identify the interconnections between
ports.
Using this command, the administrator can turn on the beaconing on both ends of the link and physically search
the other switches or devices for the beacon pattern to find the peer port. The beaconing pattern is alternating
green and amber LEDs every 1.2 seconds.
In the case of the trunk ports, the entire trunk group will be beaconed. This command is supported for more than
one port or one trunk group. Newly added trunk ports are automatically included to beacon. Similarly, disabling the
portpeerbeacon on a trunk port disables beaconing on the entire trunk group.
Port peer beaconing is supported on N_Ports, E_Ports, EX_Ports, F_Ports, AE_Ports, and trunk ports. The
command is not supported on ICL ports.
Port peer beaconing is not supported if diagnostic tests are running on the port. Port peer beaconing is not
supported with spinFab and is mutually exclusive of all the diagnostic commands.
Port peer beaconing remain unaffected when a port or trunk group is disconnected, toggled, or disabled.
The portPeerBeacon command is one of the commands that controls 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 enables or disables beaconing on all ports in the chassis.
• The portPeerBeacon command enables or disables beaconing to identify the interconnections between ports.
The actions of the beaconing commands are independent and mutually exclusive except that the portPeerBeacon
command overrides the portBeacon settings on a port, but portBeacon does not override port peer beaconing on
a port. For example, if you enabled beaconing on the logical switch and you want to enable beaconing on the entire
chassis, you must first disable switch beaconing with the switchBeacon command before you can use the
chassisBeacon command to enable beaconing on the entire chassis. Likewise, 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.