netmgr_apa.1m (2010 09)

n
nwmgr_apa(1M) nwmgr_apa(1M)
When adding ports to an existing failover group, the ports can be in
MANUAL or LAN_MONITOR
mode. If there are ports in MANUAL
mode, either specify -A mode=LAN_MONITOR
or use the -f
option to explicitly change ports’ mode.
A failover group should consist of two or more connected ports. If the connectivity tests fail, the
command terminates with an error. If only one port is specified in a command to create failover
group, the command also terminates with an error. The
-f option may be used to ignore these
errors and force the operation. Use this option carefully as the health of the ports cannot be moni-
tored.
You can set
fixed_mac and mac
when you create the failover group. After the failover group is
created, you cannot change these attributes. The MAC address specified must be a locally admin-
istered unicast MAC address. If the failover group already exists, the nwmgr command fails. In this
case, you cannot use the
mac or fixed_mac
attributes to add ports to the failover group.
Creating an FEC_AUTO or LACP_AUTO Link Aggregate
Step 1. On the target link aggregate, set the
gc or key so that the ports with same gc or key value will
join it:
nwmgr -s { -A gc=gc_value | -A key=
key_value }[-A lb=lb_mode ]
{
-c lanaggregate_instance |
-I aggregate_instance }
-S apa [--sc]
Step 2: For each port that should join the same target link aggregate, set
gc or key value that is same
as that used in Step 1. Also set the
mode to the intended AUTO mode.
nwmgr -s -A mode={FEC_AUTO|LACP_AUTO}
{-A gc=gc_value | -A key=key_value }
{ -c lanport_instance |
-Iport_instance } -S apa [--sc]
This series of commands creates a
FEC_AUTO or a LACP_AUTO link aggregate.
For a
LACP_AUTO link aggregate, you must specify the key value.
For a
FEC_AUTO link aggregate, you must specify the gc value. The gc attribute is the abbrevia-
tion of group_capability
.
The
gc or key attribute indicates the ability of a physical LAN interface to aggregate together with
other physical LAN interfaces to from a link aggregate in the corresponding mode. The first com-
mand sets the gc/key value of the link aggregate, and optionally, the load balancing algorithm
used by the aggregate. After the gc/key value is established on the link aggregate, for each port
that is to be in the link aggregate, enter the second command to set the port’s
gc/key value and to
start the
FEC_AUTO/LACP_AUTO protocol on the port. For a port to join the link aggregate, its
gc/key value must match the gc/key value of the link aggregate.
When the
--sc option is used, the command output will be terse; it can be processed by a text pro-
cessing utility.
Clearing a Link Aggregate or a Failover Group
nwmgr -d -A links=all
{ -c lanaggregate_instance | -I aggregate_instance }[
-f] -S apa
This command removes all the ports from a link aggregate or a failover group. If the APA interface
is a critical resource (another resource depends on the availability of the APA interface), the opera-
tion will fail with an error of [EBUSY]. Information describing the interface as a critical resource is
displayed. To override the critical resource error, use the -f option. However, when the interface
is a system critical resource, the -f option has no effect.
When clearing a link aggregate that is inside a failover group, the link aggregate will be removed
from its parent failover group.
Removing ports from an Aggregate Interface
nwmgr -d -A links=ppa1,ppa2,... { -c lanaggregate_instance | -I aggregate_instance }[-f] -S
apa [--sc]
This command removes some of the ports that are currently in a link aggregate or a failover group.
To delete all of the ports, specify the
-A links=all option. Use the links attribute to specify
the PPAs of the ports to be removed. If the PPAs of all the ports in the link aggregate are specified,
the behavior is the same as clearing of the link aggregate.
8 Hewlett-Packard Company − 8 − HP-UX 11i Version 3: September 2010