Brocade Fabric OS Command Reference Guide v6.1.0 (53-1000599-02, June 2008)

134 Fabric OS Command Reference
53-1000599-02
fabricPrincipal
2
fabricPrincipal
Sets principal switch selection mode.
Synopsis fabricprincipal [-fhq] [mode]
Description Use this command to set principal switch selection mode for the switch.
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 achieves this status.
When dealing with larger 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 selection
of switches should be connected together first, followed by the addition of the rest of the fabric.
Note The execution of this command is subject to Admin Domain restrictions that may be in place. Refer
to chapter 1, "Understanding Admin Domain Restrictions" and Appendix A, "Command Availability"
for details.
Operands This command has the following operands:
-f Specify the -f option to force a fabric rebuild. This option is required when
enabling principal switch mode. This option is not valid when disabling
principal switch mode.
-h Specify the -h option to display command usage summary.
-q Specify the -q option to display the current mode state.
mode Specify 1 to enable principal switch mode. Specify 0 to disable principal
switch mode. Principal switch mode is activated when the fabric rebuilds.
This operand is optional.
Examples To display the current mode setting:
switch:admin> fabricprincipal -q
Principal Selection Mode: Enable
To disable the mode setting:
switch:admin> fabricprincipal 0
Principal Selection Mode disabled
To enable the mode setting:
switch:admin> fabricprincipal 1
Principal Selection Mode enabled
To enable the mode setting and force fabric rebuild:
switch:admin> fabricprincipal -f 1
Principal Selection Mode enabled (Forcing fabric rebuild)
See Also fabricShow