Dell POWEREDGE M1000E - Manual (Page 267)

Fabric OS Command Reference 235
53-1001764-02
fabricPrincipal
2
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.
Note The execution of this command is subject to Virtual Fabric or Admin Domain restrictions that may
be in place. Refer to chapter 1, "Using Fabric OS commands" and Appendix A, "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.
Disables principal switch selection. This command resets the priority to the
default value 0xfE.
--
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.
0x00 Reserved. This value cannot be assigned.
0x01 Highest priority. This is a user-defined value.