
              Le manuel utilisateur de l'interface web Minotaure
                                       
Gilles Lamiral

   v0.4, 17 mars 2000
     _________________________________________________________________
   
   Ce document dcrit l'utilisation de l'interface HTML du logiciel
   Minotaure. 
     _________________________________________________________________
   
1. Liens

   Le page de garde Minotaur et la dmonstration en ligne est disponible
    l'adresse http://www.linux-france.org/prj/minotaure/
   
   Une instance locale est peut-tre disponible  l'adresse
   ../../cgi-bin/minotaur.cgi.
   
   Toute question peut-tre pose sur la liste de diffusion de MON.
   Envoyer simplement votre question  mailto:mon@linux.kernel.org
   
   La page de garde de MONest http://www.kernel.org/software/mon
   
2. Principes

   Minotaure est un logiciel client pour le server MON. MON est un outil
   de supervision crit par Jim Trocki.
   
   Le logiciel MON est un ordonnanceur gnral qui excute des tests
   priodiquement sur un ensemble de services et dclenche des alarmes en
   cas de dtection de problme.
   
   L'ordonnanceur peut tre interrog suivant un protocole simple (en
   mode texte) sur un port prdfini (2583).
   
   L'interface est bas sur ce protocole. Le script CGI (Common Gateway
   Interface) interroge l'ordonnanceur et prsente les rsultat sous le
   standard HTML. Par souci d'efficacit, de simplicit, de compatibilit
   et de stabilit, les java, javascript, frame, et autres avatars du web
   ne sont pas utiliss.
   
   Pour comprendre l'interface Web, il faut penser  la hirarchie
   suivante:
     * L'ordonnanceur surveilles des groupes.
     * Les groupes sont constitus d'items.
     * Ces items peuvent tre des machines prsentes par leur nom ou
       leur adresse IP, ou tout autre chose, des rpertoires par exemple.
     * Sur chaque groupe d'items, l'ordonnanceur surveille un ou
       plusieurs services. Chaque service est test par un logiciel
       appel un moniteur.
     * Pour chaque service, l'ordonnanceur peut dclencher une ou
       plusieurs alarmes, quand un problme est detect.
       
3. Prsentation gnrale

   Tout est sur une seule page, compose de cinq partie, spares par une
   ligne. Ces parties sont nommes Infos, tat, Vue croise, Historique
   and Prfrences.
   
   Le titre de la page prsente le nom du serveur MON contact, suivi par
   le port utilis, la date et l'heure du serveur. Ce titre apparait dans
   le bandeau suprieur de la fentre, au dessus des menus de votre
   navigateur.
   
   Le haut de la page prsente le nom du serveur MON contact, la date et
   l'heure du serveur.
   
   Une barre de liens au dessus de chaque tableau permet de se dplacer
   rapidement dans les diffrentes sections de la page ou d'atteindre la
   prsente documentation.
   
   La partie infos est juste un emplacement o l'administrateur du
   logiciel renseigne des informations utiles, des liens vers d'autres
   pages, un logo etc.
   
   Le tableau tat prsente l'tat des diffrents services.
   
   Le tableau Vue Croise est utilise pour prsenter les information du
   tableau tat sous une forme compltement diffrente. Cette
   prsentation est choisie par l'administrateur du logiciel.
   
   Le tableau Historique prsente la liste des alertes gnres.
   
   Le tableau Prfrences est toujours prsent  la fin de la page. Ce
   tableau vous permet de choisir et conserver les options de
   prsentation ainsi que les information de login.
   
4. Le tableau des prfrences

   [INLINE]
   
   CAPTION: Le tableau des prferences
   
   Avec le menu droulant Rafrachissement, vous slectionnez le dlai de
   rafrachissement de la page. Ce taux de rafrachissement est
   compltement indpendant des intervalles de test des services.
   
   Avec le menu droulant langage vous slectionnez le langage utilis
   dans la page.
   
   Avec les boutons appels Infos, tat, Historique, Vue Croise, vous
   slectionnez les tableaux que vous voulez afficher.
   
   Les champs Utilisateur et Mot de Passe vous permettent de raliser des
   actions ncessitant une authentification sur le server MON.
   
5. Le tableau tat

   [INLINE]
   
   CAPTION: Le tableau tat
   
   La colonne ``host''.
          Cette colonne contient la liste de toutes les ``machines''
          testes. Les machines dont les tests sont en suspend sont
          slectionnes. Vous pouvez selectionner ou dselectionner
          certaines machines.
          
   La colonne ``groupe''.
          Cette colonne donne le nom des groupes de machines.
          
   La colonne ``Membres''.
          Cette colonne les listes des machines composant chaque groupe,
          une liste par groupe. cell.
          
   La colonne ``Service''.
          Cette colonne nomme les services. Un groupe peut possder
          plusieurs services. Le bouton HS permet de changer l'tat du
          service. Les alertes ne sont plus dclenches lorsque le
          service est bleu.
          
   Les colonnes ``Dernier '' and ``Prochain dans''.
          La cellule ``Dernier '' mentionne l'heure du dernier test
          effectu. La colomne ``Prochain dans'' mentionne le temps
          restsnt avant le prochain test.
          
   La colonne ``tat''.
          La colonne ``tat'' contient l'tat du service, une cellule par
          service. Si le dernier test a reussi alors la cellule est sans
          couleur (en gris) et le contenu est le rsum du dernier chec.
          Si le dernier test a chou la cellule a un fond rouge et
          contient le mot chec suivi par un rsum de cet chec,
          typiquement le nom des machines qui n'ont pas pass le test
          avec succes.
          
   Lgende des couleurs.
          
          + Quand Tout va bien, aucune couleur n'apparait.
          + Quand un service est tomb, le service et son groupe passent
            au rouge. Les services du mme groupe qui fonctionnent sont
            vert afin de bien faire la distinction entre ce qui
            fonctionne et ce qui ne fonctionne pas pour l'ensemble des
            machines du groupe.
          + Quand un service n'est pas encore test la cellule a un fond
            jaune.
          + Quund un service est inhib la cellule a un fond bleu.
          + Les groupes sont prsents suivant l'ordre suivant: rouge,
            bleu , et alphabthique.
          + Pour chaque groupe, les services sont prsents suivant
            l'ordre suivant : rouge, bleu , jaune et alphabthique.
            
6. Le tableau des clients

   [INLINE]
   
   CAPTION: Le tableau des clients, sans slection
   
   Par dfaut, la vue croise liste les alias dans la premire colonne
   mais ne dtaille rien.
   
   [INLINE]
   
   CAPTION: Le tableau des clients, une slection
   
   Pour voir le dtail d'un alias, slectionnez-le dans la colonne
   ``Liste'' et cliquez sur le bouton Envoyer. Vous pouvez effectuer une
   slection multiple.
   
   [INLINE]
   
   CAPTION: Le tableau des alias, tous slectionns
   
   Pour slectionner ou dselectionner tous les clients, vous utilisez
   les boutons radio ``tous'' ou ``aucun'' et cliquez sur le bouton
   envoyer.
   
7. Le tableau historique

   [INLINE]
   
   CAPTION: Le tableau historique
   
   En rouge, les alertes. En vert, les alerts.
   
   Vous choisissez le nombre de lignes  afficher dans le champs Nb
   lignes. Pour mettre en vidence les dernieres alertes, utilisez le
   menu droulant Filtre. Les dernires alertes intervenues dans
   l'intervale choisi sont affiches sur un fond blanc cass.
   
8. Licence

   Ce document est plac sous la licence
   http://www.opencontent.org/opl.shtml. Ceci signifie que ce document
   vous est livr sans garantie, que vous pouvez l'utiliser, le
   distribuer, le modifier  votre guise en respectant les conditions
   suivantes: vous devez clairement spcifier la nature et le contenu des
   modifications, leur date et conserver la licence OpenContent. Si vous
   le vendez, vous vendez le contenant, pas le contenu. Ceci est un
   rsum. Lisez compltement la licence (en anglais) pour obtenir plus
   de dtails. Une adaptation franaise existe
   http://www.linux-france.org/article/these/licence/OPL_FR.txt.
