Différences

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

--- informatique:linux:awstats [2010/10/13 13:00] – 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 du service Web Apache ====
+==== 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
-  touch /etc/apache2/conf.d/awstats.conf
+=== Apache ===
+Se référer au tutoriel [[apache]] pour une configuration optimisée.
-Pour l'emplacement du fichier de configuration d'apache indiquer :
+Ajouter la section suivante dans votre configuration du serveur [[apache]] soit dans un Virtual Host ou dans la configuration principale :
-  /etc/apache2/apache2.conf
+        #
+        # 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>
-Indiquer le nom du premier site web
+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
-Indiquer l'emplacement des fichiers de configuration :
+Créer le fichier mot de passe avec un premier compte **adimstat** en lançant la commande suivante :
-  /etc/awstats
+  htpasswd -c /usr/local/awstats/.htpasswd adminstat
-==== Post-installation ====
-Créer les répertoires manquant de l'installation :
+==== 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
-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
-==== Configuration des statistiques d'un site ====
+Suivre la même procédure pour les autres sites en modifiant les paramètres.
-Dans **/etc/awstats/** il faut créer un fichier de configuration par site. le nom doit être sous le format : **awstats.<site>.conf**
-==== 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