https://net-snmp.sourceforge.io/wiki/index.php?action=history&feed=atom&title=TUT%3AagentxtrapTUT:agentxtrap - Revision history2026-04-28T12:16:49ZRevision history for this page on the wikiMediaWiki 1.26.3https://net-snmp.sourceforge.io/wiki/index.php?title=TUT:agentxtrap&diff=4376&oldid=prevWes: initial cut.2010-06-17T21:24:14Z<p>initial cut.</p>
<p><b>New page</b></p><div>{{require|5.6}}<br />
<br />
[[AgentX]] is a master/sub-agent protocol that allows for notifications to be sent from a subagent to the master agent. The master agent will then retransmit that trap to all of its configured notification destinations.<br />
<br />
The '''agentxtrap''' application is designed to simulate a subagent that simply connects to a running snmpd that is running as a master agent and ask it to send a notification.<br />
<br />
For example, if in your [[snmpd.conf]] file you had:<br />
<br />
trapv2sink host1.example.com myCommunity<br />
trapsess tls:host2.example.com<br />
master all<br />
<br />
And then you ran:<br />
<br />
# '''agentxtrap linkUp.0'''<br />
<br />
It would cause snmpd to send a ''linkUp'' trap to both ''host1'' and ''host2''.<br />
<br />
== User Requirements ==<br />
<br />
By default, '''snmpd''' uses the ''/var/agentx/master'' unix socket to listen for AgentX connections on. Because this is a root-owned file you'll likely only be able to run '''agentxtrap''' as root, unless you set up different permissions using the [[agentxsocket]] and [[agentxperms]] config tokens. If you change this model, be careful as you only want trusted people to be able to send notifications from your agents.</div>Wes