naaagt(1M)																naaagt(1M)

NAME

       naaagt - 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 forwards 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-establish	communica-
		      tion with and re-register its OIDs.  This option is recommended if the procedure is used, described below.  By default, ter-
		      minates 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 documenta-
       tion 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	arbitrary  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 com-
       mand.

       The following procedure should be used to start for each third-party agent.

	      o  Export which must be set to a unique port number.

	      o  Export which must be set to an absolute path name for a third-party-specific file.  Create the file; refer to	third-party  docu-
		 mentation for a list of the OIDs that are instrumented by the third-party SNMP agent.

	      o  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
		 ("public").

	      o  Create  a  unique  symbolic link to This makes it convenient to distinguish each Native Agent Adapter in output from the command.
		 Execute the symbolic link to start

	      o  Start the third-party SNMP agent, following procedures in the third-party documentation.  This can be done before or after start-
		 ing

   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 variables 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
			       standard community name ("public") is not accepted by the third-party SNMP agent.  Refer to third-party	documenta-
			       tion 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 ALSO

       rc(1M), snmpd(1M), snmpd.conf(4).

																	naaagt(1M)