===== AWSTATS =====
AWSTATS est un outil de génération de statistiques Web accessible en ligne.

Ce tutoriel, validé sous Debian 5, décrit l'installation d'awstats pour plusieurs sites avec accès restreint

==== Installation ====
Pré-requis : 
  apt-get install mergelog libgeoip1

Pour installer awstats lancer les commandes suivantes :
  cd /usr/local
  wget http://prdownloads.sourceforge.net/awstats/awstats-6.95.tar.gz
  tar xzf awstats-6.95.tar.gz
  mv awstats-6.95 awstats

==== Configuration générale ====

=== AWStat ===

Il faut lancer le scripts de configuration :
  /usr/local/awstats/tools/awstats_configure.pl

  * Ne pas valider la configuration automatique d'apache, nous le feront manuellement.
  * Indiquer le nom du premier site web pour créer le premier fichier de configuration, ex : www.monsite1.com
  * Indiquer l'emplacement des fichiers de configuration des sites : /etc/awstats

=== Apache ===
Se référer au tutoriel [[apache]] pour une configuration optimisée.

Ajouter la section suivante dans votre configuration du serveur [[apache]] soit dans un Virtual Host ou dans la configuration principale :
        #
        # Directives to allow use of AWStats as a CGI
        #
        Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
        Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
        Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
        ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"
  
        #
        # This is to permit URL access to scripts/files in AWStats directory.
        #
        <Directory "/usr/local/awstats/wwwroot">
                Options None
                AllowOverride AuthConfig
                #AllowOverride None
                Order allow,deny
                Allow from all
        </Directory>

Créer maintenant le fichier d'authentification /usr/local/awstats/wwwroot/.htaccess" et insérer les lignes suivantes :
  AuthUserFile "/usr/local/awstats/.htpasswd"
  AuthName "Acces Restreint"
  AuthType Basic
  require valid-user

Créer le fichier mot de passe avec un premier compte **adimstat** en lançant la commande suivante :
  htpasswd -c /usr/local/awstats/.htpasswd adminstat


==== Configuration des statistiques d'un site ====

Dans la précédente étape, le script de configuration d'AWStats a créer le premier fichier de configuration, ex : **/etc/awstats/awstats.www.monsite1.com.conf**.

Editer ce fichier pour paramétrer les statistiques du site www.monsite1.com. Les valeurs qui nécessitent une attention sont décrites ci-dessous :
  # zmergelog est un outil qui permet de consolider les fichiers log compressés et non compressés
  LogFile="zmergelog /var/log/apache2/access_www.monsite1.com.log* |"
  # Vous pouvez sinon simplement indiquer le nom exacte du fichier log pour un rapport quotidien
  LogFile="/var/log/apache2/access_www.site1.com.log"
  
  # Indiquer ici le nom du site et ses Alias
  SiteDomain="www.monsite1.com"
  HostAliases="monsite1.com www.monsite1.com"
  
  # Répertoire de stockage des rapports statistiques, qu'il faudra créer
  DirData="/var/lib/awstats"
  
  # Pour indiquer que l'accès au rapport statistique nécessite une authentification.
  # 0=accès libre
  # 1=accès restreint par mot de passe
  AllowAccessFromWebToAuthenticatedUsersOnly=1
  # Liste des utilisateurs autoriser à consulter le rapport. ici user_site1 et adminstat sont autorisé. Attention l'utilisateur doit figurer aussi dans .htpasswd
  AllowAccessFromWebToFollowingAuthenticatedUsers="user_site1 adminstat"
  # Plugin: GeoIP
  LoadPlugin="geoip GEOIP_STANDARD /usr/share/GeoIP/GeoIP.dat"


Créer le répertoire de stockage des rapports statistiques :
  mkdir /var/lib/awstats

Créer l'utilisateur autorisé à consulter le rapport :
  htpasswd /usr/local/awstats/.htpasswd user_site1

Suivre la même procédure pour les autres sites en modifiant les paramètres.

==== Génération de statistiques et planification ====
Pour générer les statistiques du site défini dans le fichier de configuration **/etc/awstats/awstats.www.monsite1.com.conf** lancer
  perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=www.monsite1.com -update

A planifier pour chaque site dans [[crontab]] à la fréquence que vous souhaitez.

==== Consulter les statistiques ====
Dans le navigateur les statistiques du site **www.site2.com** sont consultables à l'adresse :
  http://stats.serveur.com/awstats/awstats.pl?config=www.monsite1.com