netmgr_apa.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nwmgr_apa(1M) nwmgr_apa(1M)

NAME

nwmgr_apa: nwmgr - network interface management command for HP Auto Port Aggregation (APA)

SYNOPSIS

nwmgr

nwmgr -g -S apa [--sc]

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

-A mode={MANUAL|LAN_MONITOR}

[

-A attr1=value1,attr2=

value2,...]

{ -c lanaggregate_instance |

-I aggregate_instance }[

-f] -S apa

nwmgr -d -A links={ppa1,

ppa2,...|all}

{

-c lanaggregate_instance |

-I aggregate_instance }[

-f] -S apa [--sc]

nwmgr -s -A attr1=value1,

attr2=value2,...

{

-c lanport/aggregate_instance |

-I port/aggregate_instance }

-S apa [--sc]

nwmgr -s -A attr1=value1,attr2

=value2,... --sa -S apa [--sc]

nwmgr -s -A all --fr cu --sa -S apa

nwmgr -g

{-c lanport/aggregate_instance |

-I port /aggregate_instance}

-S apa [--sc]

nwmgr -g -v [-c lanport/aggregate_instance |

-I port /aggregate_instance]

-S apa

nwmgr -g {-q global | -A attr1/fP,attr2,...} [--cu][--sa

]

-S apa [--sc]

nwmgr -g -A all

[-c lanport/aggregate_instance |

-I port /aggregate_instance]

-S apa [--sc]

nwmgr -g -A attr1,attr2,...

{-c lanport/aggregate_instance |

-I port /aggregate_instance}

-S apa [--sc]

nwmgr -g --st [mib]

{-c lanaggregate_instance |

-I aggregate_instance} -S apa [--sc]

nwmgr -g --st monitor

[-q counter={{o|octet}|{p|packet}|{

t|throughput}} [:{y|phyerrs}]]

[

-q value={{c|current}|{d|delta}|{

r|rebased}}]

[

--wrap|--sc][--interval seconds][--iterations count]

{ -c lanaggregate_instance |

-I aggregate_instance }

-S apa

nwmgr -g --st monitor

[-q counter={p|packet}[:{t|throughput}]]

[-q value={d|delta}]

[--wrap|--sc][--interval seconds][--iterations count]

{ -c lanaggregate_instance | -I aggregate_instance }

-S apa

nwmgr -r { -c lanaggregate_instance | -I aggregate_instance }

-S apa

nwmgr -r --st { -c lanaggregate_instance | -I aggregate_instance }

-S apa

nwmgr -r -q data_flow

{ -c lanaggregate_instance | -I aggregate_instance } -S apa

nwmgr --cra { -c lanaggregate_instance | -I aggregate_instance }

-S apa [--sc]

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]

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

Summary of content (16 pages)

PAGE 1
nwmgr_apa(1M) nwmgr_apa(1M) NAME nwmgr_apa: nwmgr - network interface management command for HP Auto Port Aggregation (APA) SYNOPSIS nwmgr nwmgr -g -S apa [--sc] nwmgr -a -A links=ppa1,ppa2,... -A mode={MANUAL|LAN_MONITOR} [-A attr1 =value1 ,attr2 =value2 ,...] { -c lanaggregate_instance | -I aggregate_instance } [-f] -S apa nwmgr -d -A links={ppa1 ,ppa2,...| all} { -c lanaggregate_instance | -I aggregate_instance } [-f] -S apa [--sc] nwmgr -s -A attr1 =value1 ,attr2 =value2 ,...
PAGE 2
nwmgr_apa(1M) nwmgr_apa(1M) nwmgr -h [-g|-s|-r|-a|-d|--diag|--cra] -S apa [-v] Remarks The lanadmin, lanscan, and linkloop commands are deprecated. These commands will be removed in a future HP-UX release. HP recommends the use of replacement command nwmgr to perform all network interface-related tasks. DESCRIPTION The nwmgr program is the unified command to administer all LAN and RDMA-based interfaces of HPUX. You can find general information about the command in the nwmgr(1M) manpage.
PAGE 3
nwmgr_apa(1M) nwmgr_apa(1M) Options In addition to operations, the following options are valid for APA: -A | --attribute Specifies attributes for an operation. For APA, use this with the add, set, delete, get, and diagnose operations. See the Attributes section for valid attributes for APA interfaces. -c | --class_instance Specifies the target interface on which the operation is to be performed. If the target is a link aggregate or a failover group, -S apa is not needed.
PAGE 4
nwmgr_apa(1M) nwmgr_apa(1M) In addition, the quantity throughput can be displayed along with the packet counter, using counter values of p:t. However, with this counter value (p:t), the physerr value is not allowed. The value argument specifies how the quantities are to be displayed. The delta (default) displays the change in quantities since the previous display. The current displays the change in quantities since the last reset of the linkaggregate.
PAGE 5
nwmgr_apa(1M) gc nwmgr_apa(1M) -g -s Group Capability. A value used for aggregating ports using FEC_AUTO mode Min: 0, Max: 65535 Default: none. key -g -s lacp_sysid -g -s Key value used for aggregating ports with LACP_AUTO mode Min: 0, Max: 65535 Default: 0 (Global) LACP SYSID Mode. How APA selects the LACP System ID when LACP is started. This attribute is equivalent to the HP_APA_LACP_SYSTEM_ID_MODE parameter found in the /etc/rc.config.d/hp_apaconf configuration file.
PAGE 6
nwmgr_apa(1M) nwmgr_apa(1M) -g Maximum Transmission Unit. Maximum Ethernet payload size, in bytes. nmid -g Network Management ID of the link. norm_port_cost -g Normalized Port Cost. The value is calculated by dividing port_cost by the link’s speed. This is used by cost-based failover groups to choose the active port. The lower the normalized port cost, the more preferred the port. oper_key -g Operational Key. Key value currently in active use for aggregating ports with LACP_AUTO mode.
PAGE 7
nwmgr_apa(1M) vmtu nwmgr_apa(1M) -g Virtual MTU for the link. 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 RDMAbased interfaces. Creating a MANUAL Link Aggregate nwmgr -a -A links=ppa1,ppa2,...
PAGE 8
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.
PAGE 9
nwmgr_apa(1M) nwmgr_apa(1M) Critical resource analysis is done to determine whether the deletion of the ports will cause the link aggregate or a failover group to be a critical resource. If it becomes a critical resource, the delete operation fails with an exit code of [EBUSY]. Information describing the interface as a critical resource is displayed. To override this error, use the -f option. However, when the interface is a system critical resource, the -f option has no effect.
PAGE 10
nwmgr_apa(1M) nwmgr_apa(1M) This command displays all attributes or selected attributes of an APA or physical LAN interface. Use commas to separate multiple attributes. When you specify all, all attributes are displayed. See the Attributes section for a list of valid attributes. View All or Selected Global APA Attributes nwmgr [-g] {-q global | -A attr1 ,attr2 ,...} [--cu] [--sa] -S apa [--sc] This command displays all global attributes or selected global attributes.
PAGE 11
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.
PAGE 12
nwmgr_apa(1M) nwmgr_apa(1M) To create a LACP link aggregate lan901 (key=901) with the load balancing algorithm being LB_PORT using ports 3 and 4: nwmgr -s -A key=901,lb=LB_PORT -I 901 -S apa nwmgr -s -A key=901,mode=LACP_AUTO -I 3 -S apa nwmgr -s -A key=901,mode=LACP_AUTO -I 4 -S apa To clear a link aggregate 908: nwmgr -d -A links=all -I 908 -S apa To delete Port 1 from link aggregate 907: nwmgr -d -A links=1 -I 907 -S apa To update the max_linkaggs value to 40 and lacp_sysid value to FIRST_LACP_PORT
PAGE 13
nwmgr_apa(1M) nwmgr_apa(1M) nwmgr -h -S apa To display help for all APA operations in verbose mode. nwmgr -h -S apa -v COMPARISON WITH LANADMIN COMMAND Commands to Create Link Aggregates or Failover Groups lanadmin/lanapplyconf nwmgr lanadmin -X -a ppa1,ppa2, ... nwmgr -a -A links=ppa1,ppa2 ... agg_PPA -A mode=MANUAL -I agg_PPA -S apa lanapplyconf nwmgr -a -A links=ppa1,ppa2 ...
PAGE 14
nwmgr_apa(1M) nwmgr_apa(1M) Commands to Set the Attributes of Link Aggregates or Ports lanadmin nwmgr lanadmin -X -g PPA 345 900 nwmgr -s -A gc=345 -I PPA -S apa lanadmin -X -k PPA 456 900 nwmgr -s -A key=456 -I PPA -S apa lanadmin -X -l LB_IP agg_PPA nwmgr -s -A lb=LB_IP -c lanagg_PPA lanadmin -X -p port_PPA MANUAL 900 nwmgr -s -A mode=MANUAL -I port_PPA -S apa lanadmin -X -s port_PPA 10 900 nwmgr -s -A sys_pri=10 -I port_PPA -S apa Note: PPA is the instance number of a APA supported physical por
PAGE 15
nwmgr_apa(1M) nwmgr_apa(1M) Other Lanadmin Related Actions lanadmin nwmgr lanadmin -r agg_PPA nwmgr -r -c lanagg_PPA lanadmin -X -o agg_PPA nwmgr -r -q data_flow -c lanagg_PPA lanadmin -x -h 900 nwmgr -h -S apa nwmgr -g -h -v -S apa lanadmin -X -H 900 nwmgr nwmgr nwmgr nwmgr nwmgr -h -s -a -d -r -v -h -h -h -h -S -v -v -v -v apa -S apa -S apa -S apa -S apa COMPARISONS WITH THE LANSCAN COMMAND Command To List Interfaces and Their Attributes lanscan nwmgr lanscan nwmgr [-g] -v -C lan lanscan -q nw
PAGE 16
(Notes) A (Notes) nA 16 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010