nwmgr_apa man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

nwmgr_apa(1M)							 nwmgr_apa(1M)

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

SYNOPSIS

	      port/aggregate_instance}

       port/aggregate_instance]

	      port/aggregate_instance]

	      port/aggregate_instance}

	      aggregate_instance}

   Remarks
       The and commands are deprecated.	 These commands will be removed	 in  a
       future  HP-UX release.  HP recommends the use of replacement command to
       perform all network interface-related tasks.

DESCRIPTION
       The program is the unified command to administer all LAN and RDMA-based
       interfaces  of  HP-UX.  You can find general information about the com‐
       mand in the nwmgr(1M) manpage.  This manpage describes  as  applied  to
       the APA interfaces.

       The  subsystem  name  for APA interfaces is APA interfaces include link
       aggregates and failover groups configured in the system.

       The commands described here are for interactive administration of HP-UX
       APA interfaces.

       The  command can be used to display information (with the option, which
       is the default), to add ports to APA interfaces (with the  option),  to
       clear  APA  interfaces  (with the option), to modify settings (with the
       option), to rebalance the load among member links in a link  aggregate,
       reset  statistics  (with	 the  option), to obtain the usage information
       (with the option), and to diagnose link connectivity (with the option).

       port_instance refers to physical link PPA; aggregate_instance refers to
       link aggregate PPA or failover group PPA.

       Operations  other than require the authorization.  For more information
       about authorizations and Role-based Access Control, see rbac(5).

       The settings of the APA interface on the system can be saved to the and
       configuration  files  so	 that  these  settings will take effect across
       reboots.

       You can obtain output in each  case  in	either	human-readable	format
       (which  is the default) or in a script-friendly parse-able format (with
       the or option).

       The format for script-friendly output is	 described  in	the  nwmgr(1M)
       manpage.	  It  is  guaranteed  that any change in the scriptable output
       across releases will contain only additions.  The existing content will
       not  be	modified or deleted.  The content of human-readable format can
       change across releases though the changes can be expected to be	incre‐
       mental.

   Operations
       The command provides the following operations for the APA interface:

       Creates or adds ports to a mode link aggregate or mode failover group.

       Performs Critical Resource Analysis (CRA) on a link aggregate
	      or a failover group.

       Clears or deletes some ports from a link aggregate or a
	      failover group.

       Diagnoses or tests link connectivity.

	      The  argument currently supported by APA is: which specifies the
	      connectivity test to be performed for diagnostics.

       Gets or displays global attributes, or gets or displays the settings of
	      a physical port, a link aggregate, or a failover group.  This is
	      the default operation if none is specified.

       Displays help information.

       Resets statistics or rebalances the load among member
	      links  in	 a  link  aggregate.  Also  resets  the link aggregate
	      itself.

       Sets global attributes or sets the attributes of a
	      physical port or a link aggregate.

   Options
       In addition to operations, the following options are valid for APA:

       Specifies attributes for an operation.  For APA, use this with the  and
       operations.

	      See the section for valid attributes for APA interfaces.

       Specifies  the  target  interface  on which the operation is to be per‐
       formed.
	      If the target is a link aggregate or a failover  group,  is  not
	      needed.

	      For APA, the target interface is of the form: or

	      aggregate_instance
		   The	link  aggregate	 Physical Point of Attachment (PPA) or
		   failover group PPA.

	      port_instance
		   The PPA of an APA supported physical link.

       Specifies that the operation is to be performed on the current configu‐
       ration.
	      If neither nor is specified, the command defaults to implicitly.

       Forces the operation to be done.

       Specifies the configuration from which the operation will copy
	      data.

	      The argument currently supported by APA is:

       Specifies  the PPA of the target interface on which the operation is to
       be performed.

	      For APA, the target interface is of the form: aggregate_instance
	      or port_instance:

	      aggregate_instance
		   The link aggregate PPA or failover group PPA.

	      port_instance
		   The PPA of an APA supported physical link.

       Specifies the number of seconds between the sending of two test packets
       for
	      diagnostics.  Used with the diagnose operation.

       Specifies the number of frames to be sent for diagnostics.
	      Used with the diagnose operation.

       Specifies a generic target qualifier was used to specify a subsystem
	      specific target qualifier.

	      The arguments currently supported by  APA	 are  (link  aggregate
	      data  flow) for operation and (global APA attributes) for opera‐
	      tion.

       Specifies the target subsystem for the operation.
	      For APA subsystem, the option argument is always:

       Specifies that the operation must be performed on the saved  configura‐
       tion
	      (persistent store).

       Displays the output in script friendly format.

       Specifies that the operation applies to the statistics of the target.

       Specifies verbose output to display more detail.

       Displays statistics output counter for monitor mode in its full width
	      in one line even when it is more than the terminal width.

   Attributes
       Different  operations allow different attributes to be specified in the
       command line.  The following table describes the	 attributes  supported
       by for APA:

       The  column  lists the APA operations supported for the attribute.  The
       description of the attribute is in the third column.

       ──────────────────────────────────────────────────────────────────
       Attribute	   Commands  Description
       ──────────────────────────────────────────────────────────────────
       dead_count	   -a -g     Dead  Count.   Number  of	 polling
				     packets  to miss before considering
				     a port to be down.

				     Min: 2, Max: 65535	  Default: 3
       ──────────────────────────────────────────────────────────────────
       default_mode	   -g -s     (Global)	Default	   Port	   Mode.
				     Default  mode  of	every  port that
				     supports APA.   This  attribute  is
				     equivalent		 to	     the
				     HP_APA_DEFAULT_PORT_MODE  found  in
				     the configuration file.

				     Values:  LACP_AUTO,  FEC_AUTO, MAN‐
				     UAL, LAN_MONITOR.

				     Default: MANUAL.
       ──────────────────────────────────────────────────────────────────
       dest		   --diag    The MAC address of the  LAN  inter‐
				     face target.
       ──────────────────────────────────────────────────────────────────
       failover_policy	   -g	     The  policy  to  select active port
				     for the failover group.  The policy
				     could  be	cost-based  or priority-
				     based.  If all ports in a	failover
				     group  have  no  cost  defined, the
				     default failover policy  as  prior‐
				     ity-based is used.
       ──────────────────────────────────────────────────────────────────
       features		   -g	     Features.	 Supported  features  to
				     compare.  VLAN - Virtual LAN; CS4 -
				     Send  CKO	for IPv4; CS6 - Send CKO
				     for IPv6; CR4  -  Receive	CKO  for
				     IPv4; CR6 for Receive CKO for IPv6.
       ──────────────────────────────────────────────────────────────────
       gc		   -g -s     Group Capability.	A value used for
				     aggregating  ports	 using	FEC_AUTO
				     mode

				     Min: 0, Max: 65535	  Default: none.
       ──────────────────────────────────────────────────────────────────
       key		   -g -s     Key   value  used	for  aggregating
				     ports with LACP_AUTO mode

				     Min: 0, Max: 65535	  Default: 0
       ──────────────────────────────────────────────────────────────────

       lacp_sysid	   -g -s     (Global) LACP SYSID Mode.	How  APA
				     selects  the  LACP	 System	 ID when
				     LACP is started.  This attribute is
				     equivalent	 to the HP_APA_LACP_SYS‐
				     TEM_ID_MODE parameter found in  the
				     configuration file.

				     When  the	value is FIRST_APA_PORT,
				     the  LACP	System	ID  is	the  MAC
				     address  of the first APA supported
				     port.

				     When the value is	FIRST_LACP_PORT,
				     the  LACP	System	ID  is	the  MAC
				     address of the first up  port  that
				     starts LACP.

				     Values:		 FIRST_APA_PORT,
				     FIRST_LACP_PORT.		Default:
				     FIRST_APA_PORT.
       ──────────────────────────────────────────────────────────────────
       lacp_timeout	   -g -s     (Global)  LACP  Timeout.	The  bit
				     value of the LACP	Timeout	 bit  in
				     LACP  protocol  packet.   Refer  to
				     IEEE 802.3ad (LACP) standard.  This
				     attribute	 is  equivalent	 to  the
				     HP_APA_LACP_TIMEOUT parameter found
				     in the configuration file.

				     Values:  0	 (Slow Timeout), 1 (Fast
				     Timeout).	Default: 0.
       ──────────────────────────────────────────────────────────────────
       lb		   -a -g -s  Load  Distribution	 Algorithm   for
				     outbound data transfer.

				     Values:	    LB_MAC,	  LB_IP,
				     LB_HOT_STANDBY, LB_PORT.

				     Default: LB_MAC
       ──────────────────────────────────────────────────────────────────
       links		   -a -d     A list of PPAs of physical links or
				     link  aggregates (separated by com‐
				     mas) that are to  be  added  to  or
				     deleted  from  a  link aggregate or
				     failover  group.	Link   aggregate
				     PPAs  are allowed to be in the list
				     only when operating on  a	failover
				     group.
       ──────────────────────────────────────────────────────────────────
       mac		   -g	     MAC  Address  of  an APA interface.
				     The value is expressed as a  6-byte
				     hexadecimal number.
       ──────────────────────────────────────────────────────────────────
       max_linkaggs	   -g -s     (Global).	 Maximum  number of link
				     aggregates that can be  configured.
				     This attribute is equivalent to the
				     HP_APA_MAX_LINKAGGS  parameter   in
				     file.

				     Min: 5, Max: 50   Default: 50
       ──────────────────────────────────────────────────────────────────

       mode		   -a -g -s  Configuration  mode  for port, link
				     aggregate or failover  group.   For
				     the  -a operation, mode can only be
				     set to either MANUAL  or  LAN_MONI‐
				     TOR.   For	 the  -s operation, mode
				     can only be set for  physical  link
				     but   not	for  link  aggregate  or
				     failover group.

				     Values: LACP_AUTO,	 FEC_AUTO,  MAN‐
				     UAL, LAN_MONITOR.	Default: none.
       ──────────────────────────────────────────────────────────────────
       mtu		   -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	 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  cur‐
				     rently  in active use for aggregat‐
				     ing ports with LACP_AUTO mode.
       ──────────────────────────────────────────────────────────────────
       parent_ppa	   -g	     Parent Link Aggregate.
       ──────────────────────────────────────────────────────────────────
       pktsize		   --diag    Payload size  (in	bytes)	of  each
				     test frame.

				     Min:   1,	 Max:  MTU-3	Default:
				     MTU-3.
       ──────────────────────────────────────────────────────────────────
       poll_interval	   -a  -g    Polling Interval.	Time interval in
				     seconds between two polling packets
				     are  sent.	  The  interval	 may  be
				     expressed as a decimal value.

				     Min:  0.5,	 Max:  2147.0	Default:
				     10.0.
       ──────────────────────────────────────────────────────────────────
       port_cost	   -a -g -s  Port's cost.   A  value  chosen  to
				     reflect  the  efficiency for a port
				     to carry traffic.	The lower  cost,
				     the more efficient is the port.

				     Min: 1, Max: 100	Default: none.
       ──────────────────────────────────────────────────────────────────
       port_pri		   -a -g -s  Port's  priority.	An integer value
				     greater or equal to 0.  The  higher
				     the  value, more preferred the port
				     is.

				     Min: 0, Max: 255	Default: none.
       ──────────────────────────────────────────────────────────────────
       rapid_arp	   -a -g     Rapid ARP.	  Flag	to  indicate  if
				     gratuitous	 ARP  packets  are to be
				     sent per  rapid  ARP  interval  and
				     count settings when the mac_address
				     of failover groups changing.

				     Values: on, off.  Default: on.
       ──────────────────────────────────────────────────────────────────

       rapid_arp_count	   -a -g     Rapid ARP Count.  Number  of  rapid
				     gratuitous ARP packets to send.

				     Min: 5, Max: 60   Default: 10.
       ──────────────────────────────────────────────────────────────────
       rapid_arp_interval  -a -g     Rapid ARP Interval.  Number of sec‐
				     onds  (in	decimal)   between   the
				     transmission  of  rapid  gratuitous
				     ARP packets.

				     Min: 1.0, Max: 4.0	  Default: 1.0.
       ──────────────────────────────────────────────────────────────────
       speed		   -g	     Speed and Duplex.	Actual speed and
				     duplex  values  of	 the  interface.
				     For speeds between 10 and 100 Mb/s,
				     it	 is  displayed in units of Mb/s.
				     For speed greater or equal to 1000,
				     it is displayed in units of Gb/s.
       ──────────────────────────────────────────────────────────────────
       sys_pri		   -g -s     LACP Port System Priority LACP sys‐
				     tem priority gives control	 to  the
				     system  to resolve standby ports to
				     be added in a link aggregate.

				     Min: 0, Max: 65535	  Default: none.
       ──────────────────────────────────────────────────────────────────
       timeout		   --diag    Specify the number	 of  seconds  to
				     wait  for	the  acknowledgement  of
				     each test frame.

				     Min: 1, Max: none	  Default: 2
       ──────────────────────────────────────────────────────────────────
       vmtu		   -g	     Virtual MTU for the link.
       ──────────────────────────────────────────────────────────────────

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

   Display Network Interfaces
	      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

	      This  command  creates  a mode link aggregate with PPA of aggre‐
	      gate_instance.

	      The attribute specifies a list of port instance  numbers	(sepa‐
	      rated by commas) for the ports.  Only the PPAs of physical ports
	      can be specified when creating a link aggregate.

	      Optionally, the load balancing algorithm of the  link  aggregate
	      can  be  specified using the attribute.  If it is not specified,
	      the link aggregate's current load balancing algorithm is used.

	      The option is ignored when creating a mode link aggregate.

	      When adding ports to an existing mode link aggregate, the ports'
	      mode  can be either or if some ports are in mode, either specify
	      or use the option to explicitly change ports' mode.

	      After the link aggregate is created,  its	 attribute  (in	 other
	      words, cannot be changed.

	      Refer  to	 the section for details regarding the attributes sup‐
	      ported by the operation.

   Creating a LAN_MONITOR Failover Group

	      This command creates a failover group using the ports  specified
	      in  the  PPA  list.   When  creating  a failover group, a set of
	      attributes may  be  defined  to  specify	the  behavior  of  the
	      failover group:

	      See the section for information about these attributes.

	      and  are	used  to  determine which port is the active port in a
	      failover group; has precedence over The lower  the  cost	value,
	      the  more	 preferable.   The higher the priority value, the more
	      preferable.  If either or is specified,  the  number  of	values
	      must be the same as the number of ports specified in

	      When  creating  a failover group, if attribute is not specified,
	      then the first port's priority will be 5, others will be 3.   If
	      is  specified, 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 at

	      When adding ports to an existing failover group, if is not spec‐
	      ified,  the new port's priority value is set to the minimum pri‐
	      ority value of ports inside the failover group.  If the  is  not
	      specified,  the new port's cost value is set to the maximum cost
	      value of ports inside the failover 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  to  the  new
	      ports.

	      When  adding  ports to an existing failover group, the ports can
	      be in or mode.  If there are ports in mode,  either  specify  or
	      use the 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
	      option  may  be used to ignore these errors and force the opera‐
	      tion.  Use this option carefully as the health of the ports can‐
	      not be monitored.

   Creating an FEC_AUTO or LACP_AUTO Link Aggregate
       Step 1. On the target link aggregate, set the or so that the ports with
	       same or value will join it:

       Step 2: For each port that should join the same target link  aggregate,
	       set or value that is same as that used in Step 1.  Also set the
	       to the intended AUTO mode.

	      This series of commands creates a or a link aggregate.

	      For a link aggregate, you must specify the value.

	      For a link aggregate, you must specify the value.	 The attribute
	      is the abbreviation of

	      The  or attribute indicates the ability of a physical LAN inter‐
	      face to aggregate together with other physical LAN interfaces to
	      from a link aggregate in the corresponding mode.	The first com‐
	      mand sets the value of the link aggregate, and  optionally,  the
	      load balancing algorithm used by the aggregate.  After the 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 value and to start the protocol on the port.  For a  port
	      to  join	the  link aggregate, its value must match the value of
	      the link aggregate.

	      When the option is used, the command output will	be  terse;  it
	      can be processed by a text processing utility.

   Clearing a Link Aggregate or a Failover Group

	      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 inter‐
	      face), the operation will fail  with  an	error  of  Information
	      describing  the  interface  as a critical resource is displayed.
	      To override the critical resource error, use the	option.	  How‐
	      ever,  when  the	interface  is  a system critical resource, the
	      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

	      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 option.  Use the 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 clear‐
	      ing of the link aggregate.

	      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 crit‐
	      ical resource, the delete operation fails with an exit  code  of
	      Information  describing  the interface as a critical resource is
	      displayed.  To override this error, use  the  option.   However,
	      when the interface is a system critical resource, the option has
	      no effect.

   Set APA Attributes to a Port or Link Aggregate Interface

	      This command updates the port/aggregate attribute to  the	 value
	      user  specified.	 You  can  update multiple attributes with one
	      command invocation.  Those attribute values that are valid  will
	      be  set  for  the	 link  aggregate  or  APA port instance.  Some
	      attributes are only applicable to APA  ports  while  others  may
	      only be applicable to link aggregates.

	      For  each	 attribute on which an error is reported, the APA dis‐
	      plays the reason the attribute cannot be set.  See  the  section
	      for the attributes compatible with the command.

   Save Global APA Attributes to APA Configuration Files

	      This  command  writes the values of APA global attributes to the
	      configuration file.  Multiple attributes can be  passed  to  the
	      same command.

	      When  an	attribute  value  is  not  valid, the attribute is not
	      updated in the configuration file.  Only those that  passed  the
	      validation will be updated.

	      The  new	value  for  a  APA  attribute overrides its previously
	      defined value.  However, the new attribute  value	 takes	effect
	      only after the system is rebooted.  See the section for informa‐
	      tion on the APA attributes.

   Save all the current APA configuration to the APA configuration Files

	      This command saves all the settings made by the user to the  APA
	      configuration  files.  All current APA port attribute values are
	      saved to the file.  The current link aggregate configuration and
	      the  related  link  aggregate  attribute values are saved to the
	      file.  The current failover group configuration and the  related
	      attribute values are saved to the file.

	      The information saved to the configuration files allows the cur‐
	      rent APA system configuration to be recreated after  the	system
	      is rebooted.

   View All APA Interfaces

	      This  command  displays  all  APA	 interfaces.  Note that is the
	      default operation.  The option displays all APA  interfaces  and
	      physical LAN interfaces that support APA.

	      The  form	 without the verbose option displays a table, with one
	      row for each interface that gets listed.

   View All or Selected Attributes of an APA or a Physical LAN Interface

	      port/aggregate_instance}

	      This command displays all attributes or selected	attributes  of
	      an APA or physical LAN interface.	 Use commas to separate multi‐
	      ple attributes.  When you specify all attributes are  displayed.
	      See the section for a list of valid attributes.

   View All or Selected Global APA Attributes

	      This  command  displays all global attributes or selected global
	      attributes.  Use commas to separate multiple  attributes.	  When
	      you specify all APA global attributes are displayed.  With spec‐
	      ified in command line, current APA global	 attributes  saved  in
	      kernel are displayed.

	      With  the specified in command line, APA global attributes saved
	      in the configuration file are displayed.	See the section for  a
	      list of valid attributes.

   View APA Interface Statistics

	      aggregate_instance}

	      This  command  displays  the MIB statistics of a link aggregate.
	      This command is equivalent to the command.

   View APA Interface Statistics in Monitor Mode

	      This command displays the MIB statistics of a link aggregate  in
	      its  monitor mode, that is, displays the statistics continuously
	      using default or user specified interval	time  period  for  the
	      number  of  iterations  specified.  The statistics also includes
	      that of the member ports of  the	link  aggregate.  The  default
	      counter  option is packet and the default value option is delta.
	      If no interval value is specified, the default value is  1  sec‐
	      ond,  and	 if no iteration value is specified, the default value
	      is 0, which means monitor indefinitely.

   Reset the MIB Statistics of an APA Interface

	      To have the statistics reset on a	 link  aggregate  or  failover
	      group, do the above command.

       This command cannot be used to reset the statistics of a link aggregate
       inside a failover group.	 In this case, returns

   Rebalance the Load Among Member Links in a Link Aggregate
	      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
	      This command resets a link aggregate or failover group.

   Perform Critical Analysis (CRA) on an APA Interface

	      The output from this command is a criticality report  describing
	      the system resource that depends on the APA interface.  When the
	      option is supplied, the command output is in a form that can  be
	      parsed by a text processing utility.

   Diagnose Link Connectivity

	      This  command  performs  connectivity test on the APA interface.
	      The keyword specifies that a linkloop test is to	be  performed.
	      Currently,  the APA diagnostics command only supports this test.
	      This test requires a working LAN interface to which  the	inter‐
	      face  under  test	 will send test packets.  The option specifies
	      the amount of the time between the sending of two test  packets.
	      The option specifies the number of packets to pass for the test.

RETURN VALUES
       The APA command returns the following:

	0   On success.
       >0   On failure.	 See the section for a list of error return values.

ERRORS
       Operation or attribute is not supported.

       One or more of the attributes or options is invalid for the task.

       One or more attribute is invalid for the task because its value
		      is  out-of-range,	 or the target instance is larger than
		      the maximum instance number that can support APA.

       The target interface could not be accessed,
		      or there is no valid port specified in  attributes  when
		      trunking.

       Number of ports specified in attribute
		      is too great.

       Port specified in attribute
		      is  not  available  for  trunking	 because it is already
		      inside some aggregate, or is running auto negotiation.

       The target or port is not accessible.
		      Some reasons are: some port is used  by  other  applica‐
		      tions  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.

       Memory allocation failed.

EXAMPLES
       To create a mode link aggregate using ports and with the load balancing
       algorithm:

       To  create  a cost-based failover group using link aggregates and is to
       have a cost of 2 and priority of 9, cost of 3 and priority 8:

       To create a link aggregate with	the  load  balancing  algorithm	 being
       using ports 3 and 4:

       To clear a link aggregate

       To delete Port 1 from link aggregate

       To update the value to and value to to the APA configuration file.  The
       new values to take effect after reboot.

       To update the (Group Capability) value of port to 100 and value of port
       to 200 (in scriptable output):

       To update the attribute to 3, and attribute to 10 of link aggregate The
       link aggregate is currently inside a failover group

       To list all LAN interfaces in the system.

       To list all APA interfaces in the system.

       To display the speed and MTU of the APA interface

       To display all attributes of the APA interface

       To display the MIB statistics of link aggregate in  monitor  mode  with
       default options:

       To  display  the MIB statistics of a link aggregate in monitor mode for
       throughput:

       To reset the MIB Statistics of failover group

       To rebalance the load of ports in link aggregate

       To check the connectivity of link aggregate lan901 to a	lan  interface
       having  the MAC address of 0x001279436B3D using the test packet of size
       512.  Do the test 50 times, sending a test packet every 2 seconds:

       To display Critical Resource Analysis of the APA interface

       To display Critical Resource Analysis of the APA interface with	output
       in scriptable format.

       To display help for all APA operations in terse mode.

       To display help for all APA operations in verbose mode.

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 ...	│
       │				  │	 -A mode=LAN_MONITOR -I agg_PPA │
       │				  │	 -S apa				│
       │				  │					│
       │lanadmin -X -l LB_MAC agg_PPA	  │ nwmgr -s -A lb=LB_MAC,gc=456	│
       │lanadmin -X -g agg_PPA 456 900	  │	 -I agg_PPA -S apa		│
       │				  │					│
       │lanadmin -X -g port_PPA 456 900	  │ nwmgr -s -A mode=FEC_AUTO,gc=456	│
       │lanadmin -X -p port_PPA FEC_AUTO  │	 -I port_PPA -S apa		│
       │    900				  │					│
       │				  │					│
       │lanadmin -X -k agg_PPA 789 900	  │ nwmgr -s -S apa -A key=789		│
       │lanadmin -X -l LB_IP agg_PPA	  │	 -A lb=LB_IP -I agg_PPA		│
       │				  │					│
       │lanadmin -X -k port_PPA 789 900	  │ nwmgr -s -S apa -A key=789		│
       │lanadmin -X -p port_PPA LACP_AUTO │	 -A mode=LACP_AUTO -I port_PPA	│
       │    900				  │					│
       └──────────────────────────────────┴─────────────────────────────────────┘
       port_PPA is the instance number of a APA supported physical port.
	       agg_PPA	is the instance number of a link aggregate or failover
	       group.

   Commands to Remove  Ports  from  or	Unconfigure  Link  Aggregates/Failover
       Groups
       ┌─────────────────────────────┬─────────────────────────────────────────┐
       │   lanadmin/landeleteconf    │			nwmgr		       │
       ├─────────────────────────────┼─────────────────────────────────────────┤
       │lanadmin -X -c agg_PPA	     │ nwmgr -d -A links=all -I agg_PPA -S apa │
       │			     │					       │
       │landeleteconf -g lanagg_PPA  │ nwmgr -d -A links=all -c lanagg_PPA     │
       │			     │					       │
       │lanadmin -X -d ppa1 ppa2 ... │ nwmgr -d -A links=ppa1,ppa2, ...	       │
       │    agg_PPA		     │	    -I agg_PPA -S apa		       │
       └─────────────────────────────┴─────────────────────────────────────────┘
   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 │ nwmgr -s -A mode=MANUAL -I port_PPA │
       │    900			       │      -S apa			     │
       │			       │				     │
       │lanadmin -X -s port_PPA 10 900 │ nwmgr -s -A sys_pri=10 -I port_PPA  │
       │			       │      -S apa			     │
       └───────────────────────────────┴─────────────────────────────────────┘
       PPA  is	the  instance  number of a APA supported physical port or link
       aggregate.

   Commands to Display Attributes of Link Aggregates or Ports
       ┌──────────────────────────┬───────────────────────────────────────────┐
       │	lanadmin	  │		      nwmgr		      │
       ├──────────────────────────┼───────────────────────────────────────────┤
       │lanadmin -a agg_PPA	  │ nwmgr [-g] -A mac -c lanagg_PPA	      │
       │			  │					      │
       │lanadmin -s agg_PPA	  │ nwmgr [-g] -A speed -c lanagg_PPA	      │
       │			  │					      │
       │lanadmin -m -a -s agg_PPA │ nwmgr [-g] -A mtu,mac,speed -c lanagg_PPA │
       │			  │ nwmgr [-g] -A all -c lanagg_PPA	      │
       │			  │					      │
       │lanadmin -x -g PPA 900	  │ nwmgr [-g] -A gc -I PPA -S apa	      │
       │			  │					      │
       │lanadmin -x -i agg_PPA	  │ nwmgr [-g] -A all -c lanagg_PPA	      │
       │			  │					      │
       │lanadmin -x -k PPA 900	  │ nwmgr [-g] -A key -I PPA -S apa	      │
       │			  │					      │
       │lanadmin -x -l agg_PPA	  │ nwmgr [-g] -A lb -c lanagg_PPA -S apa     │
       │			  │					      │
       │lanadmin -x -p PPA	  │ nwmgr [-g] -A mode -I PPA -S apa	      │
       │			  │					      │
       │lanadmin -x -s PPA	  │ nwmgr [-g] -A sys_pri -I PPA -S apa	      │
       │			  │					      │
       │lanadmin -x -t PPA	  │ nwmgr [-g] -A port_pri -I PPA -S apa      │
       │			  │					      │
       │lanadmin -x -v agg_PPA	  │ nwmgr [-g] -v -c lanagg_PPA		      │
       └──────────────────────────┴───────────────────────────────────────────┘
   Commands to Get or Reset Statistics of Link Aggregates or Failover Groups
       ┌────────────────────┬─────────────────────────────────┐
       │     lanadmin	    │		   nwmgr	      │
       ├────────────────────┼─────────────────────────────────┤
       │lanadmin -g agg_PPA │ nwmgr -g --st mib -c lanagg_PPA │
       │		    │				      │
       │lanadmin -c agg_PPA │ nwmgr -r --st -c lanagg_PPA     │
       │		    │				      │
       └────────────────────┴─────────────────────────────────┘
   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 -h -v -S apa		     │
       │		       │ nwmgr -s -h -v -S apa		     │
       │		       │ nwmgr -a -h -v -S apa		     │
       │		       │ nwmgr -d -h -v -S apa		     │
       │		       │ nwmgr -r -h -v -S apa		     │
       └───────────────────────┴─────────────────────────────────────┘
COMPARISONS WITH THE LANSCAN COMMAND
   Command To List Interfaces and Their Attributes
       ┌───────────┬──────────────────────┐
       │ lanscan   │	    nwmgr	  │
       ├───────────┼──────────────────────┤
       │lanscan	   │ nwmgr [-g] -v -C lan │
       │lanscan -q │ nwmgr -S apa	  │
       └───────────┴──────────────────────┘
AUTHOR
       was developed by HP.

FILES
       Contains the saved (persistent) configuration for the APA  link	aggre‐
       gates.

       Contains	 the  saved  (persistent)  configuration  for the APA physical
       ports.

       Contains the saved (persistent) configuration for
	      failover groups.

SEE ALSO
       nwmgr(1M), apa(7).

       User manuals at
								 nwmgr_apa(1M)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net