
                   Le manuel utilisateur de l'interface Web
                                       
Gilles Lamiral

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

   Le logiciel Minotaure est un ordonnanceur général qui exécute des
   tests périodiquement sur un ensemble de services et déclenche des
   alarmes en cas de détection de problème.
   
   L'ordonnanceur peut être interrogé suivant un protocole simple (en
   mode teste) sur un port prédéfini.
   
   L'interface est basé sur ce protocole. Le script CGI (Common Gateway
   Interface) interroge l'ordonnanceur et présente les résultat sous le
   standard HTML.
   
   Pour comprendre l'interface Web, il faut penser à la hiérarchie
   suivante:
     * L'ordonnanceur surveilles des groupes.
     * Les groupes sont constitués d'items.
     * Ces items peuvent être des machines présentées par leur nom ou
       leur adresse IP, ou tout autre chose, des répertoires par exemple.
     * Sur chaque groupe d'items, l'ordonnanceur surveille un ou
       plusieurs services.
     * Avec chaque service, l'ordonnanceur peut déclencher une ou
       plusieurs alarmes.
       
2. Présentation générale

     * Un tableau de configuration appelé ``Préférences''.
     * 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 préférence

   [INLINE]
   
   CAPTION: La configuration
   
   Avec le menu déroulant Rafraîchissement, vous sélectionnez le taux de
   rafraîchissement de la page. Ce taux de rafraîchissement est
   complètement indépendant des intervalles de test des services.
   
   Avec le menu déroulant langage vous sélectionnez le langage utilisé
   dans la page.
   
   Avec les boutons appelés ``État'', ``Historique'', ``Clients''
   ou``Alias'', Vous sélectionnez 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''
          testées. Les machines dont les tests sont en suspend sont
          sélectionnées. Vous pouvez selectionner ou déselectionner
          certaines machines mais cela ne fera rien. Le mécanisme de
          suspension des machines n'est pas encore implémenté 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 posséder
          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 résumé du dernier échec.
          Si le dernier test a échoué la cellule a un fond rouge et
          contient le mot échec suivi par un résumé de cet échec,
          typiquement le nom des machines qui n'ont pas passé le test
          avec succes.
          
   Légende 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 même 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 présentés suivant l'ordre suivant: rouge,
            bleu , et alphabéthique.
          + Pour chaque groupe, les services sont présentés suivant
            l'ordre suivant : rouge, bleu , jaune et alphabéthique.
            
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 détail d'un client, sélectionnez le dans la colomne
   ``Liste'' et cliquez sur le bouton Envoyer. Vous pouvez effectuer une
   sélection multiple.
   
   [INLINE]
   
   CAPTION:
   Le tableau des clients
   
   Pour sélectionner ou déselectionner 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 déroulant Filtre. Les dernières alertes intervenues dans
   l'intervale choisi sont affichées sur un fond blanc cassé.
