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