Installation par un webmaster



Pas de restriction à ce niveau car vous avez le controle complet sur votre serveur ! Les scripts peuvent être tout aussi bien être installés dans votre répertoire cgi-bin ou au niveau de l'arborescence de votre site Web. La première solution étant tout de même plus conseillée.

Répertoire
cgi-bin

1.1 - Téléchargez l'application W3Perl sur votre serveur. Placez là au niveau de la racine de votre serveur Web.

1.2 - Décompressez l'application et désarchivez les fichiers. Cela va créer un répertoire /w3perl/ au sein de votre arborescence. Ce répertoire sera nommé DIR_STAT par la suite. (Vous pouvez changer le nom de ce répertoire à votre convenance).

1.3 - Donnez les permissions d'exécution aux scripts (chmod +x *.pl) [Unix uniquement]

1.4 - Editez le fichier fixperlpath.pl pour refléter l'endroit où se trouve l'exécutable Perl sur la machine de votre hébergeur (la plupart utilise /usr/local/bin/perl). Les sites Web hébergés sous NT devront également modifier la deuxième ligne de fixperlpath.pl pour rendre compte de l'endroit où se trouvera situé le fichier libw3perl.pl dans le répertoire cgi-bin sur la machine de votre hébergeur. Les sites sous Unix et NT devront modifié la troisième ligne afin de refléter l'endroit de votre répertoire de statistiques (DIR_STAT) sur la machine de votre hébergeur.

1.5 - Créez un sous répertoire w3perl au sein de votre répertoire cgi-bin. Déplacez tous les scripts depuis /DIR_STAT/ vers ce sous-répertoire et ajoutez y aussi les scripts que vous trouverez dans /DIR_STAT/cgi-bin/w3perl/. Si vous ne pouvez pas créer de sous répertoire au sein de votre répertoire cgi-bin, vous devrez alors modifier tous les liens des fichiers /DIR_STAT/admin/.

1.6 - Utilisez votre fureteur préféré et allez sur l'URL suivante www.votresiteweb.com/DIR_STAT/admin/ où www.votresiteweb.com est l'adresse de votre site web. L'interface d'administration de w3perl devrait alors apparaitre.

1.7 - Sélectionnez ''Customization' dans la section 'W3Perl Launch' qui va mettre à jour les chemins dans tous les scripts. Une autre manière d'effectuer cette opération est de lancer fixperlpath.pl depuis votre répertoire

1.8 - Maintenant un petit retour en arrière et sélectionnez 'Make configuration file' et remplissez les différents formulaires. Vous devrez apparavant avoir déplacer le fichier config.pl vers un autre nom de fichier sinon les formulaires vous avertirons de la présence actuelle d'un fichier de configuration.

1.9 - C'est terminé ! Il ne reste plus qu'à lancer les scripts.
- Si vous êtes sûr de vos choix, les sites sous Unix peuvent sélectionner 'Initialization' qui va lancer tous les scripts de stats automatiquement. (soyez patient si votre fichier de log est très gros et/ou la machine est lente ou utilisez un fichier de log restreint de plus petite taille pour un premier test). Les sites sous NT devront lancer les scripts un par un dans la section 'First use', sélectionnez en premier lieu 'Documents stats', puis 'Main stats' et finalement tous les autres.
Des messages seront affichés vous permettant ainsi de suivre les différentes parties des calculs. Si une erreur survient, vérifiez votre fichier de configuration ou si rien n'est affiché, téléchargez le fichier error_log pour examiner ce qui ne va pas.

- Si vous préférez d'abord testé les options que vous avez choisies, séelectionnez cron-hour.pl dans l'interface d'administration. Si la sortie vous plait, vous pouvez alors lancer cron-pages.pl qui va initialiser les premières statistiques. (soyez patient si votre fichier de log est très gros et/ou la machine est lente ou utilisez un fichier de log restreint de plus petite taille pour un premier test). Il est toujours possible de lancer les scripts via la ligne de commande également pour voir les messages internes apparaitre au fur et à mesure.

1.10 - Si tout est ok, editez le fichier cron-w3perl.pl, choississez quand vous désirez lancer les différents scripts et finalement ajoutez ce script dans votre crontab. Si vous le lancez en ligne de commande avec l'option -a, cron-w3perl.pl va calculer toutes les statistiques pour vous d'un seul coup.


Répertoire
du serveur

Les scripts peuvent être installés au niveau de la racine de votre serveur Web à la place du répertoire cgi-bin. Mais pour pouvoir utiliser l'interface d'adminstration à distance, il vous sera nécessaire de déplacer les scripts de /DIR_STAT/cgi-bin/w3perl/ vers votre répertoire /cgi-bin/w3perl/.
Il s'agit d'une possibilité offerte aux personnes ne disposant pas de répertoire cgi-bin par défaut mais cela n'est pas très utile pour une installation par un webmaster !


Conseil
1 - Lisez avec attention la documentation. De nombreuses questions sont résolues, utilisez également l'option -h pour plus d'informations au niveau de chaque script.

2 - Les sites sous NT ne peuvent pas utiliser cron-w3perl.pl car NT est incapable de forker des processes. Mais la commande 'at' peut faire office de lancement automatique.

3 - Vous pouvez créer autant de fichiers de confguration que vous le souhaitez. Utilisez l'option -c pour les charger. Inutile donc d'installer l'application plusieurs fois.

4 - N'oubliez pas que de nombreuses options sont disponibles via les lignes de commande pour chaque script.

5 - Installez un mot de passe au niveau du répertoire /DIR_STAT/admin/ afin d'éviter que tout le monde puisse changer votre configuration.

back