Brocade Fabric OS Command Reference Manual (53-1000240-01, November 2006)

Fabric OS Command Reference Manual 2-157

Publication Number: 53-1000240-01

fabricPrincipal

Note: Enter commands in lowercase only; mixed case is for readability.

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 will actually achieve 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.

ote

The execution of this command is subject to Admin Domain restrictions that may be in place.

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 with the 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, or 0 to disable principal switch mode (the mode activates

when the fabric rebuilds). This operand is optional.

Examples To display the current mode setting:

To disable the mode setting:

To enable the mode setting:

To enable the mode setting and force fabric rebuild: