doc/snmp.txt

   1 Asterisk SNMP Support
   2 ---------------------
   3
   4 Rudimentary support for SNMP access to Asterisk is available.  To build
   5 this, one needs to have Net-SNMP development headers and libraries on
   6 the build system, including any libraries Net-SNMP depends on.
   7
   8 Note that on some (many?) Linux-distributions the dependency list in
   9 the net-snmp-devel list is not complete, and additional RPMs will need
  10 to be installed.  This is typically seen as attempts to build res_snmp
  11 as net-snmp-devel is available, but then fails to find certain
  12 libraries.  The packages may include the following:
  13         * bzip2-devel
  14         * lm_sensors-devel
  15         * newt-devel
  16
  17 SNMP support comes in two varieties -- as a sub-agent to a running SNMP
  18 daemon using the AgentX protocol, or as a full standalone agent.  If
  19 you wish to run a full standalone agent, Asterisk must run as root in
  20 order to bind to port 161.
  21
  22 Configuring access when running as a full agent is something that is
  23 left as an exercise to the reader.
  24
  25 To enable access to the Asterisk SNMP subagent from a master SNMP
  26 daemon, one will need to enable AgentX support, and also make sure that
  27 Asterisk will be able to access the Unix domain socket.  One way of
  28 doing this is to add the following to /etc/snmp/snmpd.conf:
  29
  30         # Enable AgentX support
  31         master agentx
  32
  33         # Set permissions on AgentX socket and containing
  34         # directory such that process in group 'asterisk'
  35         # will be able to connect
  36         agentXPerms  0660 0550 nobody asterisk
  37
  38 This assumes that you run Asterisk under group 'asterisk' (and does
  39 not care what user you run as).