Recent Changes - Search:

La commande MainThread

Utilisée sans argument où avec l'option --help (-h en version courte) la commande MainThread affiche un bref mode d'emploi.

La forme

 MainThread [-v | --version]

affiche la version du collecteur sous la forme netM[EA]Tcollector vN.M (aaaa-mm-jj) constituée d'un identifiant du collecteur, d'un numéro de version et de la date de génération de la distribution (le nom netM[EA]Tcollector a été choisi pour signifier que le collecteur est commun à netMET et netMAT).

Pour lancer le collecteur il faut utiliser la forme

 MainThread  --configuration  fichier --directory  répertoire  [option] ...

Les options sont :

   [-i | --identification]  nom_de_fichier
   [-B | --printFlowsBefore]
   [-A | --printFlowsAfter]
   [-r | --recover]         nom_de_fichier
   [-u | --supervision]     nom_de_fichier 
   [-o | --outputFile]      nom_de_fichier
   [-n | --nolog]  
   [-s | --start]

L'argument obligatoire --configuration (-c) précède le nom du fichier de configuration qui spécifie les paramètres de la collecte : port d'écoute des datagrammes et règles de filtrage déterminant les flux à conserver.

L'argument obligatoire --directory (-d) précède le nom du répertoire dans lequel seront placés le tube de commande du processus créé par MainThread et un fichier d'identification de ce processus lorsque l'option --identification (-i) est utilisée. Le nom suivant l'option --identification doit donc être un nom «local» (basename). Ce fichier d'identification contient le numéro du processus et le nom absolu du tube de commande séparés par une espace.

Les options -printFlowsBefore (-B) et --PrintFlowsAfter (-A) provoquent l'impression des flux respectivement avant et après filtrage. L'impression se fait dans le fichier spécifié par l'option --outputFile. Si cette option n'est pas utilisée, les impressions se font sur la sortie standard.

L'option --recover (-r) provoque l'initialisation des tables du collecteur par chargement du fichier spécifié.

L'option --supervision (-u) active l'écriture d'informations de service dans le fichier spécifié à chaque fois que les tables du collecteur sont sauvegardées par les commandes --dump (-d) ou --temporaryDump (-t) du pilote (MonitorMain) . Ces informations sont, dans l'ordre et à raison d'un nombre (écriture décimale) par ligne :

  • la date de collecte (Unix time)
  • le nombre de datagrammes lus,
  • le nombre de datagrammes collectés (i.e. provenant de routeurs écoutés),
  • le nombre de datagrammes perdus,
  • le nombre de flux analysés,
  • le nombre de flux retenus après filtrage,
  • le nombre de flux effectivement comptabilisés (ce nombre doit être égal au précédent),
  • le nombre de flux perdus (en se basant sur les informations de séquence lorsqu'elles sont disponibles, i.e. en v5, v7 et v9).

L'option --outputFile (-o) spécifie le fichier d'impression utilisé par les options --printFlowsBefore (-B) et --PrintFlowsAfter (-A). Le caractère - désigne la sortie standard (qui est l'option par défaut).

L'option --nolog (-o) désactive la génération de messages dans le «syslog». Par défaut des «logs» sont produits en cas d'erreur (avertissement ou erreur grave), lors de l'ouverture ou la fermeture du «socket» de lecture des datagrammes et lors des «dumps» des tables.

Enfin l'option --start (-s) démarre la collecte. En l'absence de cette option le collecteur est initialisé et en attente. Il faut alors utiliser MonitorMain pour démarrer la collecte.

Il faut noter que la commande termine immédiatement en cas d'erreur de paramètre ou d'erreur dans le fichier de configuration. Un message d'erreur est affiché sur l'erreur standard et le code retour est alors non nul. En l'absence d'erreur la commande se termine immédiatement avec un code retour nul après avoir s'être "clonée" et avoir créé le fichier d'identification.

<< Le script genTopsServices.pl (à partir de 3.7_xml) | Documentation | La commande MonitorMain >>

Print - Recent Changes - Search
Page last modified on 2017/01/27 15:00:05