|Version 10 (modified by pascal.charest@…, 6 years ago)|
These are step by step instructions to install Wifidog auth-server on Debian Linux (testing, 2.6.17).
December 11th, 2006 - This document is currently a draft and not completed! There might be a lot more package that is really required in the "prerequisites" section.
Install the distro
A minimum install without any specific package is enough, as long as you have internet access and apt installed.
Before we install anything lets be sure we have access to internet and that our apt database is updated
The authentification server require apache and php (we install the latest version)
apt-get install apache2 php5
It also require a database server. PostgreSQL 8.1 and 7.4 are available. 8.1 is harder to configure but faster. The how-to for 8.1 is not finished.
apt-get install postgresql-8.1
apt-get install postgresql-7.4
PostgreSQL 8.1 configuration file
It will crash at install, you must then do some tricky configuration
NOTE: this is not a good security setting, you should make sure you change that later on!
Install prerequisites - step2
We also need some specifics librairies
apt-get install xml-core gettext mcrypt libapache2-mod-php5 php5-cgi apt-get install php5-mcrypt php5-mhash php5-pgsql php-pear php5-xmlrpc php5-curl
To get the latest version of wifidog-auth we will need subversion:
apt-get install subversion
If you want multi-locales support, you will have to install that packages (or configure every one of them).
apt-get install locales-all
Some more libs
pear install XML_RPC cd /tmp wget http://ovh.dl.sourceforge.net/sourceforge/phlickr/Phlickr-0.2.5.tgz pear install Phlickr-0.2.5.tgz rm Phlickr-0.2.5.tgz
Some stuff that isn't needed for the install, but still nice to have on a server (and which won't be install by default). If you don't what these are, you might not need them ;-) Openssh-server will allow you to launch command remotly, very useful for the third screen of install.php
apt-get install openssh-server less
== Configure PostgreSQL 7.4 === You will have to change :
tcpip_socket = true
Install the auth server
svn checkout https://dev.wifidog.org/svn/trunk/wifidog-auth mv wifidog-auth/ /var/www/
Apache 2 configuration file
We need to change the document root. We take for granted that this server will be of no other "web" use... if it is, guess you'll have to learn how to configure apache2.
and change (at the fifth line):
remove the rewrite rule around line 16
cd /etc/init.d/ ./apache2 restart
Configure locale in wifidog.conf
If you are using an english only server on which locale "ca_FR" isn't installed, you will have to change the file :
on line 208 (ctrl+w+enter, ctrl+t+enter, 208) remplace
Configure mail server
You need to have a valid mailer in order to mail account confirmation!
apt-get install postfix
Select the "internet site with smart host" configuration option and answer the next series of questions.
Configure the auth server
Go to http://your-domaine.com/install.php and follow the instructions. They will ask to :
create a wifidog user in postgres
su - postgres createuser wifidog --pwprompt
answer no to the three questions and create a db owned by this new user
createdb wifidog --encoding=UTF-8 --owner=wifidog
you must then
and click next in your browser (it will ask for the password in dog_cookie.txt)
You will have to copy-paste the big serie of command, click refresh and next... Click install for simplepie, then next Click install for feedpressreview, then next
Do not install Phlickr and put your password in the next screen.