Installation de AWStats
Création — Nicolas THOREZ 2019/05/09 19:13
AWStats permet de visualiser les statistiques liées à un site web, telles que le nombre de visite par jour ou encore l'origine des visiteurs. Il s'agit d'un complément appréciable de tout site web.
Droits
Toute l'installation et la configuration se passe en tant que root. Ce tutoriel a été réalisé sur une version Jessie de Debian sur lequel tourne un serveur apache 2.4.Installation
- On commence par mettre à jour ses dépôts apt :
apt-get update
- Une fois les bases à jour, on peut installer les paquets nécessaires :
apt-get install awstats libmldbm-perl libnet-xwhois-perl libgeo-ipfree-perl
- AWStats est désormais installé, il faut maintenant le paramétrer.
Paramétrage
Création des fichiers de configuration de AWStats
- Il va falloir maintenant créer un fichier de configuration pour chaque vHost présent sur le serveur Apache. On commence par se rendre dans le dossier de configuration de AWStats :
cd /etc/awstats/
- On duplique le fichier awstats.conf en lui ajoutant l'url de contact du vhost, par exemple pour www.shyrkasystem.com :
cp awstats.conf awstats.www.shyrkasystem.com.conf
- Ensuite, il faut éditer le fichier créé :
nano awstats.www.shyrkasystem.com.conf
- Dans ce fichier, on va modifier les lignes suivantes pour leur donner ou s'assurer qu'elles ont les valeurs suivantes :
- LogFile="/var/log/apache2/shyrkasystem.com/access.log" ← On indique ici le chemin exacte du access.log correspondant au site
- LogType=W
- LogFormat=1
- SiteDomain="www.shyrkasystem.com" ← On indique ici l'url du site
- HostAliases="127.0.0.1 192.168.1.254 www.shyrkasystem.com" ← On ajoute l'url
- Une fois les modifications faites, on enregistre et on recommence avec le vHost suivant jusqu'au dernier.
Vérification
- Pour vérifier que les fichiers de configuration sont correct, on peut lancer AWStats en ligne de commande :
/usr/lib/cgi-bin/awstats.pl -config=www.shyrkasystem.com -update
- Si tout va bien et après quelques instants, la console affiche un message de ce type :
Update for config "/etc/awstats/awstats.www.shyrkasystem.com.conf" With data in log file "/var/log/apache/shyrkasystem.com/access.log"... Phase 1 : First bypass old records, searching new record... Searching new records from beginning of log file... Phase 2 : Now process new records (Flush history on disk after 20000 hosts)... Jumped lines in file: 0 Parsed lines in file: 12345 Found 0 dropped records, Found 0 corrupted records, Found 0 old records, Found 12345 new qualified records.
Mise en place de l'interface web
- Pour visualiser les statistiques depuis une interface web, on va commencer par créer un fichier de configuration Apache :
nano /etc/apache2/sites-available/awstats.conf
- Nous le remplissons avec les informations suivantes :
Alias /awstatsclasses "/usr/share/awstats/classes/" Alias /awstatscss "/usr/share/awstats/css/" Alias /awstats-icon "/usr/share/awstats/icon/" # ScriptAlias pour Apache 2.4 ScriptAlias /stats /usr/lib/cgi-bin/ # mêmes paramètres que dans awstats.*.conf <Directory /usr/lib/cgi-bin/> DirectoryIndex awstats.pl UseCanonicalName off AllowOverride All AuthName "Statistiques awstats" AuthType Basic Require valid-user AuthUserFile /var/www/.password Options +ExecCGI AllowOverride None </Directory>
- On crée le fichier contenant l'utilisateur et son mot de passe pour l'accès à la page, par exemple pour l'utilisateur nekan :
htpasswd -c /var/www/.password nekan
- On renseigne le mot de passe comme demandé et on le confirme en suivant.
- Il nous reste plus qu'à activer le site :
a2ensite awstats
- Enfin, on recharge le service Apache :
/etc/init.d/apache2 reload
Test
- On peut désormais afficher les statistiques du site en ajoutant /stats à la fin de son url, par exemple www.shyrkasystem.com/stats.
- Une demande d'authentification apparaît :

- Une fois, l'authentification validée, on accède enfin aux statistiques :
Résolution des problèmes
Téléchargement d'un fichier txt/perl
Problème
Lors de la visite de la page stats, le site n'affiche rien et vous propose de télécharger un fichier de type txt/perl.
Solution
Activez le module cgi d'apache et redémarrer apache
a2enmod cgi service apache2 restart
Erreur d'accès à /var/lib/awstats
Problème
Lors de la visite de la page stats, le site n'affiche qu'un message d'erreur indiquant un problème de droits pour accéder à /var/lib/awstats. De plus, la configuration apache du vHost indique une ligne de type :
AssignUserID user user
Solution
Ajouter des droits d'accès spécifiques au dossier /var/lib/awstats et aux fichiers qu'il contient :
chmod -R 775 /var/lib/awstats
Discussion