userapps/opensource/net-snmp/README.agentx

   1 This sub-group of the UCD agent is a 'mature beta' implementation of
   2 the AgentX agent extensibility protocol, as described in RFC 2741.
   3
   4   This is a reasonably full implementation, in as much as it
   5 supports all the protocol operations described in this document.
   6 The core functionality has received a reasonable amount of exposure,
   7 and is believed to be more or less stable in normal use.   It will
   8 now also handle the non-graceful termination of subagents - returning
   9 a 'genErr' error for three successive requests before unregistering
  10 the unresponsive subagent.
  11
  12   Note that the reverse is not true, and a subagent will not
  13 re-establish contact with a dead and resurrected master in the default
  14 configuration.  Putting the following line in your
  15 APPLICATION.conf file:
  16   agentxPingInterval 60
  17 will make the subagent try to ping the master every 60 seconds, and if
  18 the connection is deemed broken it'll try and reconnect to the master
  19 agent after that point (once every 60 seconds).
  20
  21   Similarly, a subagent will not be able to re-register in place of a
  22 defunct colleague until the master agent has received three requests
  23 for the dead connection (and hence unregistered it).
  24
  25   Some of the less frequently used features (index allocation,
  26 range registration, etc), have received less thorough testing,
  27 and may well not be fully functional.   Many of the omissions
  28 of the earlier release (Contexts, use of GetBulk, the AgentX MIB)
  29 are still missing from this version.
  30
  31 While the implementation is not yet suitable for mission-critical
  32 production systems, it should prove sufficiently reliable for
  33 general-purpose use.
  34
  35
  36   AgentX support is now included in the agent by default, but needs
  37 to be explicitly enabled before use.  (This *is* still beta code
  38 after all).  Activate this using by putting a line
  39
  40                 master  agentx
  41
  42 in the snmpd.conf file.  This support is also enabled automatically
  43 when the '-x' flag is given (to specify a different master AgentX socket),
  44 or when the agent is invoked as an AgentX subagent (i.e. via the name
  45 'agentxd' or with the '-X' flag).
  46
  47   See the main project web page for an examples of a simple stand-alone
  48 subagent.  (http://www.net-snmp.org/tutorial-5/toolkit/)
  49
  50
  51   Please report any problems experienced to the ucd-snmp-coders list.
  52
  53 Dave