
                             PLGRENOUILLE


INSTALLATION

        plgrenouille fonctionne sous Linux (noyau 2.1 minimum), et de
faon exprimentale sous FreeBSD (test avec la release 4.3 uniquement
pour l'instant). Il ncessite un interprteur de langage Perl 5.00404
ou suprieur; Il utilise galement les bibliothques libnet, Net::SNMP,
et Time::HiRes. Si ces bibliothques ne sont pas dj installes sur
votre ordinateur, et si elles ne sont pas disponibles sous forme de
paquetages pour votre distribution (libnet-perl, libnet-snmp-perl et
libtime-hires-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
          cpan> install Net::SNMP
          cpan> install Time::HiRes

sur un systme convenablement configur.

        plgrenouille utilise maintenant le protocole SNMP pour sonder
le rseau lors de ses tests. Si l'ordinateur hte est le seul
connect  la ligne haut dbit, il faudra installer un deamon snmpd,
et spcifier "localhost" comme hte SNMP. Si un rseau local est
connect par la ligne haut dbit, il faudra qu'une priphrique sur le
chemin de tous les paquets passant par la ligne haut dbit (en gnral
un routeur et/ou un firewall) supporte le protocole SNMP.


        Pour installer plgrenouille proprement dit, vous pouvez, si
vous tre tmraire, essayer "make install", aprs avoir jet un oeil
sur le Makefile pour vrifier que tous les chemins vous conviennent
(les valeurs par dfaut correspondent  une distribution Debian). Si
vous optez pour une installation manuelle, voici comment procder :

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

        Copiez le rpertoire Grenouille et tout son contenu dans l'un
des rpertoires d'inclusion par dfaut de Perl. Pour obtenir la liste
de ces rpertoires :

          $ perl -e 'print join("\n", @INC)'

        Par exemple pour copier Grenouille dans /usr/lib/perl5:

          # cp -av Grenouille /usr/lib/perl5

        Alternativement, si vous prfrez laisser les modules de
plgrenouille dans le rpertoire "priv" de plgrenouille, il vous
faudra  chaque fois ajouter ce rpertoire  la liste des rpertoires
d'inclusion, en ajoutant l'option -I au reste de la ligne de 
commande :

          # ./plgrenouille -I/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

	Si le fichier /etc/grenouillerc n'existe pas encore, crez le
avec les bons droits d'accs :

	  # touch /etc/grenouillerc
	  # chown daemon.root /etc/grenouillerc
	  # chmod 600 /etc/grenouillerc

        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. Vrifiez que celui-ci
conserve bien les droits de ce fichier, qui doit tre lisible par
plgrenouille, mais non accessible au "monde entier",  cause du mot de
passe qu'il contient.

UTILISATION

        Pour lancer plgrenouille et voir ce qu'il est en train de
faire, placez vous dans le rpertoire d'installation et lancez
simplement (en tant que root) :

       # ./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...

INTERRUPTION D'AUTRES PROGRAMMES

	Pour effectuer des mesures valides, les clients grenouille ont
besoin d'une activit rseau de fond rduite; Dans le cas contraire,
les mesures peuvent tre invalides. Si votre ligne est souvent
utilise, vous pouvez crer les scripts /etc/plgrenouille-before et
/etc/plgrenouille-after pour effectuer toutes les actions ncessaires
pour la librer temporairement (arrter ou stopper des daemons,...)


        Bonne surveillance !


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