README.snmp

   1 INSTALL
   2 -------
   3
   4 Installing the SNMP patch is straightforward:
   5
   6 $ tar -zxf freeradius-server-2.1.11.tar.gz
   7 $ cd freeradius-server-2.1.11
   8 $ patch -p1 < ../snmp.patch
   9 $ ./configure --args....
  10 $ make
  11 $ make install
  12
  13 MIB Installation
  14 ----------------
  15
  16 The traps *REQUIRE* that the files in the "mibs" directory be copied
  17 to the global mibs directory, usually /usr/share/snmp/mibs/.
  18 If this is not done, the "snmptrap" program has no idea what information
  19 to send, and will not work.  The MIB installation is *NOT* done as
  20 part of the default installation, so that step *MUST* be done manually.
  21
  22 The global MIB directory can be found by running the following command:
  23
  24         $ snmptranslate -Dinit_mib .1.3 2>&1 | grep MIBDIR | sed "s/' .*//;s/.* '//;s/.*://"
  25
  26 Or maybe just:
  27
  28         $ snmptranslate -Dinit_mib .1.3 2>&1 | grep MIBDIR
  29
  30 If you have copied the MIBs to that directory, you can test the
  31 FreeRADIUS MIBs by running the following command:
  32
  33         $ snmptranslate -m +FREERADIUS-NOTIFICATION-MIB -IR -On  serverStart
  34
  35 It should print out:
  36
  37         .1.3.6.1.4.1.11344.4.1.1
  38
  39 As always, run the server in debugging mode after enabling the
  40 traps.  You will see the "snmptrap" command being run, and it will
  41 print out any errors or issues that it encounters.  Those need to
  42 be fixed before running the server in daemon mode.
  43
  44 We also suggest running in debugging mode as the "radiusd" user, if
  45 you have "user/group" set in radiusd.conf.  The "snmptrap" program
  46 may behave differently when run as "root" or as the "radiusd" user.
  47
  48 You will also need to edit "radiusd.conf", and uncomment the line saying
  49
  50     # $INCLUDE trigger.conf
  51
  52 That will enable the triggers.
  53
  54
  55 More Documentation
  56 ------------------
  57
  58 See raddb/trigger.conf for complete documentation.