|
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
|