Installation pour Webmestre

Les étapes sont les suivantes pour installer W3Perl : extraction du logiciel, édition du script d'installation, lancement de ce script et g7eacute;nération d'un fichier de configuration pour paramétrer vos sorties.
Répertoire d'installation de W3Perl
Votre répertoire cgi-bin

Téléchargez W3Perl. Décompressez le à la racine de votre serveur Web (les fichiers de W3Perl doivent être lisibles depuis un navigateur Web), un répertoire /w3perl/ sera ainsi crée.

1.2 - Permission

Les scripts doivent avoir les droits en exécution (chmod +x *.pl)
Deux répertoires doivent être en lecture/écriture par le serveur Web si vous désirez utiliser l'interface d'administration par le Web : /w3perl/config/ ainsi que /w3perl/resources/admin/. Si ce n'est pas le cas, un chmod 777 sur ces deux répertoires réglera le problème.

1.3 - Installation

• Automatique
  Si vous utilisez un serveur Apache, le script d'installation est capable d'extraire les informations nécessaires depuis vos fichiers de configuration d'Apache. Il faut dans ce cas, lancer le script avec l'option -a comme ceci : 'install.pl -a'. Le script installera alors W3Perl sur le serveur principal trouvé dans la configuration d'Apache (vos fichiers de configuration doivent alors être en lecture).

• Manuellement
  Editez le script install.pl et Modifiez si besoin est l'emplacement de Perl présent sur la première ligne. . Ensuite, changez les variables $pathcgi ainsi que $pathw3perl selon votre machine. $pathcgi est l'emplacement où les scripts de W3Perl seront installés, quelque chose comme : /path_to_your_cgi-bin/cgi-bin/w3perl/. $pathw3perl est l'emplacement où W3Perl a éé installé : /path_to_your_server_root/w3perl/
  Lancez le script install.pl
  Si votre répertoire cgi-bin est en root, il faut soit lancer le script en root, soit changer les droits de ce répertoire.

1.4 - Fichier de configuration

Utilisez votre navigateur préféré et rendez vous à cette adresse http://localhost/w3perl/admin/ où localhost est le nom de votre serveur Web. L'interface d'administration de W3Perl devrait apparaitre.
Selectionnez 'Make configuration file' et remplissez les différents champs. Utilisez le nom du fichier de configuration par défaut. Une fois terminé, ce fichier doit être copié (et non pas déplacé !) dans le répertoire cgi de W3Perl /path_to_your_cgi-bin/cgi-bin/w3perl/ (car le serveur n'a pas les droits en principe pour écrire dans ce répertoire pour des raisons de sécurité) En cas de problème, il est toujours possible de remplir un fichier de configuration manuellement à partir des exemples fournis.

1.5 - Lancement des stats

Maintenant vous êtes prêt pour lancer W3Perl ! Vous pouvez utiliser 'Launch scripts' à partir de l'interface d'administration et cliquer sur le script que vous désirez executer ou utiliser la ligne de commande pour lancer les stats. A vous de choisir. L'utilisateur Web et vous-meme ayant des droits différents, il n'est pas conseillé de mélanger ces deux types de lancement.

1.6 - Crontab

Si tout vous semble parfait, editez le script cron-w3perl.pl et choississez quelles stats vous désirez avoir et ajoutez ce script dans votre crontab. L'option -a permet de mettre à jour toutes vos stats automatiquement.

2 - Si vous avez plusieurs sites web sur la même machine, inutile d'installer W3Perl plusieurs fois (voir l'installation pour les virtual host).

3 - Vous pouvez avoir autant de fichiers de configuration que vous le désirez. Il convient alors de les charger avec l'option -c.

4 - N'oubliez pas de protéger avec un mot de passe votre répertoire d'administration /w3perl/admin/ pour éviter que tout le monde puisse modifier votre configuration.

5 - Si vous ne pouvez pas créer un sous-répertoire w3perl au sein de votre répertoire cgi-bin, il vous faudra alors éditer tous les fichiers de /w3perl/admin/ et changez les liens de /cgi-bin/w3perl/ vers /cgi-bin/

6 - Si vous rencontrez des 'Internal error' , cela a probablement un rapport avec les droits d'acces aux fichiers. Jetez un coup d'oeil aux dernières lignes de votre fichier error_log dans ce cas pour en savoir plus.