 |
» |
|
|
|
The nwmgr command enables you to do the following tasks: Create (or add ports to) a link aggregate (--add option) Create (or add ports to) a failover group (LAN_MONITOR
mode) (--add option) Clear a link aggregate or failover group (--delete option) Remove ports from a link aggregate or failover group
(--delete option) Set APA attributes on a port or link aggregate interface
(--set option) Set global attributes to the HP APA configuration
files (--set option) Save the current HP APA configuration to the HP APA
configuration files (--saved option) View all APA interfaces (--get option,
the default) View all or specified attributes of an APA or physical
LAN interface View all or specified APA global attributes (-q global or -A attribute option, respectively) View APA interface statistics (--st option) Reset an APA interface (--reset option) Reset the MIB statistics for an APA interface (--reset option) Rebalance the load among member links in a link aggregate
(--reset option) Perform Critical Resource Analysis (CRA) on an APA
interface (--cra option) Diagnose link connectivity (--diag option)
You can set the following global attributes: default
port mode (default_mode), maximum number of link
aggregates on a system (max_linkaggs), LACP timeout
(lacp_timeout), and LACP System ID (lacp_sysid). You can also set the following attributes when
you create link aggregates or failover groups: dead count (dead_count), group capability (gc),
key (key), load distribution algorithm (lb), configuration mode (mode), polling
interval (poll_interval), port cost (port_cost), port priority (port_pri), rapid ARP (rapid_arp), rapid ARP count (rapid_arp_count), rapid ARP interval (rapid_arp_count), and system
priority (sys_pri). This section shows examples only for selected
operations. Displaying HP APA Configuration Information | |
The nwmgr command enables you to display configuration information
for all APA interfaces, for physical ports, and for global parameters. Example 5-1 shows the nwmgr command output when no options are specified. The output shows all
configured interfaces, both physical ports and link aggregates (beginning
with lan900). Example 5-1 nwmgr Output (No Options) # nwmgr
Name/ Interface Station Sub- Interface Related
ClassInstance State Address system Type Interface
============== ========= ============== ======== ============== =========
lan0 UP 0x00306EF3D258 intl100 100Base-TX
lan1 DOWN 0x00306EF34289 igelan 1000Base-T
lan2 UP 0x00306E250AD8 btlan 100Base-TX
lan3 UP 0x00306E250AD9 btlan 100Base-TX
lan4 UP 0x00306E250ADA btlan 100Base-TX
lan5 UP 0x00306E250ADB btlan 100Base-TX
lan10 UP 0x0010837BFC00 btlan 100Base-TX
lan11 UP 0x0010837BFC01 btlan 100Base-TX
lan12 UP 0x0010837BFC02 btlan 100Base-TX
lan13 UP 0x0010837BFC03 btlan 100Base-TX
lan6 UP 0x00306E5D2D5C iether 1000Base-SX
lan7 UP 0x00306E5D2D5D iether 1000Base-SX
lan8 UP 0x00306E5D2D6E iether 1000Base-SX
lan9 UP 0x00306E5D2D6F iether 1000Base-SX
lan900 DOWN 0x000000000000 hp_apa hp_apa
lan901 DOWN 0x000000000000 hp_apa hp_apa
lan902 DOWN 0x000000000000 hp_apa hp_apa
lan903 DOWN 0x000000000000 hp_apa hp_apa
lan904 DOWN 0x000000000000 hp_apa hp_apa |
For every nwmgr operation,
output is either in human-readable form (the default) or in a form
that scripts can parse (the --sc or -script option).
For example, getting the current configuration infromation for link
aggregate lan900 produces the following human-readable
output:
# nwmgr -c lan900
Class Parent APA Mode Load Membership
Instance PPA State Balancing
======== ====== ============ =========== ========= ==========
lan900 - Up LAN_MONITOR LB_HS 4,5 |
In contrast, the following command produces output
that scripts can parse: # nwmgr -c lan900 --sc
apa!lan900#parent_ppa#current# -
apa!lan900#apa_state#current#Up
apa!lan900#mode#current#LAN_MONITOR
apa!lan900#lb#current#LB_HS
apa!lan900#membership#current#4,5 |
The nwmgr command verbose output option
(-v) returns more information than the lanadmin command, and the information returned depends on the link aggregate
mode. The following example shows verbose output for the failover
group lan900: Example 5-2 nwmgr Command Verbose Output (Failover Group) # nwmgr -S apa -I 900 -v
lan900 current values:
Speed = 1 Gbps Full Duplex
MTU = 1500
Virtual Maximum Transmission Unit = 0
MAC Address = 0x00306EF2BADE
Network Management ID = 26
Features = Linkagg Interface 1
IPV4 Recv CKO
IPV4 Send CKO
VLAN Support
VLAN Tag Offload
64Bit MIB Support
Load Distribution Algorithm = LB_HS
Mode = LAN_MONITOR
Parent PPA = - 2
APA State = Up 3
Membership = 9,21,22,14,13* 4
Active Port(s) = 9 5
Ready Port(s) = 21,22,14 6
Not Ready Port(s) = 13 7
Connected Port(s) = 21,22 8
Polling Interval = 10000000
Dead Count = 3
Rapid ARP = on
Rapid ARP Interval = 1.0 second(s)
Rapid ARP Count = 10
Failover Policy = PRIORITY_BASED 9 |
| 1 | Supported features. For example, VLAN Support means the specified instance supports Virtual LAN and 64Bit
MIB Support means the specified instance supports 64-bit
MIB statistics. | | 2 | The instance value of the parent link aggregate. The hyphen
character (–) indicates there is no parent
link aggregate for the specified instance. | | 3 | One of the following states for the specified instance: - Up
The specified instance is up and running. - Down
The specified instance is in a down state. - Active
The specified instance is up, and is the active port
in its parent link aggregate. - Standby
The specified instance is up, and is ready to take
traffic in its parent link aggregate.
| | 4 | A list of the members of the specified link aggregate. In the
previous example, the values 9, 21, 22, 14, 13* mean lan9, lan21,
lan22, lan14, and lan13 are the member of the lan900. The asterisk
character (*) after 13 indicates lan13 is in a
down state. | | 5 | The active LAN instance in the specified link aggregate. If
there is traffic running through the link aggregate, the active port
is the instance sending and receiving network traffic. | | | |  | NOTE: If a link aggregate is a standby member of a failover group,
the active port is the port ready to take traffic. | | | | |
| | 6 | A list of the ready ports in the specified link aggregate. A
ready port is the instance ready to take traffic when the active port
is unavailable. When an active port is going down, an instance from
the Ready Port list is switched to the Active Port list as failover
occurs. This field is displayed only when the Mode is LAN_MONITOR. | | 7 | A list of the down ports in the link aggregate. In the previous
example, the Membership field indicates lan13 is in a down state and is also in the Not
Read Port(s) list. | | 8 | A list of the ports connected to the active port. This indicates
that polling packets are being sent successfully between the active
port and the connected port(s). This field is displayed only when
the Mode is LAN_MONITOR. | | 9 | The failover policy for the failover group. For a description
of failover policy, see “Failover Group” and “Preparing for Configuration”. The policy tells how active port
is selected. |
In contrast to the verbose option, the -A all option displays as much information as possible, independent of
the mode. Example 5-3 shows
the verbose option with all attribute values relevant to the LACP_AUTO
mode for the lan920. Example 5-4 shows the –A all option
with all attribute values relevant to the LACP_AUTO mode other information
for lan920. Example 5-3 nwmgr Verbose Output (Link Aggregate) # nwmgr -S apa -I 920 -v
lan920 current values:
Speed = 2 Gbps Full Duplex
MTU = 1500
Virtual Maximum Transmission Unit = 0
MAC Address = 0x00127942FC38
Network Management ID = 46
Features = Linkagg Interface
IPV4 Recv CKO
IPV4 Send CKO
VLAN Support
VLAN Tag Offload
64Bit MIB Support
Load Distribution Algorithm = LB_MAC
Mode = LACP_AUTO
Parent PPA = -
APA State = Up
Membership = 13,14
Active Port(s) = 13,14
Not Ready Port(s) = -
Key = 920
Operational Key = 920 |
Example 5-4 nwmgr All Attributes Output (Link Aggregate) # nwmgr -S apa -I 920 -A all
lan920 current values:
Speed = 2 Gbps Full Duplex
MTU = 1500
Virtual Maximum Transmission Unit = 0
MAC Address = 0x00127942FC38
Network Management ID = 46
Features = Linkagg Interface
IPV4 Recv CKO
IPV4 Send CKO
VLAN Support
VLAN Tag Offload
64Bit MIB Support
Load Distribution Algorithm = LB_MAC
Mode = LACP_AUTO
Parent PPA = -
APA State = Up
Membership = 13,14
Active Port(s) = 13,14
Not Ready Port(s) = -
Group Capability = 5
Key = 920
Operational Key = 920
Polling Interval = 0
Dead Count = 0
Rapid ARP = off
Rapid ARP Interval = 0.0 second(s)
Rapid ARP Count = 0
Failover Policy = - |
Creating a MANUAL Mode Link Aggregate | |
To create a MANUAL mode link
aggregate lan900 from ports lan1 and lan2, enter the following command: # nwmgr -a -A links=1,2 -A mode=MANUAL -I 900 -S apa
Addition of links 1, 2 to lan900 succeeded. |
Deleting an HP APA Interface | |
Before
attempting to delete an HP APA interface, ensure that there are no
applications or upper layer protocols active on the interface. Perform
a critical resource analysis operation on the interface, by entering: # nwmgr --cra -c lanaggregate_instance |
The --cra operation displays all applications
and commands currently assigned to the interface. To determine if
there are applications or commands running on lan900, enter the following: # nwmgr --cra -c lan900
CRA REPORT SUMMARY:
Critical Resources Analysis(CRA) reported SUCCESS.
No resources usages have been identified during the analysis. |
This shows no applications or commands on the interface. If the --cra operation indicates
no critical resources are assigned to the interface, delete the APA
interface with the following command: nwmgr –d –c lanaggregate_instance To delete lan900, enter: # nwmgr -d -A links=all -c lan900
Deletion of links all ports from lan900 succeeded. |
Resetting a Data Flow | |
To ensure that packets are transmitted in order, HP APA
uses the same data flow. For example, for the LB_MAC load balancing
algorithm, traffic between same source/destination MAC pair is always
sent through the same port. Traffic between this specific pair is
one data flow. See “Load Balancing” for a description of HP APA load
balancing. You might need to reset or clear the data flow
for a link aggregation, for example, when adding a new port to a link
aggregate. In this case, the data flow continues to use the same port;
no traffic is sent through the new port unless a new data flow is
created and mapped to that port. To reset a data flow, enter the following
command: # nwmgr -r -q data_flow -c lanaggregate_instance |
where aggregate_instance is the link aggregate instance number
(for example, 900, 901, ...). After you enter the command, HP APA regenerates
the data flow mapping; all ports are now eligible to carry traffic.
As a result, packets can be temporarily delivered out of order. Out
of order packets are handled by upper layer protocol (for example,
TCP/IP). |
Printable version
