Brocade Fabric OS Command Reference (Supporting Fabric OS v7.3.0) - Manual (Page 905)

Fabric OS Command Reference 875
53-1003131-01
portPeerBeacon
2
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
one port or trunk only. 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, F_Ports, and trunk ports. The command is not
supported on ICL ports.The command is not supported if a port is faulty or disabled.
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 is disabled when a port 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. 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.
To determine whether or not beaconing is enabled or disabled on the switch or chassis, use the
switchBeacon or chassisBeacon command without operands. A value of 0 indicates that the command
is disabled, a value of 1 indicates that the command is enabled. Issue the portBeacon --show -all
command to display beaconing status. The switchShow command displays the status of the
switchBeacon command only.