
                             PLGRENOUILLE


INSTALLATION

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

        plgrenouille fonctionne sous Linux 2.1.0 minimum
uniquement. Il ncessite un interprteur de langage Perl 5.00404 ou
suprieur; Il utilise galement la bibliothque libnet. Si cette
bibliothque, trs courante, n'est pas dj installe 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 rcuprer
les sources. L'installation peut tre automatise, et se rsumer 

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

sur un systme convenablement configur...

        Copiez ensuite les fichiers de ce paquetage dans un rpertoire
spar, par exemple /usr/local/plgrenouille;

        Ceci fait, crez le rpertoire /var/spool/plgrenouille de
faon  ce que l'utilisateur sous lequel tourne plgrenouille en
fonctionnement (normalement l'utilisateur "daemon", voir la variable
$USER vers le dbut de plgrenouille.pl) puisse y crer ces fichiers de
travail :

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

CONFIGURATION

        Placez vous dans le rpertoire 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 affiches.

        Ces renseignements seront alors stocks dans
/etc/grenouillerc. Vous pouvez les modifier directement, ou forcer
plgrenouille  redemander les paramtres de configuration avec la mme
commande.

        A noter qu'il est conseill de lancer plgrenouille --configure
aprs chaque mise  jour, au cas o de nouvelles options seraient
apparues entre temps.

        Une manire 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 rpertoire d'installation et lancez
simplement

       # ./plgrenouille.pl

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

DEMARRAGE AUTOMATIQUE AU BOOT

	Si vous utilisez des scripts de dmarrage 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 dmarrage style SystemV
(Slackware,... ?), il va falloir ajouter  la main l'excutable principal
dans vos scripts de dmarrage.

        plgrenouille cre 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
