[ Retour ]
Description : Installation de l'outils d'analyse Awstats
Auteur : Nicolas AGIUS
Date : 06/2004
Notes : Exemples pris sur RedHat 7.3

Installation de Awstats
pour Apache en environnement chrooté



     AWStats est un module Perl qui affiche des statistiques avancées d'un site Web.

Pour réaliser ceci, vous aurez besoin du logiciel suivant : awstats-6.1.tgz

   Cette installation se base sur la configuration présentée dans la doc sur Apache :
      - Le serveur web est dans le répertoire /web-chroot/http/http
      - La configuration est accessible par /etc/httpd/conf
      - Les logs sont accessible par /var/log/httpd

Rq: les statistiques seront calculées pour le site web classique et non l'interface webmail https.

   Comme le serveur web fonctionne en environnemnt chrooté, awstats ne peux pas être installé en tant que script CGI, (Perl n'est pas présent dans le chroot). Il sera donc installé en dehors, avec une génération de pages statiques accessibles par le serveur web.

Préparation d'Apache


Tout d 'abord, faites une sauvegarde de votre configuration d'apache :
   cp /etc/httpd/conf/httpd.conf /etc/httpd/conf/httpd.conf.bak

Ensuite éditez le fichier httpd.conf et modifiez la ligne :
   CustomLog logs/access_log common
en :
   CustomLog logs/access_log combined

Purgez ensuite les précédents logs :
   >/var/log/httpd/access_log

Et relancez apache :
   /etc/rc.d/init.d/httpd restart

Installation d'Awstats :


Exécutez les commandes suivantes :

tar -xzvf awstats-6.1.tgz
mv awstats-6.1 /usr/local/awstats
mkdir /etc/awstats
cp /usr/local/awstats/wwwroot/cgi-bin/awstats.model.conf /etc/awstats/awstats.www.chezmoi.fr.conf
chmod 644 /etc/awstats/awstats.www.chezmoi.fr.conf

Rq : remplacer www.chezmoi.fr par le nom de votre serveur web.

Editez ensuite ce dernier fichier et modifiez les lignes suivantes pour mettre les paramètres adapté à votre configuration :

LogFile="/var/log/httpd/access_log"
SiteDomain="www.chezmoi.fr"
DNSLookup=1

Vous pouvez aussi modifier le paramètre HostAliases si vous utilisez plusieurs VirtualHost.

Plus d'info : /usr/local/awstats/docs/awstats_config.html

Premier lancement :
   /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=www.chezmoi.fr -update

Vérifiez ainsi qu'il n'y a pas d'erreur dans la configuration.

Génération des pages statiques :
   mkdir /web-chroot/www/htdocs/awstats
   cp -R /usr/local/awstats/wwwroot/icon/ /web-chroot/www/icons/awstats

Créez ensuite le fichier /etc/cron.daily/awstats contenant les lignes suivantes :

#!/bin/bash

/usr/local/awstats/tools/awstats_buildstaticpages.pl -config=www.chezmoi.fr -update -lang=fr -dir=/web-chroot/www/htdocs/awstats/ -diricons=/icons/awstats

Changez lui ses droits :
   chmod 755 /etc/cron.daily/awstats
Puis exécutez le une première fois.

De cette façon , les statistiques seront mises à jour tous les jours par crond.

Plus d'info : man 8 cron

Les statistiques sont mantenant accessibles avec un navigateur à l'adresse : http://www.chezmoi.fr/awstats/awstats.www.chezmoi.fr.htm

Valid HTML 4.01!

Copyleft 2004 - Nicolas AGIUS