netmgr_apa.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nwmgr_apa(1M) nwmgr_apa(1M)

Virtual MTU for the link.vmtu -g

USAGE

The common usages of nwmgr for APA interfaces are described in this section.

Display Network Interfaces

nwmgr

The command without any arguments displays all the network interfaces on the system, including

physical LAN interfaces (NICs), virtual LAN interfaces (VLANs and APA aggregates), and RDMA-

based interfaces.

Creating a MANUAL Link Aggregate

nwmgr -a -A links=ppa1,ppa2,...

-A mode=MANUAL [ -A lb=lb_mode ]

{

-c lanaggregate_instance |

-I aggregate_instance }[

-f] -S apa

This command creates a MANUAL mode link aggregate with PPA of aggregate_instance.

The

links attribute speciﬁes a list of port instance numbers (separated by commas) for the ports.

Only the PPAs of physical ports can be speciﬁed when creating a

MANUAL link aggregate.

Optionally, the load balancing algorithm of the link aggregate can be speciﬁed using the

attri-

bute. If it is not speciﬁed, the link aggregate’s current load balancing algorithm is used.

The

-f option is ignored when creating a MANUAL mode link aggregate.

When adding ports to an existing

MANUAL mode link aggregate, the ports’ mode can be either

MANUAL or LAN_MONITOR, if some ports are in LAN_MONITOR mode, either specify -A

mode=MANUAL or use the -f option to explicitly change ports’ mode.

After the link aggregate is created, its attribute (in other words,

lb) cannot be changed.

You can set

fixed_mac and mac when you create the link aggregate. After the link aggregate is

created, you cannot change these attributes. The MAC address speciﬁed must be locally admin-

istered unicast MAC address. If the link aggregate already exists, the nwmgr command fails. In

this case, you cannot use the mac or fixed_mac attributes to add ports to the link aggregate.

Refer to the Attributes section for details regarding the attributes supported by the

-a operation.

Creating a LAN_MONITOR Failover Group

nwmgr -a -A links=ppa1,ppa2 ,... -A mode=LAN_MONITOR

[-A attr1=value1,attr2=value2,...] { -c lan aggregate_instance |-I

aggregate_instance }

[

-f] -S apa

This command creates a failover group using the ports speciﬁed in the links PPA list. When

creating a failover group, a set of attributes may be deﬁned to specify the behavior of the failover

group: dead_count, fixed_mac, mac, poll_interval

, port_pri, port_cost,

rapid_arp, rapid_arp_interval, rapid_arp_count

See the Attributes section for information about these attributes.

port_pri and port_cost are used to determine which port is the active port in a failover group;

port_cost has precedence over port_pri. The lower the cost value, the more preferable. The

higher the priority value, the more preferable. If either port_pri or port_cost is speciﬁed, the

number of values must be the same as the number of ports speciﬁed in links.

When creating a failover group, if attribute

port_pri is not speciﬁed, then the ﬁrst port’s priority

will be 5, others will be 3. If port_cost is speciﬁed, failover group’s failover policy will cost-

based; otherwise, the failover policy will be priority-based by default.

For details about priority-based and cost-based failover, see the HP Auto Port Aggregation

Administrator’s Guide at

http://www.hp.com/hpux-networking-docs.

When adding ports to an existing failover group, if

port_pri is not speciﬁed, the new port’s prior-

ity value is set to the minimum priority value of ports inside the failover group. If the port_cost

is not speciﬁed, the new port’s cost value is set to the maximum cost value of ports inside the fail-

over group.

After the failover group is created, its attributes cannot be changed. For example, its failover policy

cannot be changed from priority-based to cost-based by specifying

port_cost to the new ports.

HP-UX 11i Version 3: September 2010 − 7 − Hewlett-Packard Company 7