|
|
The Tiny Multi Agent Platform 6.2 (Default branch)
11-27-2008
tinyMAS is a multiagent platform that provides base concepts (such as kernel, message, yellow pages, white pages, and transport service) and extended concepts (such as environment, influence, and perception). It aims to provide an easy-to-understand and and easy-to-use platform dedicated for multiagent engineer/research courses. License: GNU Lesser General Public License (LGPL) Changes:|
|
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)