HP StorageWorks 1606 Brocade Fabric OS Command Reference v6.3.0 (53-1001337-01 - Page 245

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 supported with the --enable command: -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. The valid range of priorities are 0x01 (low priority) to 0xff (high priority). This operand is optional and valid only with the --enable command. When the priority is not specified, the priority defaults to 0x01. -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. Fabric OS Command Reference 215 53-1001337-01