HP StorageWorks Fabric OS 5.X Command Reference Guide (AA-RVHVB-TE, September 2005)

186 Fabric OS commands
Sets principal switch selection mode.
Synopsis
fabricprincipal [-fhq][ mode ]
Availability
all users (display current setting)
admin (modify current setting)
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.
Operands
This command has the following operands:
Examples
To display the current mode setting:
To disable the principal selection mode setting:
To enable the principal selection mode setting:
fabricPrincipal
-f Specify the -f option to force a fabric rebuild. This option is
required when enabling principal switch mode. This option is
not valid when 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.
switch:admin> fabricprincipal -q
Principal Selection Mode: Enable
switch:admin> fabricprincipal 0
Principal Selection Mode disabled
switch:admin> fabricprincipal 1
Principal Selection Mode enabled