Ce post détaille les différentes étapes pour installer et configurer le système de statistiques Awstats dans votre espace web. Toutes les explications qui suivent vous aideront à mettre en route Awstats et à installer une tâche Cron pour un hébergement chez 1and1. Ces explications s’appliquent également à tout autre hébergeur à quelques modifications près.

1. » Installation d’Awstats sur votre serveur.
2. » Configuration d’Awstats.
3. » Tests de fonctionnement de l’application.
4. » Automatisation de la mise à jour avec une tâche Cron.

 Etape 0 : Informations nécessaires.
Avant de commencer, vous devez être en possession des informations suivantes :

• Pour la connexion FTP : adresse de l’hôte, login, mot de passe
• Pour la connexion au serveur via Perl chez 1and1 : /kunden/homepages/xx/dxxxxxxxx/htdocs/ où les « x » sont remplacés par des chiffres. Si vous ne connaissez pas ces chiffres, ouvrez un fichier .htaccess sur votre serveur 1and1.
• Pour l’accès console, vous devez posséder un accès SSH. Cet accès vous fournit une adresse de connexion, un login et un mot de passe.

 Etape 1 : Installation d’Awstats sur votre serveur.
1.1 » Téléchargez la dernière version d’Awstats sur le site http://awstats.sourceforge.net/. La version actuelle est la 6.7 publiée le 3 juillet 2007. Préférez télécharger le fichier ZIP pour le décompresser sur votre ordinateur ou le fichier TAR.GZ pour une décompression sur votre serveur (manipulation non détaillée ici).

1.2 » Nous allons décompresser et envoyer les fichiers éxécutables d’Awstats sur votre serveur Web.

• Décompressez votre archive avec votre logiciel favori (WinZip, WinRar, 7-Zip,…) sur votre ordinateur.
• Connectez-vous à votre serveur web via un logiciel de transfert de fichiers (FileZilla ou autre FTP).
• Copiez le contenu du dossier wwwroot de votre machine à la RACINE de votre serveur.

De nouveaux dossiers apparaissent alors à la racine de votre serveur : cgi-bin, css, icon et js.
1.3 » Création de votre fichier de configuration.
Sur votre ordinateur, naviguez jusqu’au dossier cgi-bin et repérez le fichier awstats.model.conf. Copiez ce fichier et renommez-le de la façon suivante en remplacant monsite.com par l’adresse de votre site (sans www) : awstats.monsite.com.conf

 Etape 2 : Configuration d’Awstats.
La configuration d’Awstats est une partie importante. Suivez bien les indications suivantes :
Le fichier de configuration d’Awstats est le fichier que nous venons de créer » awstats.monsite.com.conf. Ouvrez ce fichier avec n’importe quel éditeur texte comme Bloc Notes, Wordpad, Scite ou UltraEdit. Evitez de l’ouvrir avec des traitements de texte puissants tels Microsoft Word ou OpenOffice Writer.
Les lignes suivantes sont à modifier :
2.1 » Définition de l’emplacement du fichier journal (ici pour 1and1) :
Cette ligne récupère le fichier de log correspondant à la semaine du type access.log.37.gz.
LogFile="gzip -d </kunden/homepages/xx/dxxxxxxxx/htdocs/logs/access.log.%WY-168.gz|"
2.2 » Type de fichier annalysé :
W – pour un fichier journal Web, S – pour un fichier journal de Streaming, M – pour un fichier journal Mail ou F – pour un fichier journal FTP.
LogType=W
2.3 » Définition du format du fichier journal :
L’exemple suivant est valable pour le fichier journal émis par 1and1. Pour les autres serveurs se référer à votre service technique. Le code doit être érit sur une seule et même ligne.
LogFormat="%host - %logname %time1 %methodurl %code %bytesd %virtualname
%refererquot %uaquot "-""
2.4 » Nom de domaine :
Tapez le nom de domaine de votre site.
SiteDomain="www.monsite.com"
2.5 » Alias du domaine :
HostAliases="www.monsite.com"
2.6 » Dossier de stockage de la base de statistiques :
Le dossier data doit être préalablement créé sur votre serveur.
DirData="/kunden/homepages/xx/dxxxxxxxxxx/htdocs/cgi-bin/data"
2.7 » Dossier cgi-bin :
Pour les clients 1and1 :
DirCgi="http://sxxxxxxxxx.onlinehome.fr/cgi-bin"
ou
DirCgi="http://www.monsite.com/cgi-bin"
2.8 » Mise à jour depuis le Web :
Vous permet de mettre à jour vos statistiques à partir de l’interface Web.
AllowToUpdateStatsFromBrowser=1
2.9 » Accès restreint :
Si à « 1″, seuls les utilisateurs authentifiés pourront accéder à Awstats.
AllowAccessFromWebToAuthenticatedUsersOnly=1
2.10 » Utilisateurs autorisés :
Liste des utilisateurs autorisés par le fichier .htaccess. Noms séparés par [espace].
AllowAccessFromWebToFollowingAuthenticatedUsers="michel bernard marie"

 Etape 3 : Tests de fonctionnement.
Connectez-vous à votre site web par votre navigateur en tapant l’adresse ressemblant à celles-ci :
Pour les clients 1and1 » http://sxxxxxxxxx.onlinehome.fr/cgi-bin/awstats.pl&config=monsite.com
Pour les autres » http://www.monsite.com/cgi-bin/awstats.pl&config=monsite.com

Pour mettre à jour votre base, cliquez sur « Mise à jour immédiate ».

Si des erreurs apparaissent :

• Vérifiez le fichier de configuration créé à l’étape 2.
• Vérifiez la présence du dossier data dans le dossier cgi-bin.
• Vérifiez que le fichier de journal auquel vous souhaitez accéder existe (chemin erroné ou fichier inexistant).

 Etape 4 : Automatisation de la mise à jour avec une tâche Cron.
Pour mettre en place une tâche Cron, nous allons utiliser un outil pour se connecter à la console de commande de votre serveur.
Pour commencer, téléchargez Putty qui va nous permettre de nous connecter à la console.
Lancez le logiciel Putty et dans le champ Hôte taper l’adresse de l’hôte de votre accès SSH. Cliquez sur Ouvrir.
Première information demandée dans la console, votre nom d’utilisateur, de la forme uxxxxxxx chez 1and1.Validez par Entrée. Tapez ensuite votre mot de passe en terminant par la touche Entrée. Lorsque vous tapez votre mot de passe, celui-ci n’apparait pas même sous formes d’étoiles. Une fois ces étapes effectuées, la dernière ligne de la console doit ressembler à celle-ci :
uxxxxxxx >
Pour ouvrir l’éditeur de tâches Cron, tapez :
uxxxxxxx > crontab -e
Une fois l’éditeur ouvert, vous allez devoir définir votre tâche Cron de la façon suivante :
mm hh jj MMM JJ tache
mm représente les minutes (de 0 à 59).
hh représente l’heure (de 0 à 23).
jj représente le numéro du jour du mois (de 1 à 31).
MMM représente le numéro du mois (de 1 à 12).
JJJ représente le chiffre correspondant au jour de la semaine (0 représente le dimanche, 1 pour lundi, …).
Pour lancer une tâche à 2h30 chaque lundi quelque soit le jour ou le mois, tapez :
30 02 * * 1 tache
Dans le cas de notre configuration, il faut mettre à jour nos statistiques chaque lundi à 1h00. La commande à taper dans l’éditeur est la suivante pour 1and1 ou similaire pour les autres.
Le code doit être érit sur une seule et même ligne :
00 01 * * 1 perl /kunden/homepages/xx/dxxxxxxxx/htdocs/cgi-bin/awstats.pl
-config=monsite.com -update
Pour quitter l’éditeur et enregistrer votre tâche, appuyez sur Ctrl + C pour quitter le mode INSERT, ensuite tapez :w! pour enregistrer la tâche, puis :q pour quitter l’éditeur. Pour terminer, entrez la commande suivante :
uxxxxxxx > exit
Vous pouvez aller vous coucher tranquillement le dimanche et voir le résultat le lundi matin en vous connectant à votre site, pour consulter Awstats.

Si vous avez quelque problème que se soit, n’hésitez pas à poser vos questions via le formulaire ci-dessous.
Sources: Wikipedia, Alex Schultz