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{net-snmp} software.
  13
  14 @menu
  15 * How to get net-snmp::
  16 * SMUX configuration::
  17 @end menu
  18
  19 @node How to get net-snmp, SMUX configuration, SNMP Support, SNMP Support
  20 @comment  node-name,  next,  previous,  up
  21 @section How to get net-snmp
  22
  23 net-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{net-snmp}.  The authors of net-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 net-snmp from @url{http://www.net-snmp.org/}.
  30
  31 To enable SMUX protocol support, please configure @command{net-snmp}
  32 like below.
  33
  34 @example
  35 % configure --with-mib-modules=smux
  36 @end example
  37
  38 After compile and install @command{net-snmp}, you will need to configure
  39 smuxpeer.  I'm now using configuration shown below.  This means SMUX client
  40 connects to MIB 1.3.6.1.6.3.1 with password test.
  41
  42 @example
  43 /usr/local/share/snmp/snmpd.conf
  44 ================================
  45 smuxpeer 1.3.6.1.6.3.1 test
  46 @end example
  47
  48 @node SMUX configuration,  , How to get net-snmp, SNMP Support
  49 @comment  node-name,  next,  previous,  up
  50 @section SMUX configuration
  51
  52 To enable SNMP support of Zebra, you have to configure Zebra with
  53 @command{--enable-snmp} (@pxref{Configure the Software}).
  54
  55 @deffn {Command} {smux peer @var{oid}} {}
  56 @deffnx {Command} {no smux peer @var{oid}} {}
  57 @end deffn
  58
  59 @deffn {Command} {smux peer @var{oid} @var{password}} {}
  60 @deffnx {Command} {no smux peer @var{oid} @var{password}} {}
  61 @end deffn
  62
  63 @example
  64 !
  65 smux peer .1.3.6.1.6.3.1 test
  66 !
  67 @end example