Blame README.agentx

Packit fcad23
  Net-SNMP contains a reasonably full implementation of the AgentX agent
Packit fcad23
extensibility protocol (RFC 2741) in as much as it supports all
Packit fcad23
the protocol operations described in this document.  The core
Packit fcad23
functionality has received a reasonable amount of exposure, and
Packit fcad23
is believed to be more or less stable in normal use.   It will
Packit fcad23
also handle the non-graceful termination of subagents - returning
Packit fcad23
a 'genErr' error for three successive requests before unregistering
Packit fcad23
the unresponsive subagent.
Packit fcad23
Packit fcad23
  A subagent will attempts to re-establish contact with a dead and
Packit fcad23
resurrected master based on the agentxPingInterval setting. The default
Packit fcad23
for this configuration variable is 15 seconds. It can be changed by
Packit fcad23
putting the following line in your APPLICATION.conf file:
Packit fcad23
Packit fcad23
                agentxPingInterval 60
Packit fcad23
Packit fcad23
will make the subagent try to ping the master every 60 seconds, and if
Packit fcad23
the connection is deemed broken it'll try and reconnect to the master
Packit fcad23
agent after that point (once every 60 seconds).
Packit fcad23
Packit fcad23
  Similarly, a subagent will not be able to re-register in place of a
Packit fcad23
defunct colleague until the master agent has received three requests
Packit fcad23
for the dead connection (and hence unregistered it).
Packit fcad23
Packit fcad23
  Some of the less frequently used features (index allocation,
Packit fcad23
range registration, etc), have received less thorough testing,
Packit fcad23
and may well not be fully functional.   Some of the omissions
Packit fcad23
of the earlier release (use of GetBulk, the AgentX MIB)
Packit fcad23
are still missing from this version.
Packit fcad23
Packit fcad23
  AgentX support is now included in the agent by default, but needs
Packit fcad23
to be explicitly enabled before use.  Activate it using by putting a line
Packit fcad23
Packit fcad23
		master	agentx
Packit fcad23
Packit fcad23
in the snmpd.conf file.  This support is also enabled automatically
Packit fcad23
when the '-x' flag is given (to specify a different master AgentX socket),
Packit fcad23
or when the agent is invoked as an AgentX subagent (i.e. via the name
Packit fcad23
'agentxd' or with the '-X' flag).
Packit fcad23
Packit fcad23
  See the main project web page for an examples of a simple stand-alone
Packit fcad23
subagent.  (http://www.net-snmp.org/tutorial/tutorial-5/toolkit/)
Packit fcad23
Packit fcad23
Packit fcad23
  Please report any problems experienced to the net-snmp-coders list.
Packit fcad23
Packit fcad23
Dave