FAQ:Agent 08

What's the difference between AgentX, SMUX and proxied SNMP?

All three are protocols that can be used to make two or more agents appear as one to the querying application. In each case, one agent takes the role of "master", and delegates requests to one of the others as and where this is appropriate. The differences between them mainly relate to how data is represented, and the mechanisms for communication between master and subagents.

SMUX and proxy SNMP both essentially use the standard SNMP packet format. The main difference is that a proxy SNMP subagent need not be aware that it is acting in such a role. It typically listens on a non-standard port, and simply receives requests as usual, forwarded from the master agent (rather than directly). The main issue to be aware of is that such requests will appear to come from the local host, and this may affect how the access control mechanisms need to be set up.

SMUX uses a similar packet format, but the subagent "registers" with the master agent, providing a suitable password. The Net-SNMP (and UCD) agent includes the possibility of acting as a SMUX master agent, but the suite does not include a subagent API. Note that support for SMUX is not included by default, and needs to be explicitly enabled by running:

               --with-mib-modules=smux

before re-compiling the agent.
See the file 'agent/mibgroup/README.smux' for details.

AgentX uses a more compact (and simpler) packet format, with a richer range of administrative commands, and provides a more flexible and reliable extension mechanism. The Net-SNMP agent can be used in both master and subagent roles, and the agent library can also be used to embed an AgentX subagent within another application. See the file 'README.agentx' for details.

AgentX support is included by default, but needs to be explicitly activated in the master agent. Do this by adding the line

               master agentx

to the snmpd.conf file before starting the agent.

   FAQ:Agent
   

1. What MIBs are supported?
2. What protocols are supported?
3. How do I configure the agent?
4. How do I remove a MIB from the agent?
5. I've installed a new MIB file. Why can't I query it?
6. How do I add a MIB to the agent?
7. What's the difference between 'exec', 'sh', 'extend' and 'pass'?
8. What's the difference between AgentX, SMUX and proxied SNMP?
9. What is the purpose of 'dlmod'?
10. Which extension mechanism should I use?
11. Can I use AgentX when running under Windows?
12. How can I run AgentX with a different socket address?
13. How can I turn off SMUX support?
14. How can I combine two copies of the 'mib2' tree from separate subagents?
15. What traps are sent by the agent?
16. Where are these traps sent to?
17. How can I send a particular trap to selected destinations?
18. When I run the agent it runs and then quits without staying around. Why?
19. After a while the agent stops responding, and starts eating CPU time. Why?
20. How can I stop other people getting at my agent?
21. How can I listen on just one particular interface?
22. The agent is complaining about 'snmpd.conf'. Where is this?
23. Why does the agent complain about 'no access control information'?
24. How do I configure access control?
25. How do I configure SNMPv3 users?
26. The 'createUser' line disappears when I start the agent. Why?
27. What's the difference between /var/net-snmp and /usr/local/share/snmp?
28. My new agent is ignoring the old snmpd.conf file. Why?
29. Where should the snmpd.conf file go?
30. Why am I getting "Connection refused"?
31. Why can't I see values in the UCDavis 'extensible' or 'disk' trees?
32. Why can't I see values in the UCDavis 'memory' or 'vmstat' tree?
33. What do the CPU statistics mean - is this the load average?
34. How do I get percentage CPU utilization using ssCpuRawIdle?
35. What about multi-processor systems?
36. The speed/type of my network interfaces is wrong - how can I fix it?
37. The interface statistics for my subinterfaces are all zero - why?
38. Does the agent support the RMON-MIB?
39. What does "klread: bad address" mean?
40. What does "nlist err: wombat not found" (or similar) mean?
41. What does "Can't open /dev/kmem" mean?
42. The system uptime (sysUpTime) returned is wrong!
43. Can the agent run multi-threaded?
44. Can I use AgentX (or an embedded SNMP agent) in a threaded application?