<!doctype linuxdoc system>

<!-- Welcome in the SGML world -->

 <article>
  
   <title>Le  manuel utilisateur de l'interface Web
   <author><url 
      name="Gilles Lamiral" 
      url="mailto:lamiral@mail.dotcom.fr">
   <date>v0.1, 19 Novembre 1998
    
   <abstract>
    Ce document d&eacute;crit l'utilisation de l'interface HTML du logiciel
    Minotaure  <em>minotaur.cgi</em>.
   </abstract>
   
  <toc>
  <sect>Principes
   <p>
    Le logiciel Minotaure est un ordonnanceur  g&eacute;n&eacute;ral qui ex&eacute;cute des
    tests p&eacute;riodiquement sur un ensemble de services et d&eacute;clenche des
    alarmes en cas de d&eacute;tection de probl&egrave;me.

    L'ordonnanceur peut &ecirc;tre interrog&eacute; suivant un protocole simple (en
    mode teste) sur un port pr&eacute;d&eacute;fini.

    L'interface est bas&eacute; sur ce protocole. Le script CGI (Common
    Gateway Interface) interroge l'ordonnanceur et pr&eacute;sente les
    r&eacute;sultat sous le standard HTML.

    Pour comprendre l'interface Web, il faut penser &agrave; la hi&eacute;rarchie
    suivante: 
    <itemize>
     <item>L'ordonnanceur surveilles des groupes. 

      <p><item>Les groupes sont constitu&eacute;s d'items.

      <p><item>Ces items peuvent &ecirc;tre des machines pr&eacute;sent&eacute;es par leur nom 
      ou leur adresse IP, ou tout autre chose, des r&eacute;pertoires par
      exemple.

      <p><item>Sur chaque groupe d'items, l'ordonnanceur surveille un ou
      plusieurs services.

      <p><item>Avec chaque service, l'ordonnanceur peut d&eacute;clencher une 
      ou plusieurs alarmes.

    </itemize>
    
   <sect>Pr&eacute;sentation g&eacute;n&eacute;rale
    <p>
     <itemize>
     <item>Un tableau de  configuration appel&eacute; ``Pr&eacute;f&eacute;rences''.
       
      <p><item>Un tableau d'&Eacute;tat appel&eacute; ``&Eacute;tats''.

      <p><item>Un tableau d'alias appel&eacute;  ``Alias'' ou ``Clients''
      
      <p><item>Un tableau  historique appel&eacute;  ``Historique''.

      <p><item>Une barre de liens au dessus de chaque tableau.

     </itemize>
  

   <sect>Le tableau de pr&eacute;f&eacute;rence
    <p>
      <figure>
      <eps file="./preferences-fr.jpg">
       <img src="./preferences-fr.jpg">
       <caption>La configuration</caption>
      </figure>
   
    Avec le menu d&eacute;roulant <bf>Rafra&icirc;chissement</bf>, vous
    s&eacute;lectionnez le taux de rafra&icirc;chissement de la page. Ce taux de
    rafra&icirc;chissement est compl&egrave;tement ind&eacute;pendant des intervalles de
    test des services.

    Avec le menu d&eacute;roulant <bf>langage</bf> vous s&eacute;lectionnez le
    langage utilis&eacute; dans la page.

    Avec les boutons appel&eacute;s ``<bf>&Eacute;tat</bf>'',
    ``<bf>Historique</bf>'', ``<bf>Clients</bf>''
    ou``<bf>Alias</bf>'', Vous s&eacute;lectionnez les tableaux que vous
    voulez afficher.

   
  <sect>Le tableau &Eacute;tat
   <p>
    <figure>
     <eps file="./status-fr.jpg">
     <img src="./status-fr.jpg">
     <caption><newline><em>Le tableau &Eacute;tat</em></caption>
    </figure>
    
    <descrip>
     
     <tag/La colonne ``host''./ Cette colonne contient la liste de
     toutes les ``machines'' test&eacute;es. Les machines dont les tests sont
     en suspend sont s&eacute;lectionn&eacute;es. Vous pouvez selectionner ou
     d&eacute;selectionner certaines machines mais cela ne fera rien. Le
     m&eacute;canisme de suspension des machines n'est pas encore impl&eacute;ment&eacute;
     sur le CGI.
     
     <tag/La colonne ``groupe''./ Cette colonne donne le nom des
     groupes de machines.

     <tag/La colonne  ``Membres''./ Cette colonne les listes des
      machines composant chaque groupe, une liste par groupe.
     cell.
     
     <tag/La colomne ``Service''./ Cette colomne nomme les
      services. Un groupe peut poss&eacute;der  plusieurs  services.
     
     <tag/Les colomnes  ``Dernier &agrave;'' and ``Prochain dans''./ La
      cellule  ``Dernier &agrave;'' mentionne l'heure du dernier test
      effectu&eacute;. La colomne  ``Prochain dans'' mentionne le temps
      restsnt avant le prochain test.

     <tag/La colomne  ``&Eacute;tat''./ La colomne ``&Eacute;tat'' contient l'&eacute;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&eacute;sum&eacute; du dernier &eacute;chec. Si le dernier test a &eacute;chou&eacute; la cellule
      a un fond  rouge et contient le mot &eacute;chec suivi par un r&eacute;sum&eacute; de 
      cet &eacute;chec, typiquement le nom des machines qui n'ont pas pass&eacute;
      le test avec succes. 
      
     <tag/L&eacute;gende des couleurs./
      <itemize>

       <item>Quand Tout va bien, aucune couleur n'apparait.
	
	<p><item>Quand un service est tomb&eacute;, le service et son groupe
	passent au rouge.  Les services du m&ecirc;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.
     
	<p><item>Quand un service n'est pas encore test&eacute; la cellule a
	un fond jaune.
     
	<p><item>Quund un service est inhib&eacute; la cellule a un fond bleu.
     
	<p><item>Les groupes sont pr&eacute;sent&eacute;s suivant l'ordre suivant:
	rouge, bleu , et alphab&eacute;thique.

	<p><item>Pour chaque groupe, les services sont pr&eacute;sent&eacute;s
	suivant l'ordre suivant : rouge, bleu , jaune et
	alphab&eacute;thique.
       
      </itemize>
    </descrip>

  <sect>Le tableau des clients
   <p>
    
    
    <figure>
     <eps file="./aliasEmpty-fr.jpg">
     <img src="./aliasEmpty-fr.jpg">
     <caption><newline><em>Le tableau des clients</em></caption>
    </figure>
    
    By default, the aliases table lists the aliases in the first
    colomn but does not detail each alias.

    <figure>
     <eps file="./aliasMore-fr.jpg">
     <img src="./aliasMore-fr.jpg">
     <caption>The non-empty aliases table</caption>
    </figure>
    
    Pour voir le d&eacute;tail d'un client, s&eacute;lectionnez le dans la colomne
    ``Liste'' et cliquez sur le bouton  <bf>Envoyer</bf>. Vous pouvez
    effectuer une s&eacute;lection multiple. 



    <figure>
     <eps file="./aliasFull-fr.jpg">
     <img src="./aliasFull-fr.jpg">
     <caption><newline><em>Le tableau des clients</em></caption>
    </figure>

    Pour s&eacute;lectionner ou d&eacute;selectionner tous les clients, vous
    utilisez les boutons radio ``tous'' ou ``aucun'' et cliquez sur le
    bouton <bf>Envoyer</bf>.
    

  <sect>Le tableau historique
   <p>
    
    <figure>
     <eps file="./historic-fr.jpg">
     <img src="./historic-fr.jpg">
     <caption>Le tableau historique</caption>
    </figure>

    En rouge, les alertes. En vert, les alerts.

    Vous choisissez le nombre de lignes &agrave; afficher dans le champs
    <bf>Nb lignes</bf>. Pour mettre en &eacute;vidence les dernieres alertes,
    utilisez le menu d&eacute;roulant <bf>Filtre</bf>. Les derni&egrave;res alertes
    intervenues dans l'intervale choisi sont affich&eacute;es sur un fond
    blanc cass&eacute;.

 </article>

