evoauth/install/INSTALL

INSTALLATION D'EVOAUTH
----------------------


1 - Installation du logiciel
----------------------------

Vous devez poss<73>der l'archive evoauth.tar.gz; choisissez un r<>pertoire
temporaire, comme /tmp, et ex<65>cutez :

	# cd /tmp
	# tar xvzf evoauth.tar.gz
	# cd evoauth
	# make install

Evoauth est <20> pr<70>sent install<6C> sur votre syst<73>me. Passons <20> la
configuration :

  - /etc/evoauth/evoauth.conf pour la configuration de la partie
    administration 

  - /etc/evoauth/evoauth.rules pour la configuration des r<>gles de
    firewall

	Il est <20> noter que les s<>parations entre les <20>l<EFBFBD>ments du fichier de 
	configuration peuvent <20>tre des epaces ou des tabulations.

	Vous pouvez <20>galement ajouter des commentaires sur des lignes
    sp<73>cifiques ou <20> la fin de r<>gles existantes, pr<70>c<EFBFBD>d<EFBFBD>s par le
    caract<63>re "#".

  - /var/www/htdocs/evoauth/includes/config.php pour la partie web

Il faut <20>galement installer sudo et mettre les lignes suivantes dans le 
fichier sudoers (par exemple via la commande `vipw`) : 

	User_Alias WWW = www-data
	Cmnd_Alias EVOAUTH = /usr/local/bin/evoauth
	WWW ALL= NOPASSWD: EVOAUTH

Changez par s<>curit<69> la somme md5 du mot de passe de 'admin' dans
/var/www/htdocs/evoauth/includes/config.php :
	
	$ echo -n PASS | md5sum


2 - Base de donn<6E>es Mysql
-------------------------

Installez la base de donn<6E>es Mysql (mysql-common, mysql-client).

Personnalisez le fichier /usr/local/share/doc/evoauth/install/database.sql
(sp<73>cifiez le login <20> utiliser, le mot de passe, la base), puis utilisez
le via : 

	$ cd /usr/local/share/doc/evoauth/install
	$ mysql -u <mysqladmin> -p < database.sql
	$ mysql -u <mysqladmin> -p

mysql> use mysql;
mysql> GRANT ALL PRIVILEGES ON *.* TO 'evoauth_user'@'192.168.4.1' \
	IDENTIFIED BY 'test' WITH GRANT OPTION;
mysql> GRANT ALL PRIVILEGES ON *.* TO 'evoauth_user'@'192.168.4.86' \
	IDENTIFIED BY 'test' WITH GRANT OPTION;
mysql> GRANT ALL PRIVILEGES ON *.* TO 'evoauth_user'@'192.168.4.123' \
	IDENTIFIED BY 'test' WITH GRANT OPTION;


3 - Serveur web Apache
----------------------

Installez Apache (Evoauth a <20>t<EFBFBD> d<>velopp<70> avec Apache 1.29),
l'utilisation de SSL (HTTPS) est conseill<6C>e.

Dans le fichier de configuration d'Apache (/etc/apache/httpd.conf),
ajoutez :

	Include /usr/local/share/doc/evoauth/install/http-evoauth.conf

Puis relancez Apache :

	# apachectl restart


4 - Installation des modules Perl n<>cessaires
---------------------------------------------

Vous devez installer les modules suivants :

  - DBD Mysql (libdbd-mysql)

  - DBD::Mysql (libdbd-mysql-perl)
  - DBI (libdbi-perl)
  - MIME::Lite (libmime-lite-perl)
  - Config::Tiny (libconfig-tiny-perl)


5 - Installation des composants PHP n<>cessaires
------------------------------------------------

Vous devez installer les composants suivants :

  - php4

En pr<70>vision pour la version 0.9 :

  - php4-pear
  - le module pear PEAR::Config.

6 - Lancement
-------------

Enfin, initialiser Evoauth gr<67>ce <20> la commande :

	# /usr/local/bin/evoauth -i

Si vous devez l'arr<72>ter :

	# /usr/local/bin/evoauth -s

Si vous voulez juste le red<65>marrer :

	# /usr/local/bin/evoauth -r