HP Auto Port Aggregation Administrator's Guide HP-UX 11i v3 (766140-001, March 2014)

5 Using the nwmgr command
In addition to the preferred SMH GUI and TUI interfaces for configuring and managing HP APA,
HP-UX provides the nwmgr command for managing all LAN-based and IB-based network interfaces.
The nwmgr command serves as a single tool for performing all network interface-related tasks,
offering the functionality provided by the lanscan, lanadmin, linkloop, lanapplyconf,
and landeleteconf commands.
NOTE: The lanadmin, lanscan, and linkloop commands are deprecated. These will be
removed in a future HP-UX release. HP recommends that you use the nwmgr command to perform
all network interface-related tasks.
This chapter introduces the nwmgr command and discusses the following topics:
• “nwmgr overview” (page 41)
• “HP APA tasks and the nwmgr command” (page 41)
• “Task comparison with other LAN commands” (page 47)
nwmgr overview
The nwmgr command enables you to perform the following tasks that are not possible with the
legacy commands:
• Generate output in a form that scripts can parse with the --sc or -script option for most
command options. See “Displaying HP APA configuration information” (page 42) for an
example.
• Make changes persist across reboots with the --saved option. This saves changes to the
/etc/rc.config.d/hp_apaconf, /etc/rc.config.d/hp_apaportconf, and /etc/
lanmon/lanconfig.ascii files.
• Perform Critical Resources Analysis (CRA) of ports with the --cra. This displays any system
resource that depends on an APA interface.
• Add ports to an existing failover group with the with the -a option.
• Delete ports from a failover group with the -d option.
• Assign a fixed MAC address to link aggregates and failover groups.
Changes made using nwmgr are effective immediately and can be made to persist across reboots
by using the --saved option.
By default, nwmgr gets (displays) attributes of an interface (-g or --get option). Any example in
this manual that shows the getting of attributes does not explicitly show this option in the command
line.
HP APA is the apa subsystem. Use the nwmgr -h -S apa command to display a list of command
syntaxes for the APA subsystem.
For a complete description of the functionality available for administering HP-UX APA subsystems
using nwmgr, syntax, and examples, see nwmgr_apa(1M) and nwmgr(1M).
HP APA tasks and the nwmgr command
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)
nwmgr overview 41