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