Blame README.agentx

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