====== Installation de AWStats ======
<label type="info">Création</label> --- //[[nekan@shyrkasystem.com|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.

<callout type="danger" icon="true" title="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.</callout>

===== Installation =====

  * On commence par mettre à jour ses dépôts apt :
<sxh bash>apt-get update</sxh>
  * Une fois les bases à jour, on peut installer les paquets nécessaires :
<sxh bash>apt-get install awstats libmldbm-perl libnet-xwhois-perl libgeo-ipfree-perl</sxh>
  * 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 :
<sxh bash>cd /etc/awstats/</sxh>
  * On duplique le fichier awstats.conf en lui ajoutant l'url de contact du vhost, par exemple pour www.shyrkasystem.com :
<sxh bash>cp awstats.conf awstats.www.shyrkasystem.com.conf</sxh>
  * Ensuite, il faut éditer le fichier créé :
<sxh bash>nano awstats.www.shyrkasystem.com.conf</sxh>
  * 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 :
<sxh bash>/usr/lib/cgi-bin/awstats.pl -config=www.shyrkasystem.com -update</sxh>
  * Si tout va bien et après quelques instants, la console affiche un message de ce type :
<sxh bash>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.</sxh>

==== 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 :
<sxh bash>nano /etc/apache2/sites-available/awstats.conf</sxh>
  * Nous le remplissons avec les informations suivantes :
<sxh bash>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></sxh>
  * 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 :
<sxh bash>htpasswd -c /var/www/.password nekan</sxh>
  * On renseigne le mot de passe comme demandé et on le confirme en suivant.
  * Il nous reste plus qu'à activer le site :
<sxh bash>a2ensite awstats</sxh>
  * Enfin, on recharge le service Apache :
<sxh bash>/etc/init.d/apache2 reload</sxh>

==== 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 :
<image shape="thumbnail">{{ :linux:awstats:auth.png |}}</image>
  * Une fois, l'authentification validée, on accède enfin aux statistiques :
<image shape="thumbnail">{{ :linux:awstats:awstats.png |}}</image>



==== Résolution des problèmes ====

=== Téléchargement d'un fichier txt/perl  ===

<panel type="danger" title="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.</panel>
<panel type="success" title="Solution">
Activez le module cgi d'apache et redémarrer apache
<sxh bash>a2enmod cgi
service apache2 restart</sxh>
</panel>

=== Erreur d'accès à /var/lib/awstats ===

<panel type="danger" title="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 :

<sxh bash>AssignUserID    user user</sxh>
</panel>

<panel type="success" title="Solution">
Ajouter des droits d'accès spécifiques au dossier /var/lib/awstats et aux fichiers qu'il contient :
<sxh bash>chmod -R 775 /var/lib/awstats</sxh>
</panel>

~~DISCUSSION~~