Reference Guide

Brocade Fabric OS Command Reference 223
53-1004112-02
fabricPrincipal
fabricPrincipal
Sets the principal switch selection mode.
Synopsis fabricprincipal --help | -h
fabricprincipal [--show | -q]
fabricprincipal --enable
[ -priority | -p priority]
[-force | -f ]
fabricprincipal --disable
fabricprincipal [-f] mode
Description Use this command to set principal switch selection mode for a switch and to set priorities for principal switch
selection.
The implementation of the fabricPrincipal command is based solely on mechanisms specified in the Fibre
Channel standards. These mechanisms provide a preference for a switch requesting to be the principal switch in a
fabric, but they do not provide an absolute guarantee that a switch requesting to be the principal switch is granted
this status.
When dealing with large fabrics, the selection of the principal switch is less deterministic. In these cases, to help
ensure that the desired switch is selected as the principal switch, a small cluster of switches should be
interconnected first, followed by additional switches to enlarge the fabric.
Notes The execution of this command is subject to Virtual Fabric restrictions that may be in place. Refer to "Using Fabric
OS Commands" and "Command Availability" for details.
Operands This command has the following operands:
--help |-h
Displays the command usage.
--show
Displays the current mode setting and principal switch selection priority. This operand is
optional; if not specified, fabricPrincipal displays the same data as with the --show option.
-q
Displays principal mode only (enabled or disabled). This is a legacy command option that
does not display the priority settings.
--enable
Enables principal switch selection. The following operands are optional. If you do not
provide a priority value, the system assigns the default of 0x01 or generates a value based
on the switch state.
-priority | -p priority
Sets the principal selection priority of the switch. The specified priority value is used in the
principal switch selection protocol when the fabric rebuilds. Not all of these values can be
assigned.