man/man8/radrelay.8

   1 .TH RADRELAY 8 "23 October 2007" "" "FreeRADIUS Daemon"
   2 .SH NAME
   3 radrelay -- Deprecated command.
   4 .SH DESCRIPTION
   5 The functions of \fIradrelay\fP have been added to \fIradiusd\fP.  One
   6 benefit is that one instance of \fIradiusd\fP can read multiple detail
   7 files, among others.
   8 .PP
   9 The \fIrlm_sql_log\fP module does something similar, but for SQL
  10 queries.  See it's man page for details.
  11 .SH "REPLICATION FOR BACKUPS"
  12 Many sites run multiple radius servers; at least one primary and one
  13 backup server. When the primary goes down, most NASes detect that and
  14 switch to the backup server.
  15
  16 That will cause your accounting packets to go the the backup server -
  17 and some NASes don't even switch back to the primary server when it
  18 comes back up.
  19
  20 The result is that accounting records are missed, and/or the
  21 administrator must jump through hoops in order to combine the
  22 different detail files from multiple servers. It also means that the
  23 session database ("radutmp", used for radwho and simultaneous use
  24 detection) gets out of sync.
  25
  26 We solve this issue by "relaying" packets from one server to
  27 another, so they both have the same set of accounting data.
  28
  29 See raddb/sites-available/buffered-sql for more information.
  30 .SH "BUFFERING FOR HIGH-LOAD SERVERS"
  31 If the RADIUS server suddenly receives a many accounting packets,
  32 there may be insufficient CPU power to process them all in a timely
  33 manner.  This problem is especially noticeable when the accounting
  34 packets are going to a back-end database.
  35
  36 Similarly, you may have one database that tracks "live" sessions, and
  37 another that tracks historical accounting data.  In that case,
  38 accessing the first database is fast, as it is small.  Accessing the
  39 second database many be slower, as it may contain multiple gigabytes
  40 of data.  In addition, writing to the first database in a timely
  41 manner is important, while data may be written to the second database
  42 with a few minutes delay, without any harm being done.
  43
  44 See raddb/sites-available/copy-to-home-server for more information.
  45 .SH SEE ALSO
  46 .BR radiusd(8),
  47 .BR rlm_sql_log(5)
  48 .SH AUTHOR
  49 The FreeRADIUS Server Project