Brocade Fabric OS Command Reference Manual Supporting Fabric OS v6.3.0 (53-1001337-01, July 2009)

36 Fabric OS Command Reference

53-1001337-01

agAutoMapBalance

Controls automatic remapping of F_Ports in AG mode.

Synopsis agautomapbalance --enable [-fport | -nport] [-pg Port_Group_Number | -all]

agautomapbalance --disable [-fport | -nport] [-pg Port_Group_Number | -all]

agautomapbalance --force

agautomapbalance --show

agautomapbalance --help

Description Use this command to control the automatic rebalancing of F_Ports for login distribution in the event

that an F_Port goes offline or an N_Port comes online.

If automatic rebalancing is enabled, and an F_Port goes offline, the remaining F_Port logins are

redistributed across the existing N_Ports. Similarly if a new N_Port comes online, some of the

F_Port logins being routed through existing N_Ports would be failed over to the new N_Ports. Both

operations are potentially disruptive. Disabling automatic rebalancing of login distribution provides

a way of avoiding disruptions associated with routine F_Port/N_Port offline/online events.

The default values for agautomapbalance are as follows:

• Disable automatic login redistribution when F_Ports go offline.

• Enable automatic login redistribution when N_Ports come online.

Use the --show option to display the current configuration of the automatic rebalancing feature.

The command output varies depending on current AG policy settings:

• If Port Group Policy is enabled on the switch, the command displays the following information

for each configured port group:

PG_ID Port Group number

LB mode Login Balancing mode: enabled or disabled

nport Enabled or disabled

fport Enabled or disabled

• If Auto Policy is enabled on the switch, the command displays the status of the automatic

rebalancing feature per port type as either disabled or enabled.

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:

--enable Enables automatic login redistribution upon removal or addition of a

specified port type.

-fport Enables automatic login redistribution in the event that one or more F_Ports

go offline. When automatic login redistribution is enabled, the remaining

VE_Ports are remapped such that logins are balanced among the existing

Imports.