root/trunk/wifidog-auth/INSTALL @ 685

Prerequisites:
-PHP5
-Smarty template engine http://smarty.php.net/
-Magpierss http://magpierss.sourceforge.net/ (Required for RSS support.  RSS support must be manually disabled if you do not insall it)
-php's php-xml extention installed. (Required if RSS support is on)
-php's dom extension installed. (Required if you want to export the list of HotSpots as a RSS feed)
-php compiled with gettext support (Will be autodetected if unavailable, but you will loose internationalization)
-PostgreSQL (mysql code also exists, but is looking for a maintainer)
-PEAR ( if you need RADIUS auth support, see below )

Install files:

-Uncompress the tarball on your web server.
-Copy the content of the libs directory of the smarty tarball in lib/smarty/
-Copy the content of the magpierss-0.xx directory of the magpierss tarball in lib/magpie.  If you do not wish to install RSS support, you must set define('RSS_SUPPORT', false) in config.php.

-portal/cache/, and everything in tmp/smarty must be at least writable by your web server.  Run "sh permissions.sh" to set them 777

Database:
-Create the user wifidog (both in postgres and on your system).
-Import the schema:
        psql -d template1 -U wifidog -W -f sql/wifidog-postgres-schema.sql
-Import initial data:
        psql -d template1 -U wifidog -W -f sql/wifidog-postgres-initial-data.sql

Configure the system:   
-Edit wifidog/config.php to suit your environment.

*************************************
RADIUS authentication support section
*************************************

The following section only needs to be followed if you want RADIUS support.  You'll need to install PEAR and several PEAR and PHP modules.  The procedure below is for PHP 5.0.2 under Mandrake 10.1.  You WILL need to adapt it under other distributions.  

All necessary RPM packages are available in the contrib urpmi source.  If you don't have a contrib source already, you can add one with the command:
urpmi.addmedia contrib http://gulus.usherbrooke.ca/pub/distro/Mandrakelinux/official/10.1/i586/media/contrib with media_info/hdlist.cz

You'll need the following packages:
libphp5-commons
php5-cli
php5-devel
php5-xml
php5-xmlrpc ---> depends on libxmlrpc
php5-mhash 
php5-mcrypt

The following command should install them all and resolve dependencies:

urpmi php5-cli php5-devel php5-xml php5-xmlrpc php5-mhash php5-mcrypt

To install PEAR, run this in a shell:
"lynx -source http://go-pear.org | php5"

*************
WARNING:
You must have PHP5 CLI with php5ize installed
NB : By default Mandrake renames the PHP binaries with a 5 suffix.  You should create symbolic links so that you can use standard scripts:

ln -s /usr/bin/php5 /usr/bin/php
ln -s /usr/bin/php5ize /usr/bin/phpize
*************

Now you'll need a few packages, you can let PEAR install them
automatically:

pear install radius   ( PECL module compilation)
pear install Auth_RADIUS
pear install Crypt_CHAP

*****************************************
End RADIUS authentication support section
*****************************************


Enjoy!