daloRADIUS
Introduction
daloRADIUS is an advanced RADIUS web management application aimed at managing hotspots and general-purpose ISP deployments. It features user management, graphical reporting, accounting, a billing engine and integrates with GoogleMaps for geo-locating.
Note: This how-to has been tested with 8.04 and 10.04
Install Prerequisites
- Apache 1/2
- PHP 4/5
- PHP GD
- PHP DB Abstraction Layer (may require PHP Pear)
- MySQL 4/5
This how-to is based on Ubuntu server 10.04
How-to Install
A list of all packages which you need installed to get this running in even less time so that you don't have to spend time on figuring out which packages are required and which are not. If you are doing a new OS install you can skip the next line 'sudo tasksel' as this fuction is built in to the install script
sudo tasksel
select
- LAMP
- SSH server
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install mysql-server
sudo apt-get install php5-gd php-pear php-db
sudo apt-get install freeradius freeradius-mysql
sudo apt-get install phpmyadmin
Extract Archive
Choose which version you would like to install. Either "stable" or "bleeding edge" but not both.
Stable is code that has been tested and is considered to be stable
Bleeding edge code is code that is under active development with all the new bells and whistles but may be unstable.
Stable
daloRADIUS homepage is hosted on sourceforge at the address of http://sourceforge.net/projects/daloradius/ and you may get the latest release from there if you haven't already done so.
wget http://sourceforge.net/projects/daloradius/files/daloradius/daloradius-0.9-8/daloradius-0.9-8.tar.gz/download
extract the daloradius.tar.gz archive to /var/www
tar -zxvf daloradius-0.9-8.tar.gz
mv daloradius-0.9-8 daloradius
sudo cp daloradius/ /var/www -R
or
Bleeding Edge
- Download from svn
sudo apt-get install subversion build-essential screen
svn co https://daloradius.svn.sourceforge.net/svnroot/daloradius/trunk daloradius
sudo cp daloradius/ /var/www -R
Setting Permissions
You also need to change permissions so that the webserver user and group are owning daloRADIUS's directory. In Debian the user and group are www-data and so we need to do this:
sudo chown www-data:www-data /var/www/daloradius -R
sudo chmod 644 /var/www/daloradius/library/daloradius.conf.php
The chmod command is for having the daloradius.conf.php configuration file writable by the webserver for easy administration from the web interface.
Database Setup
Fresh install of daloRADIUS (and possibly FreeRADIUS)
If you *DONT HAVE* the radius database in MySQL you need to create it and then import both freeradius and daloradius tables using this schema: (for fresh installations)
cd /var/www/daloradius/contrib/db/
mysql -u root -p Enter password:mysqladminsecret mysql> CREATE DATABASE radius; mysql> quit
FreeRADIUS 1.X
- If you are working with FreeRADIUS 1.X (Ubuntu 8.04) then:
mysql -u root -p radius < fr1-mysql-daloradius-and-freeradius.sql
If
Also if using svn version run the following command to update
mysql -u root -p radius < mysql-migrate-0.98-to-0.99.sql
or
FreeRADIUS 2.X
- If you are working with FreeRADIUS 2.X (Ubuntu 10.04) then:
mysql -u root -p radius < fr2-mysql-daloradius-and-freeradius.sql
If
Also if using svn version run the following command to update
mysql -u root -p radius < mysql-migrate-0.98-to-0.99.sql
or
Radius database already imported
- If you already have the radius database imported (i.e: radcheck, radacct, etc...) then you only need daloradius's tables added:
cd /var/www/daloradius/contrib/db
mysql -u root -p radius < mysql-daloradius.sql
If
Also if using svn version run the following command to update
mysql -u root -p radius < mysql-migrate-0.98-to-0.99.sql
Database Connection Setup
Now, simply adjust the MySQL database information in daloRADIUS's config file.
cd /var/www/daloradius/library/
sudo nano -w daloradius.conf.php
FreeRADIUS 1.X
- If you are working with FreeRADIUS 1.X (Ubuntu 8.04) then:
$configValues['FREERADIUS_VERSION'] = '1';
$configValues['CONFIG_DB_PASS'] = 'password';
or
FreeRADIUS 2.X
- If you are working with FreeRADIUS 2.X (Ubuntu 10.04) then:
$configValues['FREERADIUS_VERSION'] = '2';
$configValues['CONFIG_DB_PASS'] = 'password';
$configValues['CONFIG_DB_TBL_RADUSERGROUP'] = 'radusergroup';
Installation Complete
Surf to
http://your ip address/daloradius
Login to the management:
username: administrator password: radius
Notice: don't forget to change the default password in the Configuration -> Operators page
See Also
Open Source Hotspot controllers
Chillispot - Chilli Hotspot controller
Chillispot ubuntu 8.04 - Ubuntu 8.04 Chilli Hotspot controller
CoovaChilli - CoovaChilli Hotspot controller
External Links
daloRADIUS source information