README

   1 1. INTRODUCTION
   2
   3   The FreeRADIUS Server Project is a high performance and highly
   4 configurable RADIUS server that is available under the terms of the
   5 GNU GPLv2.  Using RADIUS allows authentication and authorization for a
   6 network to be centralized, and minimizes the amount of
   7 re-configuration which has to be done when adding or deleting new
   8 users.
   9
  10   FreeRADIUS can authenticate users on systems such as 802.1x (WiFi),
  11 dialup, PPPoE, VPN's, VoIP, and many others.  It supports back-end
  12 databases such as MySQL, PostgreSQL, Microsoft Active Directory,
  13 OpenLDAP, and many more.  It is used daily to authenticate the
  14 Internet access for hundreds of millions of people, in sites ranging
  15 from 10 users, to 10 million and more users.
  16
  17   Version 2.0 of the server is similar in many respects to previous
  18 versions.  It also contains many new features, such as "virtual
  19 server" support, and a simple policy language ("man unlang").
  20 Administrators upgrading from a previous version should install this
  21 version in a different location from their existing systems.  They
  22 should then migrate their current configuration to the new server,
  23 being careful to take advantage of the new features which can greatly
  24 simply the servers configuration.
  25
  26   Please see the web page http://www.freeradius.org for more
  27 information.
  28
  29 2. INSTALLATION
  30
  31   To install the server, please see the INSTALL file in this
  32 directory.
  33
  34 3. DEBUGGING THE SERVER
  35
  36   Run the server in debugging mode, (radiusd -X) and READ the output.
  37 We really can't emphasize this enough.  The vast majority of problems
  38 can be solved by carefully reading the debugging output, which
  39 includes WARNINGs about common issues, and suggestions for how they
  40 may be fixed.
  41
  42   Read the FAQ.  Many questions are answered there.  See the Wiki
  43
  44         http://wiki.freeradius.org
  45
  46   Read the configuration files.  Many parts of the server have NO
  47 documentation, other than comments in the configuration file.
  48
  49   Search the mailing lists.  There is a Google link on the bottom of
  50   the page:
  51
  52         http://www.freeradius.org/list/users.html
  53
  54   Type some key words into the search box, and you should find
  55 discussions about common problems and solution.
  56
  57
  58 4. ADDITIONAL INFORMATION
  59
  60   See 'doc/README' for more information about FreeRADIUS.
  61
  62   There is an O'Reilly book available, which we recommend for people
  63 new to RADIUS.  It is almost 5 years old, however, and does not serve
  64 as much more than a basic introduction to the subject matter.
  65
  66 http://www.amazon.com/exec/obidos/ASIN/0596003226/freeradiusorg-20/
  67
  68   For other RADIUS information, the Livington internet site had a lot
  69 of information on radius online.  Unfortunately Livingston, and the
  70 site, don't exist anymore but there's a copy of the site still at:
  71
  72         http://portmasters.com/www.livingston.com/
  73
  74   Especially worth a read is the "RADIUS for Unix administrators guide"
  75
  76 HTML:  http://portmasters.com/tech/docs/radius/1185title.html
  77 PDF:   http://portmasters.com/tech/docs/pdf/radius.pdf
  78
  79
  80 5. PROBLEMS AND CONCERNS
  81
  82   We understand that the server may be difficult to configure,
  83 install, or administer.  It is, after all, a complex system with many
  84 different configuration possibilities.  If you have any comments, bug
  85 reports, problems, or concerns, please send them to the
  86 'freeradius-users' list (see the URL above).  We will do our best to
  87 answer your questions, to fix the problems, and to generally improve
  88 the server in any way we can.
  89
  90   What you should NOT do is complain that the developers aren't
  91 answering your questions quickly enough, or fixing the problems
  92 quickly enough, or that they're being mean for telling you to do some
  93 work yourself.  FreeRADIUS is the cumulative effort of many years of
  94 work by many people, and you've gotten it for free.  No one gets paid
  95 to work on FreeRADIUS, and no one is getting paid to answer your
  96 questions.  This is free software, and the only way it gets better is
  97 if you contribute work back to the project.
  98
  99   We will note that the people who complain the loudest about the
 100 developers being mean usually can't program, can't write
 101 documentation, won't pay others to do that work, demand that their
 102 every desire be satisifed immediately by the developers for free, and
 103 worst of all, don't understand why their attitude is unproductive.
 104 They seem to believe that because they've received something (the
 105 server) for free, that they have every right to demand more free
 106 support and development from the list.  That's simply not true.
 107
 108   So please submit bug reports, suggestions, or patches.  That
 109 feedback gives the developers a guide as to where they should focus
 110 their work.  If you like the server, feel free to mail the list and
 111 say so.