Dell POWEREDGE M1000E - Manual (Page 301)

Fabric OS Command Reference 273
53-1002746-01
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.
In principal switch, when you use -force option with priority, only the priority value given will get updated.
In this case, fabric rebuild will not occur and the switch remains as principal. Fabric rebuild will occur only
when the -force option is issued in the subordinate switch and the new principal switch will be selected
based on the priority. If you use the -f option, it always triggers build fabric (BF) request regardless of
whether switch is principal or subordinate.
NOTES 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.