
                             PLGRENOUILLE


INSTALLATION

	Il n'y a pas (encore ?) de script d'installation.

        plgrenouille fonctionne sous Linux 2.1.0 minimum
uniquement. Il nécessite un interpréteur de langage Perl 5.00404 ou
supérieur; Il utilise également la bibliothèque libnet. Si cette
bibliothèque, très courante, n'est pas déjà installée sur votre
ordinateur, et si elle n'est pas disponible sous forme de paquetage
pour votre distribution (libnet-perl pour Debian par exemple), vous
pouvez visiter le CPAN (http://www.perl.com/CPAN) pour en récupérer
les sources. L'installation peut être automatisée, et se résumer à

          # perl -MCPAN -e shell
          cpan> install Bundle::libnet

sur un système convenablement configuré...

        Copiez ensuite les fichiers de ce paquetage dans un répertoire
séparé, par exemple /usr/local/plgrenouille;

        Ceci fait, créez le répertoire /var/spool/plgrenouille de
façon à ce que l'utilisateur sous lequel tourne plgrenouille en
fonctionnement (normalement l'utilisateur "daemon", voir la variable
$USER vers le début de plgrenouille.pl) puisse y créer ces fichiers de
travail :

          # mkdir /var/spool/plgrenouille
          # chown daemon.root /var/spool/plgrenouille
          # chmod 755 /var/spool/plgrenouille

CONFIGURATION

        Placez vous dans le répertoire d'installation, puis lancez

          # ./plgrenouille.pl --configure

	Lors de ce premier lancement, le programme va vous demander un
certain nombre de renseignements, dont votre email, votre identifiant,
et votre mot de passe. Suivez simplement les instructions affichées.

        Ces renseignements seront alors stockés dans
/etc/grenouillerc. Vous pouvez les modifier directement, ou forcer
plgrenouille à redemander les paramètres de configuration avec la même
commande.

        A noter qu'il est conseillé de lancer plgrenouille --configure
après chaque mise à jour, au cas où de nouvelles options seraient
apparues entre temps.

        Une manière alternative de configurer plgrenouille est de
copier le fichier grenouillerc.sample fourni dans /etc/grenouillerc,
et d'utiliser votre éditeur de texte favori...

UTILISATION

        Pour lancer plgrenouille et voir ce qu'il est en train de
faire, placez vous dans le répertoire d'installation et lancez
simplement

       # ./plgrenouille.pl

        Si tout se passe bien, il n'y a rien à faire :) Juste ^C pour
l'arrêter.

DEMARRAGE AUTOMATIQUE AU BOOT

	Si vous utilisez des scripts de démarrage style SystemV
(RedHat, Mandrake, Debian, SuSE,...) vous pouvez copier le fichier
"grenouille" fourni dans /etc/rc.d/init.d (/etc/init.d pour Debian)
puis utiliser l'outil de configuration de votre distribution
(chkconfig --add grenouille pour RedHat,...)

        Si vous n'utilisez pas de scripts de démarrage style SystemV
(Slackware,... ?), il va falloir ajouter à la main l'exécutable principal
dans vos scripts de démarrage.

        plgrenouille crée un fichier de log dans
/var/log/plgrenouille.log, n'oubliez pas de faire une rotation de
temps en temps...

        Bonne surveillance !



La grenouille en ASCII art est l'oeuvre de Donna Shepherd
