======RoRadius, installation guide=======

=====Requirements=====

  * Working rails environment (refer to your distribution documentation)
  * Database server supported by Ruby/ActiveRecord((The initial development was made with MySQL 5.0))
  * Freeradius server

=====Database=====

  * Create a user for RoRadius and full rights to one database
  * Import the file in directory //db// corresponding to your database server (e.g. //db/mysql.sql//)

=====Installation=====

  * Download or checkout via subversion((svn checkout http://svn.asyd.net/svn/roradius/trunk/)) RoRadius
  * Edit the section **development:** in file //config/database.yml// to set databases credentials
  * You can try the application by calling //./script/server// script and hit [[http://localhost:3000/|http://localhost:3000/]]

=====Configuration=====

====Apache====

===virtual.conf===

FastCgiServer   /var/www/demo.asyd.net/roradius/public/dispatch.fcgi -processes 5 -initial-env RAILS_ENV=development -idle-timeout 120

<code apache>
<VirtualHost *:80>
         ServerName demo.asyd.net
         DocumentRoot        /var/www/demo.asyd.net/roradius/public/
         Alias               /roradius/      /var/www/demo.asyd.net/roradius/public/
         DocumentRoot        /var/www/demo.asyd.net/htdocs 
         <Location /roradius>
                AuthName        roradius
                AuthType Basic
                AuthUserFile /etc/apache2/demo.htpasswd
                require valid-user
         </Location>
</VirtualHost>
</code>

===RAILS_ROOT/public/.htaccess===

If you want use a different alias (in the apache configuration) than /roradius, you must
edit the following directive :

<code>
# Example:
#   Alias /myrailsapp /path/to/myrailsapp/public
#   RewriteBase /myrailsapp

RewriteBase /roradius
</code>

====Database====

===MySQL===

Note: A version 5 is actually required.

<code>
# mysql -u root -p mysql
msyql> INSERT INTO user (user, host, password) VALUES ('freeradius', '127.0.0.1', PASSWORD('xxxx'));
mysql> FLUSH PRIVILEGES;
mysql> CREATE DATABASE freeradius;
mysql> GRANT ALL PRIVILEGES TO freeradius.* ON freeradius@'127.0.0.1';
mysql> FLUSH PRIVILEGES;
mysql> exit
# mysql -u freeradius -p < db/mysql.sql
</code>

===config/database.yml===

Edit the production entry for a RoRadius release, edit
the development one if you checkout the trunk.

<code>
production:
  adapter: mysql
  database: freeradius_production
  username: root
  password:
  host: localhost
</code>