A chaque service netMAT correspond un répertoire d'activation contenant les fichiers et répertoires propres à ce service, en particulier les fichiers de configuration. Ce répertoire peut aussi contenir des liens vers les éléments communs, par exemple les fichiers exécutables si plusieurs services netMAT sont installés sur une même machine.
Pour l'exemple du paragraphe Installation d'un service netMAT, le répertoire d'activation a la structure suivante :
.../Metrologie/Flux
├── bin
│ ├── ...
│ ├── MainThread -> /opt/netMAT/nm_collector_5.10/MainThread
│ ├── ...
│ ├── MonitorMain -> /opt/netMAT/nm_collector_5.10/MonitorMain
│ ├── ...
│ ├── netMETdup -> /opt/netMAT/nm_collector_5.10/netMETdup
│ ├── netMETexp -> /opt/netMAT/nm_collector_5.10/netMETexp
│ ├── ...
│ └── subnetFileCheck -> /opt/netMAT/nm_collector_5.10/subnetFileCheck
├── DATA
│ ├── 2018-03
│ │ ├── 2018-03-20
│ │ │ ├── DETAIL5mns
│ │ │ │ ├── dureesDump.csv
│ │ │ │ ├── zzaccounting.dmp-00-00
│ │ │ │ ├── zzaccounting.dmp-00-05
│ │ │ │ ├── ...
│ │ │ │ └── zzaccounting.dmp-23-55
│ │ │ └── organismes.def
│ │ ├── 2018-03-21
│ │ │ ├── DETAIL5mns
│ │ │ │ ├── ...
│ │ │ └── organismes.def
│ │ ├── ...
│ ├── 2018-04
│ │ └── 2018-04-01
│ │ ├── ...
│ └── organismes.def
├── etc
│ ├── cron.modele
│ ├── explt.conf
│ ├── httpd_include.conf
│ └── netmat.conf
├── history.log
├── HTML
│ ...
├── initng
│ ├── init-systemd-instal4Flux.sh
│ ├── NETMAT_DUPstart.sh
│ ├── NETMAT_DUPstop.sh
│ ├── NETMAT.sh
│ ├── NETMATstart.sh
│ ├── NETMATstop.sh
│ ├── Flux
│ ├── Flux.i
│ └── Flux.service
├── lib
│ ├── ACCdates.pm
│ ├── ...
│ └── VERSIONnmexp.pm
├── run
│ ├── collector.idf
│ └── MainThread-pipe22282
├── scripts
│ ├── buildActivesIPs.pl
│ ├── dataDirectoryNaming -> ./dataFileNaming.pl
│ ├── dataFileNaming -> ./dataFileNaming.pl
│ ├── dataFileNaming.pl
│ ├── ...
│ └── topsEchanges.pl
└── serveur_netmat
├── lib
│ ├── ServeurNetmat
│ │ ├── Archives.pm
│ │ ├── ...
│ │ └── Top.oldpm
│ └── ServeurNetmat.pm
├── log
│ ├── development.log
│ └── production.log
├── public
│ └── index.html
├── script
│ ├── hypnotoad.conf
│ ├── hypnotoad.pid
│ └── serveur_netmat
├── STATIC
│ ├── apache
│ ├── css
│ │ ├── myscrolltable.css
│ │ └── netmat.css
│ ├── favicon.ico
│ ├── images
│ │ ├── 1downarrow.png
│ │ ├── ...
│ │ └── toparrow.png
│ ├── index.html
│ ├── js
│ │ ├── myscrolltable.js
│ │ └── nemat.js
│ ├── libs
│ │ ├── bootstrap
│ │ │ ...
│ │ ├── bootstrap-datepicker
│ │ │ ...
│ │ ├── bootstrap-datetimepicker
│ │ │ ...
│ │ ├── font-awesome
│ │ │ ...
│ │ ├── highcharts
│ │ │ ...
│ │ ├── jquery
│ │ │ ...
│ │ ├── jstree.js
│ │ ├── moment
│ │ │ ...
│ └── themes
│ ├── ...
├── t
│ └...
├── templates
│ │ ...
└── tmp
Le répertoire bin
Il contient des liens vers les exécutables du collecteur et les programmes associés. Ces programmes sont développés en C++. On suppose ici que le collecteur a été installé dans le répertoire /opt/netMAT (cf. Installation de la distribution).
Le répertoire DATA
C'est le répertoire contenant les fichiers de collecte (cf. Structure du répertoire des fichiers collectés). Il n'est pas nécessairement placé dans le répertoire d'activation du service, mais c'est l'emplacement par défaut lors de la création d'un service (cf. Installation d'un service netMAT).
Le répertoire etc
Il contient les différents fichiers de configuration du service.
Le fichier cron.modele est placé dans la «crontab» lors du démarrage du service.
Le fichier httpd_include.conf est un exemple des directives à ajouter au fichier de configuration Apache du serveur sur lequel est installé le service netMAT (cf. Configuration du serveur Apache). Il n'est pas utilisable en l'état et il faut au minimum remplacer les notations de la forme __XXX__ par des valeurs effectives. Il faut consulter la documentation Apache pour plus de détails sur la signification des diverses directives et pour la mise en place éventuelle d'un mécanisme d'authentification. Une façon simple d'utiliser le fichier fourni après l'avoir complété est de placer une directive d'inclusion
Include .../httpd_include.conf
dans le fichier /etc/httpd/conf/httpd.conf.
Le fichier netmat.conf est le fichier de configuration du collecteur (cf. Configuration du collecteur).
Le fichier explt.conf contient les principaux paramètres du service (cf. Fichiers de configuration de l'exploitation).
Le répertoire HTML
Ce répertoire créé dans le répertoire d'activation du service par défaut lors de la création du service (cf. Installation d'un service netMAT) contient les fichiers «pré-compilés» contenant l'évolution du débit de chaque organisme au cours de la journée et les matrices des flux (sérialisées) (cf. Structure du répertoire «html»).
Le répertoire initng
Le répertoire initng contient les scripts permettant de lancer automatiquement ou manuellement les diverses tâches nécessaires au service .
Les fichiers initng/NETMAT_DUPstart.sh et initng/NETMAT_DUPstop.sh permettent de lancer et d'arrer un duplicateur. L'installation standard d'un service netMAT n'utilise plus de duplicateur. Il est toutefois possible de l'utiliser pour dupliquer les informations de flux alimentant d'autres services.
Le fichier initng/NETMATstart.sh est la commande de démarrage de la collecte des flux, de leur exploitation et du serveur du service. Le processus de lecture et d'analyse des informations de flux (MainThread) commence son exécution et la «crontab» de l'utilisateur qui exécute la commande est modifiée. Les lignes du fichier etc/cron.modele sont ajoutées à la «crontab» de manière à provoquer le vidage de la table comptabilisant le trafic par tranches de X minutes à raison d'un fichier pour chaque tranche et à produire les fichiers nécessaires à l'exploitation.
Le fichier initng/NETMATstop.sh est la commande d'arrêt correspondante. Elle retire les lignes placées dans la «crontab» par initng/NETMATstart.sh puis arrête le collecteur (MainThread).
Les scripts NETMATstart.sh et NETMATstop.sh sont utilisés par les services du système mais ils peuvent être lancés directement à des fins de test par exemple.
Le script NETMAT.sh est utilisé par les services du système, il doit être lancé par le super-utilisateur (@@root@).
Si vous utilisez «systemd» le fichier init-systemd-instal4Flux.sh vous permet d'installer le service «Flux» décrit par le fichier etc/Flux.service (ce script doit être lancé par le super-utilisateur root).
Avec l'«init system V» le script init-systemV-instal4Flux.sh lancé par le super-utilisateur effectuera l'installation.
Enfin si vous utilisez initng (http://www.initng.org) vous pouvez définir un service Flux en copiant ~/Metrologie/Flux/initng/Flux.i dans /etc/initng/service/.
Bien entendu les routeurs devront avoir été configurés pour exporter les informations de flux sur le «bon» port de la «bonne» machine. Nous vous renvoyons à la documentation de vos routeurs pour cette opération.
Le répertoire lib
Ce répertoire contient les différents module Perl de l'application.
Le répertoire run
C'est dans ce répertoire que sont placés les différents fichiers contenant les numéros des processus en cours d'exécutions ainsi que le tube nommé permettant le pilotage du collecteur.
Le répertoire scripts
C'est le répertoire des scripts Perl de l'application.
Le répertoire serveur_netmat
Le répertoire serveur_netmat contient l'ensemble des composants du serveur «mojolicious», fichiers de configuration, scripts Perl et Javascript, feuilles de style css, images.
<< Démarrage et arrêt d'un service netMAT | Documentation | Mise à jour d'un service >>
