HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

n
naaagt(1M) naaagt(1M)
NAME
naaagt - Native Agent Adapter (NAA)
SYNOPSIS
export HP_NAA_CNF=naaCnf
export HP_NAA_PORT=snmpPort
export HP_NAA_GET_COMMUNITY=
community
/usr/sbin/naaagt
[-K][-n][-E
priority ][-m logMask] ...
/usr/sbin/naaagt
{ -h | -help }
DESCRIPTION
The Native Agent Adapter (
naaagt) allows third-party SNMP agents to work with the HP SNMP Master
Agent (snmpdm).
The Native Agent Adapter runs as a subagent to the HP SNMP Master Agent.
naaagt reads the
naaCnf file (see the HP_NAA_CNF environment variable, described below), and it registers each object
identifier (OID) with snmpdm. See the naaCnf File Format section.
After registration is complete,
naaagt receives SNMP requests from
snmpdm and forwards them to a
non-standard UDP port on the same system (see the
HP_NAA_PORT environment variable, described
below). naaagt also receives SNMP responses from the third-party SNMP agent, which is listening to
the non-standard UDP port, and naaagt forwards the responses to snmpdm.
The third-party SNMP agent must listen to the same non-standard UDP port that
naaagt sends to
(HP_NAA_PORT), not the standard SNMP port number (161). Refer to third-party documentation for
instructions on how to accomplish this. The third-party SNMP agent can be started before or after start-
ing naaagt.
Parameters
-E priority Sets the registration priority. If two subagents register the same OIDs, requests are sent
to the subagent with the highest priority or to the subagent with the same priority that
was the last to register. The priority range is zero (high) to 255 (low). Default: zero.
-K Causes the Native Agent Adapter (naaagt) to continue to run, even if the HP SNMP
Master Agent (snmpdm) terminates. When snmpdm subsequently restarts, naaagt will
re-establish communication with snmpdm and re-register its OIDs. This option is recom-
mended if the
IndependentStart-up procedure is used, described below. By default,
naaagt terminates automatically when snmpdm
terminates.
Troubleshooting Parameters
-h
-help Displays usage information.
-m logMask Sets the logging mask. logMask may be one of the following names: APWARN, APER-
ROR, APTRACE, APALL,orAPNONE. Multiple logging options can be specified by repeat-
ing the -m option. Logging data is written to the SNMP log file,
/var/adm/snmpd.log. Default: APNONE.
-n Causes naaagt to run in foreground. By default, naaagt runs in the background.
Native Agent Adapter Start-up
The Native Agent Adapter start-up procedure may be provided by the vendor of the third-party SNMP
agent. Refer to third-party documentation for instructions.
Automatic Start-up
The third-party SNMP agent and its Native Agent Adapter can be started and stopped automatically dur-
ing system start-up and shutdown. This is accomplished by providing a start-up/shutdown script under
the
/sbin/init.d directory, with symbolic links to it under an appropriate /sbin/rcN.d directory.
See the rc(1M) man page for details. See the Independent Start-up section for procedures for starting
naaagt.
Manual Start-up
The third-party SNMP agent and its Native Agent Adapter can be started using the
/usr/sbin/snmpd
command by providing start-up and shutdown scripts under /sbin/SnmpAgtStart.d. Normally,
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1M−−485