Différences

Ci-dessous, les différences entre deux révisions de la page.

--- informatique:linux:awstats [2010/10/13 13:09] – benoit
+++ informatique:linux:awstats [2010/11/10 05:23] (Version actuelle) – benoit
@@ Ligne 1: / Ligne 1: @@
 ===== AWSTATS =====
-Procédure validée sous Debian 5
+AWSTATS est un outil de génération de statistiques Web accessible en ligne.
-Ce tutoriel décrit l'installation d'awstats pour plusieurs sites avec accès restreint.
+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 :
@@ Ligne 12: / Ligne 14: @@
   mv awstats-6.95 awstats
-==== Configuration ====
+==== Configuration générale ====
 === AWStat ===
@@ Ligne 20: / Ligne 22: @@
   * 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.monsite.com
+  * 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
@@ Ligne 26: / Ligne 28: @@
 Se référer au tutoriel [[apache]] pour une configuration optimisée.
-Par exemple pour un Virtual Host dédié aux statistiques créer un fichier avec la configuration suivante :
+Ajouter la section suivante dans votre configuration du serveur [[apache]] soit dans un Virtual Host ou dans la configuration principale :
-  <VirtualHost *:80>
-        ServerName stat.monsite.com
-        ServerAdmin webmaster@localhost
         #
         # Directives to allow use of AWStats as a CGI
@@ Ligne 50: / Ligne 47: @@
                 Allow from all
         </Directory>
-  </VirtualHost>
-Sinon contentez vous de la configuration suivante :
+Créer maintenant le fichier d'authentification /usr/local/awstats/wwwroot/.htaccess" et insérer les lignes suivantes :
-        #
+  AuthUserFile "/usr/local/awstats/.htpasswd"
-        # Directives to allow use of AWStats as a CGI
+  AuthName "Acces Restreint"
-        #
+  AuthType Basic
-        Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
+  require valid-user
-        Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
-        Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
+Créer le fichier mot de passe avec un premier compte **adimstat** en lançant la commande suivante :
-        ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"
+  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
-        # This is to permit URL access to scripts/files in AWStats directory.
+  SiteDomain="www.monsite1.com"
-        #
+  HostAliases="monsite1.com www.monsite1.com"
-        <Directory "/usr/local/awstats/wwwroot">
-                Options None
+  # Répertoire de stockage des rapports statistiques, qu'il faudra créer
-                AllowOverride AuthConfig
+  DirData="/var/lib/awstats"
-                #AllowOverride None
-                Order allow,deny
+  # Pour indiquer que l'accès au rapport statistique nécessite une authentification.
-                Allow from all
+  # 0=accès libre
-        </Directory>
+  # 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"
-==== Configuration des statistiques d'un site ====
-Créer les répertoires manquant de l'installation :
+Créer le répertoire de stockage des rapports statistiques :
   mkdir /var/lib/awstats
-Corriger un problème de chemin dans la configuration d'apache en ajoutant la ligne ci-dessous dans le fichier ''/etc/apache2/conf.d/awstats.conf'' :
+Créer l'utilisateur autorisé à consulter le rapport :
-  Alias /icon "/usr/local/awstats/wwwroot/icon/"
+  htpasswd /usr/local/awstats/.htpasswd user_site1
-Dans **/etc/awstats/** il faut créer un fichier de configuration par site. le nom doit être sous le format : **awstats.<site>.conf**
+Suivre la même procédure pour les autres sites en modifiant les paramètres.
-==== Génération de statistiques ====
+==== 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.site2.com.conf** lancer
+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.site2.com -update
+  perl /usr/local/awstats/wwwroot/cgi-bin/awstats.pl -config=www.monsite1.com -update
-A planifier pour chaque site dans [[crontab]]
+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.site2.com
+  http://stats.serveur.com/awstats/awstats.pl?config=www.monsite1.com