Nous allons donc voir tout d'abord comment l'installer, puis comment le configurer et enfin détailler la configuration nécéssaire pour accéder aux rapports qu'il génére via le serveur web apache 2.0.

Première étape : l'installation

L'installation est triviale.

En effet, après avoir mis à jour vos ports afin de profiter de la dernière version, il suffit de faire la procédure d'installation habituelle :

# cd /usr/ports
# make update
# cd www/awstats
# make install clean

Deuxième étape : la configuration

Le ports d'awstats installe ce dernier dans /usr/local/www/awstats.

Cependant, il ne fait aucune configuration particulière.

C'est à vous de créer les fichiers de configuration et de les initialiser correctement.

Heureusement, les concepteurs d'awstats fournissent un modèle de fichiers de configuration.

Nous allons donc commencer par créer le répertoire qui contriendra les fichiers de configuration, puis nous allons copier le modèle dans ce répertoire :

# sudo mkdir /usr/local/etc/awstats
# sudo cp /usr/local/www/awstats/cgi-bin/awstats.model.conf /usr/local/etc/awstats.conf

Une fois la manipulation effectué, il suffit d'ouvrir le fichier /usr/local/etc/awstats.conf avec votre éditeur de texte préféré.

Les paramètres à modifier sont par ordre d'apparition :

  1. LogFile, qui doit contenir le chemin d'accès au fichier de log que vous souhaitez analyser.
  2. LogType, qui doit indiquer le type de type de fichier de log, en l'occurence W.
  3. LogFormat, qui permet d'indiquer ou de définir le format du fichier de log.
  4. SiteDomain, qui défini le nom du site auquel se rapporte le fichier de log.
  5. HostAliases, qui défini les alias du site auquel se rapporte le fichier de log.
  6. DnsLookup, qui indique à l'analyseur qu'il doit ou non résoudre les adresses IP figurant dans le fichier de log.
  7. DirData, qui vous permet d'indiquer le chemin d'accès du répertoire qui contiendra les fichiers générés par l'analyseur.

Si vous désirez plus de détails sur ces différents paramètres, je vous renvoie au fichier de configuration qui est abondament commenté.

Il est également possible de configurer beaucoup plus finement l'analyseur en modifiant d'autres paramètres, mais ces derniers ne sont pas indispensables à son fonctionnement.

Si vous désirez des statistiques plus fines, je vous conseille donc de lire attentivement le fichier de configuration.

Un mot cependant sur le paramètre DirData.

Vous pouvez lui indiquer l'emplacement de votre choix, mais je ne saurais trop vous conseillez de créer et d'utiliser le répertoire /var/db/awstats, afin de respecter l'esprit de l'arborescence de FreeBSD.

# cd /var/db
# sudo mkdir awstats

Une fois le fichier de configuration correctement modifié, il faut vérifier le bon fonctionnement de l'analyseur.

Pour ce faire, il suffit d'éxécuter le script en perl chargé d'analyser le fichier de log :

# cd /usr/local/www/awstats/tools
# sudo ./awstats_updateall.pl -configdir=/usr/local/etc/awstats now

Si tout est correctement configuré, le script se lance et peut s'éxécuter pendant une durée courte ou très longue, suivant la taille de votre fichier de log.

Dans le cas contraire, un ou plusieurs messages d'erreur explicites sont affichés.

Une fois que les éventuels problèmes ont été résolus et que le script s'éxécute de manière satisfaisante, il reste à l'ajouter à la crontab de votre système, en y ajoutant la ligne :

0 */4 * * * root /usr/local/www/awstats/tools/awstats_updateall.pl -configdir=/usr/local/etc/awstats/ now

Ainsi, le script d'analyse sera éxécuté toute les 4 heures.

Troisième étape : la configuration d'apache

Nous disposons donc maintenant de statistiques mais nous ne pouvons pas les visualiser.

Pour pouvoir le faire, il faut configurer votre serveur web pour qu'il puisse utiliser awstats.

Nous allons supposer par la suite que vous disposez du serveur web apache 2.0.

De plus, nous allons supposer que vous voulez utilisez un VirtualHost pour permettre la consultation des statistiques.

Pour ce faire, il faut commencer par créer le fichier de configuration :

# cd /usr/local/etc/apache2/Includes
# > awstats.conf

Une fois le fichier créé, il faut à nouveau utiliser votre éditeur pour y insérer les lignes suivante :

<VirtualHost 22.33.44.55:80>
   ServerName awstats.mageekbox.votredomaine.tld
   DocumentRoot /usr/local/www/awstats
   CustomLog /var/log/www/awstats.votredomaine.tld-access.log common
   ErrorLog /var/log/www/awstats.votredomaine.tld-error.log
   #
   # Directives to allow use of AWStats as a CGI
   #
   Alias /awstatsclasses "/usr/local/www/awstats/classes/"
   Alias /awstatscss "/usr/local/www/awstats/css/"
   Alias /awstatsicons "/usr/local/www/awstats/icons/"
   ScriptAlias / "/usr/local/www/awstats/cgi-bin/"
   #
   # This is to permit URL access to scripts/files in AWStats directory.
   #
   <Directory "/usr/local/www/awstats/">
      Options None
      AllowOverride None
      Order allow,deny
      Allow from all
   </Directory>
</VirtualHost>

Une fois le fichier de configuration édité et sauvegardé, il faut ensuite vérifier sa syntaxe :

# apachctl configtest

Si le test des fichiers de yntaxe est positif, il ne reste plus qu'à demander au serveur web de relire son fichier de configuration :

# apachctl graceful

Le site permettant de visualisez vos statistique est alors visible à l'adresse http://awstats.votredomaine.tld/awstats.pl.

Evidement, vous aurez pris soin de configurer la zone DNS de votre domaine en conséquence avant de faire tout cela.