release/src/router/zebra/doc/snmp.texi

   1 @node SNMP Support, Zebra Protocol, Kernel Interface, Top
   2 @comment  node-name,  next,  previous,  up
   3 @chapter SNMP Support
   4
   5 SNMP (Simple Network Managing Protocol) is widely implemented feature
   6 for collecting network information from router and/or host.  Zebra
   7 itself does not support SNMP agent functionality.  But conjuction with
   8 SNMP agent, Zebra provides routing protocol MIBs.
   9
  10 Zebra uses SMUX protocol (RFC1227) for making communication with SNMP
  11 agent.  There are several SNMP agent which support SMUX.  We recommend
  12 to use the latest @command{ucd-snmp} software.
  13
  14 @menu
  15 * How to get ucd-snmp::
  16 * SMUX configuration::
  17 @end menu
  18
  19 @node How to get ucd-snmp, SMUX configuration, SNMP Support, SNMP Support
  20 @comment  node-name,  next,  previous,  up
  21 @section How to get ucd-snmp
  22
  23 ucd-snmp is a free software which distributed so called "as is" software
  24 license.  Please check the license which comes with distribution of
  25 @command{ucd-snmp}.  The authors of ucd-snmp are the University of
  26 California, the University of California at Davis, and the Electrical
  27 Engineering department at the University of California at Davis.
  28
  29 You can get ucd-snmp from @url{ftp://ucd-snmp.ucdavis.edu/}.  As of this
  30 writing we are testing with @command{ucd-snmp-4.1.pre1.tar.gz}.
  31
  32 To enable SMUX protocol support, please configure @command{ucd-snmp}
  33 like below.
  34
  35 @example
  36 % configure --with-mib-modules=smux
  37 @end example
  38
  39 After compile and install @command{ucd-snmp}, you will need to configure
  40 smuxpeer.  I'm now using configuration shown below.  This means SMUX client
  41 connects to MIB 1.3.6.1.6.3.1 with password test.
  42
  43 @example
  44 /usr/local/share/snmp/snmpd.conf
  45 ================================
  46 smuxpeer 1.3.6.1.6.3.1 test
  47 @end example
  48
  49 @node SMUX configuration,  , How to get ucd-snmp, SNMP Support
  50 @comment  node-name,  next,  previous,  up
  51 @section SMUX configuration
  52
  53 To enable SNMP support of Zebra, you have to configure Zebra with
  54 @command{--enable-snmp} (@pxref{Configure the Software}).
  55
  56 @deffn {Command} {smux peer @var{oid}} {}
  57 @deffnx {Command} {no smux peer @var{oid}} {}
  58 @end deffn
  59
  60 @deffn {Command} {smux peer @var{oid} @var{password}} {}
  61 @deffnx {Command} {no smux peer @var{oid} @var{password}} {}
  62 @end deffn
  63
  64 @example
  65 !
  66 smux peer .1.3.6.1.6.3.1 test
  67 !
  68 @end example