| 1 |
PREREQUISITES |
|---|
| 2 |
============= |
|---|
| 3 |
|
|---|
| 4 |
- PHP 5.x (http://www.php.net) |
|---|
| 5 |
- PHP's mbstring extention installed |
|---|
| 6 |
- PHP's php-xml extention installed (Required if RSS support is on) |
|---|
| 7 |
- PHP's dom extension installed (Required if you want to export the list of |
|---|
| 8 |
Hotspots as a RSS feed) |
|---|
| 9 |
- PHP's curl extension installed (Required if you want to use Phlickr) |
|---|
| 10 |
- PHP compiled with gettext support (Will be autodetected if unavailable, but |
|---|
| 11 |
you will loose internationalization) |
|---|
| 12 |
- PostgreSQL 7.4+ (http://www.posgresql.org/) |
|---|
| 13 |
- Smarty template engine (http://smarty.php.net/) |
|---|
| 14 |
- Magpierss (http://magpierss.sourceforge.net/) (Required for RSS support. RSS |
|---|
| 15 |
support must be manually disabled if you do not install it) |
|---|
| 16 |
- FCKeditor 2.3+ (http://www.fckeditor.net/) (Required if you want to edit |
|---|
| 17 |
content with a HTML text editor aka WYSIWYG editor) |
|---|
| 18 |
- FPDF 1.53+ (http://www.fpdf.org/) (Required if you want to export the node |
|---|
| 19 |
list into a PDF file) |
|---|
| 20 |
- PEAR (if you need RADIUS auth support, see below) |
|---|
| 21 |
- Phlickr 0.2.5+ installed as a PEAR package (http://phlickr.sourceforge.net/) |
|---|
| 22 |
(required if you want to use the content class accessing Flickr photo albums) |
|---|
| 23 |
- PEAR packages radius, Auth_RADIUS and Crypt_CHAP (required if you need RADIUS |
|---|
| 24 |
support) |
|---|
| 25 |
- PEAR packages Image_Graph-alpha Image_Canvas-alpha Image_Color (required if |
|---|
| 26 |
you want to generate graphical statistics) |
|---|
| 27 |
- PEAR package Cache_Lite (required if you want to use WiFiDogs caching |
|---|
| 28 |
capabilities) |
|---|
| 29 |
- PEAR package HTML_Safe-beta (required if you want to ensure that HTML enabled |
|---|
| 30 |
input in various content classes will be filtered) |
|---|
| 31 |
|
|---|
| 32 |
INSTALLATION |
|---|
| 33 |
============ |
|---|
| 34 |
|
|---|
| 35 |
Open with your browser the following URL: |
|---|
| 36 |
http://www.domain.com/wifidogPATH/install.php |
|---|
| 37 |
|
|---|
| 38 |
Replace www.domain.com by your domain and wifidogPATH by the right path. |
|---|
| 39 |
|
|---|
| 40 |
install.php will validate, install, create and configure all the stuff you need |
|---|
| 41 |
to have a working auth-server. |
|---|
| 42 |
|
|---|
| 43 |
WIKI |
|---|
| 44 |
==== |
|---|
| 45 |
|
|---|
| 46 |
More detailed installation instructions can be found on our homepage at: |
|---|
| 47 |
http://www.wifidog.org/ |
|---|
| 48 |
|
|---|
| 49 |
RADIUS AUTHENTICATION SUPPORT SECTION |
|---|
| 50 |
===================================== |
|---|
| 51 |
|
|---|
| 52 |
The following section only needs to be followed if you want RADIUS support. |
|---|
| 53 |
|
|---|
| 54 |
You'll need to install PEAR and several PEAR and PHP modules. The procedure |
|---|
| 55 |
below is for PHP 5.0.2 under Mandrake 10.1. You WILL need to adapt it under |
|---|
| 56 |
other distributions. |
|---|
| 57 |
|
|---|
| 58 |
All necessary RPM packages are available in the contrib urpmi source. If you |
|---|
| 59 |
don't have a contrib source already, you can add one with the command: |
|---|
| 60 |
|
|---|
| 61 |
urpmi.addmedia contrib http://gulus.usherbrooke.ca/pub/distro/Mandrakelinux/official/10.1/i586/media/contrib with media_info/hdlist.cz |
|---|
| 62 |
|
|---|
| 63 |
You'll need the following packages: |
|---|
| 64 |
libphp5-commons |
|---|
| 65 |
php5-cli |
|---|
| 66 |
php5-devel |
|---|
| 67 |
php5-xml |
|---|
| 68 |
php5-xmlrpc ---> depends on libxmlrpc |
|---|
| 69 |
php5-mhash |
|---|
| 70 |
php5-mcrypt |
|---|
| 71 |
|
|---|
| 72 |
The following command should install them all and resolve dependencies: |
|---|
| 73 |
|
|---|
| 74 |
urpmi php5-cli php5-devel php5-xml php5-xmlrpc php5-mhash php5-mcrypt |
|---|
| 75 |
|
|---|
| 76 |
To install PEAR, run this in a shell: |
|---|
| 77 |
"lynx -source http://go-pear.org | php5" |
|---|
| 78 |
|
|---|
| 79 |
WARNING: |
|---|
| 80 |
-------- |
|---|
| 81 |
You must have PHP5 CLI with php5ize installed |
|---|
| 82 |
|
|---|
| 83 |
NB: By default Mandrake renames the PHP binaries with a 5 suffix. You should |
|---|
| 84 |
create symbolic links so that you can use standard scripts: |
|---|
| 85 |
|
|---|
| 86 |
ln -s /usr/bin/php5 /usr/bin/php |
|---|
| 87 |
ln -s /usr/bin/php5ize /usr/bin/phpize |
|---|
| 88 |
|
|---|
| 89 |
Now you'll need a few packages, you can let PEAR install them automatically: |
|---|
| 90 |
|
|---|
| 91 |
pear install radius Auth_RADIUS Crypt_CHAP |
|---|
| 92 |
|
|---|
| 93 |
BACKUP AND RESTORE |
|---|
| 94 |
================== |
|---|
| 95 |
|
|---|
| 96 |
To backup: |
|---|
| 97 |
/sql/backup_database.sh wifidog_backup.sql |
|---|
| 98 |
|
|---|
| 99 |
To restore from a backup: |
|---|
| 100 |
/sql/restore_database.sh wifidog_backup.sql |
|---|
| 101 |
|
|---|
| 102 |
Enjoy! |
|---|
