naaagt(1M)naaagt(1M)NAMEnaaagt - Native Agent Adapter (NAA)
SYNOPSIS
priority] logMask] ...
DESCRIPTION
The Native Agent Adapter allows third-party SNMP agents to work with
the HP SNMP Master Agent
The Native Agent Adapter runs as a subagent to the HP SNMP Master
Agent. reads the file (see the environment variable, described below),
and it registers each object identifier (OID) with See the section.
After registration is complete, receives SNMP requests from and for‐
wards them to a non-standard UDP port on the same system (see the envi‐
ronment variable, described below). also receives SNMP responses from
the third-party SNMP agent, which is listening to the non-standard UDP
port, and forwards the responses to
The third-party SNMP agent must listen to the same non-standard UDP
port that sends to 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 starting
Parameters
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.
Causes the Native Agent Adapter
to continue to run, even if the HP SNMP Master Agent
terminates. When subsequently restarts, will re-estab‐
lish communication with and re-register its OIDs. This
option is recommended if the procedure is used,
described below. By default, terminates automatically
when terminates.
Troubleshooting Parameters
Displays usage information.
Sets the logging mask.
may be one of the following names: or Multiple
logging options can be specified by repeating the
option. Logging data is written to the SNMP log
file, Default:
Causes to run in foreground. By default, 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.
The third-party SNMP agent and its Native Agent Adapter can be
started and stopped automatically during system start-up and
shutdown. This is accomplished by providing a start-up/shutdown
script under the directory, with symbolic links to it under an
appropriate directory. See the rc(1M) man page for details.
See the section for procedures for starting
The third-party SNMP agent and its Native Agent Adapter can be
started using the command by providing start-up and shutdown
scripts under Normally, those scripts are merely symbolic links
to the automatic start-up/shutdown script under following the
same naming conventions documented in the rc(1M) manual page.
These scripts are executed by the command. See the section for
procedures for starting
The third-party SNMP agent and its Native Agent Adapter can be
started by entering commands directly or by executing an arbi‐
trary script. When this approach is used, the option should
probably be used because the third-party agent and adapter will
not be restarted by the command.
The following procedure should be used to start for each third-
party agent.
· Export which must be set to a unique port number.
· Export which must be set to an absolute path name for
a third-party-specific file. Create the file; refer
to third-party documentation for a list of the OIDs
that are instrumented by the third-party SNMP agent.
· Export which must be set to the community name to be
used in SNMP requests forwarded from to the third-
party SNMP agent. This environment variable is
required only if the third-party agent is configured
to use a community name other than the default ("pub‐
lic").
· Create a unique symbolic link to This makes it conve‐
nient to distinguish each Native Agent Adapter in out‐
put from the command. Execute the symbolic link to
start
· Start the third-party SNMP agent, following procedures
in the third-party documentation. This can be done
before or after starting
naaCnf File Format
The file consists of a list of numeric object identifiers
(OIDs), one OID per line. Each OID is a subtree of MIB vari‐
ables that are instrumented by the third-party SNMP agent.
Refer to third-party documentation for the list of OIDs. Blank
lines and lines beginning with "#" are treated as comments.
Leading and trailing spaces on a line are ignored. The OID can
start with an optional period.
EXTERNAL INFLUENCES
Environment Variables
The absolute path name for the
file from which the Native Agent Adapter
reads the OIDs to be registered for its
third-party SNMP agent. Default (not
recommended):
The community name that the Native Agent Adapter
uses in SNMP requests forwarded to the
third-party SNMP agent. Note that this
does not have to match any community
names accepted by the SNMP Master Agent,
which are defined in This environment
variable is required only if the stan‐
dard community name ("public") is not
accepted by the third-party SNMP agent.
Refer to third-party documentation for
instructions regarding SNMP community
names. Default: public.
The non-standard UDP port number to which the Native Agent
Adapter
forwards SNMP requests to the third-
party SNMP agent. This must match the
port number that the third-party agent
listens to instead of the standard SNMP
port (161). Each third-party SNMP agent
must listen to a different non-standard
UDP port number. Default: 8161.
International Code Set Support
Supports single-byte character code sets except where the SNMP
protocol supports only 7-bit characters encoded in ASCII.
WARNINGS
The Native Agent Adapter only supports SNMP read requests (for
example, SNMP Get). SNMP Set requests must be sent directly to
the third-party SNMP agent's non-standard UDP port
If the value is not a valid port number, terminates without
writing any error message either to the display or to
If there are no valid OIDs in the file, terminates. It does not
register a default OID.
There may be unexpected results if the is outside the valid
range.
AUTHOR
was developed by SNMP Research and Hewlett-Packard Company.
FILES
Default file. Not recommended.
Directory for SNMP start-up and shutdown scripts.
Native Agent Adapter command.
HP SNMP Master Agent command.
HP SNMP log file.
SEE ALSOrc(1M), snmpd(1M), snmpd.conf(4).
naaagt(1M)