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