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/wwwtar -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: radiusNotice: don't forget to change the default password in the Configuration -> Operators page
