• installation des paquets qui vont bien

apt-get install awstats mergelog libgeo-ip-perl

• appliquer le patch vhffs (vérifier la version de awstats et choisir le patch correspondant):

cd /usr/lib/vhffs/bots/misc/
patch /usr/lib/cgi-bin/awstats.pl awstats_6.5_vhffs.patch

• créez un répertoire dans /var/log/apache2 pour y enregistrer les logs des sites web (dans notre exemple: server1)
• ajoutez un format de logs pour vhffs dans la configuration apache pour les sites vhffs:

LogFormat "%V %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"" vhffs
CustomLog /var/log/apache2/server1/vhffs.log vhffs

• Editez le fichier /etc/vhffs/vhffs.conf

log_incoming_root       =       /var/log/apache2
log_incoming_rotations  =       7
log_incoming_compress   =       yes

#Répertoire des sites web 
log_parsed_root         =       /data/web

log_parsed_rotation     =       7
log_parsed_compress     =       yes

# Where to find the awstat sampe file ?
log_awstats_sample      =       /etc/vhffs/awstats.sample

# Where to find awstat (caution, you must apply the vhffs patch on)
log_awstats             =       /usr/lib/cgi-bin/awstats.pl

# Is apache running locally or not ? (If not you should use the ugly remote restart of apaches over nfs)
log_apachelocal         =       yes

log_incoming_root: le répertoire de log apache, le même que celui défini dans le CustomLog ci-dessus, mais sans le nom du serveur (par exemple: /var/log/apache2 ) log_incoming_rotations: 7
log_incoming_compress: yes
log_parsed_root: le répertoire des données des sites web (par défaut: /data/web)
log_parsed_rotation: 7
log_parsed_compress: yes
log_awstats_sample emplacement du fichier awstats_sample, qui contient la configuration par défaut de awstats. Vhffs installe ce fichier dans /usr/lib/vhffs/bots/misc/awstats.sample. Si vous le modifiez, pensez à le déplacer, par exemple dans /etc/vhffs/, afin qu'il ne soit pas écrasé lors d'une mise à jour.
Sinon, vous pouvez modifier la configuration de awstats dans le fichier /etc/awstats/awstats.conf.local. Ces modifications s'appliquent à tous les sites. log_awstats: emplacement du fichier awstats.pl, généralement /usr/lib/cgi-bin/awstats.pl.
log_apachelocal: yes : a utiliser si votre apache est dans le même environnement que le bot. Si vous spécifiez “no”, un fichier “cycleok” sera placé dans le répertoire /data/logs/web/incoming/SERVER/ à chaque lancement du robot web_stats.pl

Il suffit de placer un cron sur la machine où tourne le serveur web de la forme :

  * * * * *    root   if [ -e /data/logs/web/incoming/SERVER/cycleok ]; then /usr/sbin/apache2ctl graceful ; rm /data/logs/web/incoming/SERVER/cycleok; fi

• activez les robots en éditant le fichier /etc/cron.d/vhffs ou tout autre fichier contenant les informations de cron pour vhffs

0   0      * * *   root    ionice -c3 nice -n 19 /usr/lib/vhffs/bots/web_stats.pl

Pour chaque site web, vous trouverez outre les répertoires htdocs, tmp et php-include, deux nouveaux répertoires: awstats (qui contient les fichiers créer et par awstats) et logs (qui contient les fichiers logs apache se rapportant à ce site.

• créer un sous-domaine: stats.mondomaine.net

Créez un fichier /etc/apache2/sites-available/stats

<VirtualHost 213.246.39.173:80>
      HashEnable Off

      ServerAdmin admin@mondomaine.com
      ServerName stats.mondomaine.com
      DocumentRoot /usr/lib/cgi-bin
      DirectoryIndex awstats.pl

      <Directory /usr/lib/cgi-bin/>
              AllowOverride None
              Options ExecCGI FollowSymlinks
              AddHandler cgi-script .cgi
              AddHandler cgi-script .pl

              RewriteEngine on
              RewriteBase /
              RewriteRule ^([a-zA-Z0-9\.\-]+)/$ /awstats.pl?config=$1
              RewriteRule ^([a-zA-Z0-9\.\-]+)/([0-9]{4})/$ /awstats.pl?config=$1&year=$2
              RewriteRule ^([a-zA-Z0-9\.\-]+)/([0-9]{4})/([0-9]{2})/$ /awstats.pl?config=$1&year=$2&month=$3

      </Directory>

       Alias /awstats-icon /usr/share/awstats/icon/
       <Directory /usr/share/awstats/icon>
              Order allow,deny
              Allow from all
       </Directory>

</VirtualHost>

* rendez-vous sur http://stats.mondomaine.net/nomdusite.tld/ ou http://stats.mondomaine.net/awstats.pl?config=nomdusite.tld