Command Reference Guide

274 Fabric OS Command Reference
53-1002746-01
fabricPrincipal
2
--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
0x02
Switch was principal prior to sending or receiving a build fabric (BF) request.
This value is generated by the switch to initiate a fabric reconfiguration. This
value should not be assigned.
0x3 - 0xFE
Priority value range. Choose a value in this range to indicate priority. Higher
numbers mean lower priority.
0xFF
Switch is not capable of acting as a principal switch. This is a user-defined
value. Use --enable with a new priority to revert to this condition.
-force | -f
Forces a fabric rebuild. This option is required when enabling principal switch
mode. This option is not valid with the --disable command.
--disable
Disables principal switch selection. This command resets the priority to the default
value 0xFE.
[-f] mode
Sets the principal switch mode. Specify 1 to enable principal switch mode. Specify
0 to disable principal switch mode. Optionally, use the -f operand to force a fabric
rebuild. Mode changes take effect when the fabric rebuilds. This operand is
optional.
EXAMPLES To enable a high fabric principal priority setting:
switch:admin> fabricprincipal --enable -p 0xff -f
Principal Selection Mode enabled (Activate in \
next fabric rebuild)
To disable the principal mode selection:
switch:admin> fabricprincipal --disable
Principal Selection Mode disabled
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