Using The Nwmgr Command; Nwmgr Overview; Hp Apa Tasks And The Nwmgr Command - HP -UX 11i v3 Administrator's Manual

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 49)
• "HP APA tasks and the nwmgr command" (page 49)
• "Task comparison with other LAN commands" (page 54)

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
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)
• 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)
"Displaying HP APA configuration information" (page 50) for an
nwmgr overview 49