
                   Le manuel utilisateur de l'interface Web
                                       
Gilles Lamiral

   v0.1, 19 Novembre 1998
     _________________________________________________________________
   
   Ce document dcrit l'utilisation de l'interface HTML du logiciel
   Minotaure minotaur.cgi. 
     _________________________________________________________________
   
1. Principes

   Le logiciel Minotaure 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 teste) sur un port prdfini.
   
   L'interface est bas sur ce protocole. Le script CGI (Common Gateway
   Interface) interroge l'ordonnanceur et prsente les rsultat sous le
   standard HTML.
   
   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.
     * Avec chaque service, l'ordonnanceur peut dclencher une ou
       plusieurs alarmes.
       
2. Prsentation gnrale

     * Un tableau de configuration appel ``Prfrences''.
     * Un tableau d'tat appel ``tats''.
     * Un tableau d'alias appel ``Alias'' ou ``Clients''
     * Un tableau historique appel ``Historique''.
     * Une barre de liens au dessus de chaque tableau.
       
3. Le tableau de prfrence

   [INLINE]
   
   CAPTION: La configuration
   
   Avec le menu droulant Rafrachissement, vous slectionnez le taux 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 ``tat'', ``Historique'', ``Clients''
   ou``Alias'', Vous slectionnez les tableaux que vous voulez afficher.
   
4. 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 mais cela ne fera rien. Le mcanisme de
          suspension des machines n'est pas encore implment sur le CGI.
          
   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 colomne ``Service''.
          Cette colomne nomme les services. Un groupe peut possder
          plusieurs services.
          
   Les colomnes ``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 colomne ``tat''.
          La colomne ``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.
            
5. Le tableau des clients

   [INLINE]
   
   CAPTION:
   Le tableau des clients
   
   By default, the aliases table lists the aliases in the first colomn
   but does not detail each alias.
   
   [INLINE]
   
   CAPTION: The non-empty aliases table
   
   Pour voir le dtail d'un client, slectionnez le dans la colomne
   ``Liste'' et cliquez sur le bouton Envoyer. Vous pouvez effectuer une
   slection multiple.
   
   [INLINE]
   
   CAPTION:
   Le tableau des clients
   
   Pour slectionner ou dselectionner tous les clients, vous utilisez
   les boutons radio ``tous'' ou ``aucun'' et cliquez sur le bouton
   Envoyer.
   
6. 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.
