FAQ:Agent 18

When I run the agent it runs and then quits without staying around. Why?

Firstly, are you certain that this is what is happening?

The normal operation of the agent is to fork itself into the background, detaching itself from the controlling terminal so that it will continue running even when you log out, and freeing the command line for subsequent use. This looks at first sight as if the agent has died, but using 'ps' to show all processes should reveal that the agent is still running.

To prevent this behaviour (such as when attempting to debug the agent), you can start it with the '-f' flag. This suppresses the fork, and the agent will run as a 'normal' command. It's also often useful to use the '-Le' (or '-L') flag, to log messages to stdout.

On the other hand, if 'ps' shows that the agent is not running, then this is an error, and probably show that something went wrong in starting the agent up. Check the agent log file for any error messages, or run it with '-f -Le' and see what it reports.

One possible cause might be an existing agent (or some other process) that's already listening on the SNMP port. Trying to start a second agent will fail with an error about "opening the specified endpoint".

If you're starting the agent as a non-root user, then this may also fail with the very same error. By default, the agent (and trap handler) will attempt to listen on the standard SNMP port 161 (or 162 for the trap handler). These are defined as "privileged ports", and processes will need to be running as root in order to open them.

One way to tackle this is to start the agent as root, but use the -u option to switch to run as another user once the port has been opened. Alternatively, you can specify a different port to use instead. Anything greater than 1024 is available to non-root users. In this case, you'll also need to specify the same port when issuing client commands.

   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?