1Petit guide pour l'installation d'amavis-stats sur FreeBSD 2---------------------------------------------------- 3(c) Loic Pefferkorn (pef) <loic AT dev DOT erodia DOT net> 4 5Le document original est disponible ici : http://www.erodia.net/doc/ 6 7Ce guide comporte les informations suivantes : 8 91.Introduction 101.1 A propos du guide 111.2 Qu'est-ce que amavis-stats ? 121.3 El�ments requis 132.Installation 142.1 T�l�charger les sources et les installer 152.2 Configurer Apache 162.3 Mettre les droits ad�quats 172.4 Cr�er l'utilisateur amavis 182.5 Modifier les fichiers 193.Etapes finales 203.1 Test de l'installation 213.2 Cron job 224.Divers 23 24 251.Introdution 26------------- 27 281.1 A propos du guide 29--------------------- 30Ceci est un petit guide expliquant l'installation d'amavis-stats sur FreeBSD. 31J'ai la version STABLE-4.9, avec une autre version ou un autre *BSD, il ne doit 32pas y avoir de grandes diff�rences. 33 34Comme il n'y a pas de package tout pr�t, tout sera fait "� la main". 35 361.2 Qu'est-ce que amavis-stats ? 37-------------------------------- 38Amavis-stats sert � g�n�rer des statistiques sur amavis, en utilisant rrdtool. 39Il g�n�re des graphiques des e-mails "propres", des spams et des virus class�s par nom. 40Pour cela il utilise les logs produits par amavis. 41 42Vous pouvez voir des exemples de graph produits � la page suivante : 43 44http://rekudos.net/amavis-stats/node/view/7 45 461.3 El�ments requis 47------------------- 48Amavis-stats a besoin d'un module perl fourni par le package rrdtool. 49 50Vous pouvez l'installer en utilisant les sources : 51 cd /usr/ports/net/rrdtool ; make all && make install 52 53Ou avec le package binaire : 54 pkg_add ftp://ftp.freebsd.org/pub/FreeBSD/ports/i386/packages-4-stable/net/rrdtool-1.0.45.tgz 55 56note : merci d'utiliser un mirroir FreeBSD http://mirrorlist.freebsd.org/ 57 58Un serveur apache fonctionnel est n�cessaire, avec php. 59 60Ma configuration : 61-apache2 avec mod_php4. 62-Postfix-2 63-Amavis-new 64-Clamav-0.65 65 66Je consid�re qu'Amavisd est configur� de la sorte : 67-$DO_SYSLOG = 1; 68 69note : ce param�tre est modifiable dans le fichier amavisd.conf, habituellement situ� dans /usr/local/etc 70 71Les logs peuvent �tre envoy�s dans un fichier s�par�, dans ce cas veillez � ce que l'utilisateur amavis puisse le lire. 72 732.Installation 74------------- 75 762.1 T�l�charger les sources et les installer 77-------------------------------------------- 78T�l�chargez le tarball contenant la derni�re version : 79 wget http://rekudos.net/download/amavis-stats.tar.gz 80 81D�compressez-la : 82 tar xvzf amavis-stats.tar.gz 83 cd amavis-stats-xx 84 85Copiez le fichier amavis-stats dans /usr/local/sbin : 86 cp amavis-stats /usr/local/sbin 87 88Cr�ez les r�pertoires n�cessaires : 89 mkdir /usr/local/www/amavis-stats 90 mkdir -p /usr/local/lib/amavis-stats/img 91 ln -s /usr/local/lib/amavis-stats/img /usr/local/www/amavis-stats/img 92 93Copiez le fichier amavis-stats.php dans /usr/local/www/amavis-stats 94et faites un lien symbolique pointant vers un fichier index : 95 cp amavis-stats.php /usr/local/www/amavis-stats 96 cd /usr/local/www/amavis-stats && ln -s amavis-stats.php index.php 97 98note : index.php est un fichier d'index de r�pertoire, 99 d�fini par "DirectoryIndex" dans la configuration d'apache. 100 1012.2 Configurer d'Apache 102----------------------- 103Dans le fichier apache.conf fourni modifiez les chemins : 104 105Alias /amavis-stats /usr/local/www/amavis-stats 106 107<Directory /usr/local/www/amavis-stats> 108(...) 109 110Ajoutez le dans le httpd.conf d'Apache : 111 cat apache.conf >> /usr/local/etc/apache2/httpd.conf 112 113note : au lieu d'ajouter le fichier, vous pouvez l'inclure, renommez apache.conf en amavis.httpd.conf, 114 d�placez-le dans /usr/local/etc/apache2, puis ajoutez dans le fichier httpd.conf d'apache : 115 Include etc/apache2/amavis.httpd.conf 116 117Relancez apache 118 apachectl restart 119 1202.3 Mettre les droits ad�quats 121------------------------------ 122Maintenant il faut l'utilisateur et le groupe sous lesquels tourne apache : 123 grep ^User\ /usr/local/etc/apache2/httpd.conf (2 espaces apr�s User\) 124 grep ^Group\ /usr/local/etc/apache2/httpd.conf (2 espaces apr�s User\) 125 126 127Je trouve www comme utilisateur et www comme groupe. Si vous n'avez pas la m�me chose, 128remplacez juste www:www par VotreUtilisateur:VotreGroupe dans la commande chown qui suit. 129 130Mettez les droits ad�quats sur le r�pertoire img avec ce que nous venons de trouver : 131(le fichier php va �crire les images dans ce r�pertoire, donc apache doit pouvoir y �crire) 132 chown www:www /usr/local/lib/amavis-stats/img 133 1342.4 Cr�er l'utilisateur amavis 135------------------------------ 136Il faut un utilisateur amavis, qui va maintenir les statistiques � jour en lancant un cron job toutes les 5 minutes. 137 138Cr�ons le � l'aide de adduser ou de sysinstall : 139 useradd amavis 140 141Choisissez les valeurs par d�faut, pour son r�pertoire personnel mettez /usr/ocal/lib/amavis-stats. 142 143note : Le groupe additionnel wheel est indispensable pour avoir le droit de lire /var/log/maillog, 144 si toutefois amavisd est configur� pour envoyer ses log � syslog. 145 146Maintenant les droits pour les r�pertoires auxquels l'utilisateur amavis 147doit avoir acc�s en �criture durant le cron job : 148 chown amavis /usr/local/lib/amavis-stats 149 chown amavis /usr/local/www/amavis-stats 150 151 1522.5 Modifier les fichiers 153------------------------- 154Maintenant modifions certains fichiers : 155 156Editez le fichier amavis-stats et changez : 157ligne 79 en: 158 $lockfile = "/var/tmp/$pkg"; 159ligne 80 en: 160 $libdir = "/usr/local/lib/$pkg"; 161 162 163Editez le fichier amavis-stats.php et changez : 164ligne 282 en : 165 $as_libdir = "/usr/local/lib/amavis-stats"; 166 1673. Etapes finales 168----------------- 169 1703.1 Test de l'installation 171-------------------------- 172note : pour les instructions suivantes, mettez /var/log/maillog dans le cas ou amavisd est configur� 173 pour envoyer les logs � syslog, sinon mettez le fichier de log que vous avez d�fini. 174 175Logguez vous sous le compte amavis, et v�rifiez que tout se passe bien : 176 su amavis 177 /usr/local/sbin/amavis-stats /var/log/maillog 178 179Cette commande a cr�e des fichiers dans /usr/local/lib/amavis-stats : 180 1811.rrd amavis-stats.count amavis-stats.state 1822.rrd amavis-stats.names img 1833.rrd amavis-stats.seen 184 185 186A pr�sent regardez si la page php marche, allez � http://LeNomDeVotreServeur/amavis-stats avec votre naviguateur favori. 187Si vous avez des erreurs du genre "write denied" rev�rifiez les droits sur les r�pertoires 188(voir section 2.3 Mettre les droits ad�quats). 189 1903.2 Cron job 191----------- 192Mettons en place un cronjob pour que les donn�es soient mises � jour r�guli�rement : 193 crontab -e -u amavis 194 195Ecrivez ceci dans l'�diteur qui vient de s'ouvrir : 196 197*/5 * * * * /usr/local/sbin/amavis-stats /var/log/maillog 2>&1 > /dev/null 198 199 200 201Comme l'utilisateur amavis n'a pas besoin de se logguer, vous pouvez par mesure de s�curit� lui �ter son shell : 202 chsh -s /sbin/nologin amavis 203 204 2054. Divers 206--------- 207 208Retours d'exp�rience 209-------------------- 210Je suis int�r�ss� par tous vos retours d'exp�rience, bons ou mauvais concernant ce guide. 211N'h�sitez pas � me contacter si vous trouvez des erreurs ou si quelque chose manque. 212 213<loic AT dev DOT erodia DOT net> 214 215 216Historique 217---------- 218v 1.0 (31 jan 2004) version initiale 219v 1.1 (2 fev 2004) modifications mineures, corrections version anglaise 220v 1.2 (6 fev 2004) mise en page, modifications mineures 221 222 223Copyright 224--------- 225(c) 2004 Loic Pefferkorn 226 227Cette documentation peut �tre reproduite enti�rement ou partiellement, sans frais, mais doit suivre les restrictions suivantes : 228 229 *La mention copyright et cette notification de la license doivent �tre pr�serv�es sur toutes les copies. 230 *Toute traduction ou travail d�riv� doit �tre approuv� par l'auteur avant d'�tre distribu�. 231 *Si vous distribuez des parties de ce document, il vous faut mettre les instructions n�cessaires pour obtenir la version compl�te. 232 *Ce document est plac� sous la license GPL (voir http://www.gnu.org/licenses/gpl.html) 233 234Remerciements 235------------- 236-Aux auteurs d'amavis. 237-A Mark Lawrence, pour amavis-stats 238-A Bosco L Parisi, pour ses conseils avis�s. 239 240 241