netmgr_apa.1m (2010 09)

n
nwmgr_apa(1M) nwmgr_apa(1M)
This command restarts the load balancing on the member links of a link aggregate. This command
has no effect on failover groups.
Reset the Link Aggregate
nwmgr -r {-c lanaggregate_instance |
-I
aggregate_instance }
-S apa
This command resets a link aggregate or failover group.
Perform Critical Analysis (CRA) on an APA Interface
nwmgr --cra {-c lanaggregate_instance |
-I aggregate_instance}
-S apa [--sc]
The output from this command is a criticality report describing the system resource that depends on
the APA interface. When the
--sc option is supplied, the command output is in a form that can be
parsed by a text processing utility.
Diagnose Link Connectivity
nwmgr --diag [link] -A dest=target_mac [
-A timeout=seconds]
[
-A pktsize=number][--interval
seconds][--iterations count]
{
-c lanaggregate_instance |
-I aggregate_instance}
-S apa [--sc]
This command performs connectivity test on the APA interface. The
link keyword specifies that a
linkloop test is to be performed. Currently, the APA nwmgr diagnostics command only supports this
test. This test requires a working LAN interface to which the interface under test will send test
packets. The --interval (--int) option specifies the amount of the time between the sending of
two test packets. The --iterations (--it) option specifies the number of packets to pass for
the test.
RETURN VALUES
The APA
nwmgr command returns the following:
0 On success.
>0 On failure. See the ERRORS section for a list of error return values.
ERRORS
[ENOTSUP] Operation or attribute is not supported.
[EINVAL] One or more of the attributes or options is invalid for the task.
[ERANGE] One or more attribute is invalid for the task because its value is out-of-range, or the tar-
get instance is larger than the maximum instance number that can support APA.
[ENXIO] The target interface could not be accessed, or there is no valid port specified in attributes
links when trunking.
[E2BIG] Number of ports specified in attribute
links is too great.
[EALREADY] Port specified in attribute
links is not available for trunking because it is already
inside some aggregate, or is running auto negotiation.
[EBUSY] The target or port is not accessible. Some reasons are: some port is used by other appli-
cations when trunking, the Critical Resource Analysis failed when deleting ports, or the
target is inside some failover group when doing diagnostic test or resetting MIB statistics.
[ENOMEM] Memory allocation failed.
EXAMPLES
To create a
MANUAL mode link aggregate lan908 using ports lan1 and lan2, with the LB_PORT load
balancing algorithm:
nwmgr -a -A links=1,2 -A mode=MANUAL,lb=LB_PORT
-I 908 -S apa
To create a cost-based failover group lan900 using link aggregates lan908 and lan907. lan907 is to
have a cost of 2 and priority of 9, lan908 cost of 3 and priority 8:
nwmgr -a -A links=907,908 -A port_cost=2,3 -A port_pri=9,8 -A
mode=LAN_MONITOR -c lan900 -S apa
HP-UX 11i Version 3: September 2010 − 11 − Hewlett-Packard Company 11