beautypg.com

Agautomapbalance – Dell POWEREDGE M1000E User Manual

Page 70

background image

38

Fabric OS Command Reference

53-1001764-02

agAutoMapBalance

2

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
F_Ports are remapped such that logins are balanced among the existing
Imports.