Fichier de configuration générale
Le fichier de configuration de l'exploitation, désigné par cfgfile dans les paragraphes précédents, est constitué de lignes contenant chacune soit un commentaire, soit un mot-clé désignant un paramètre suivi de la valeur du paramètre.
L'exemple ci-dessous présente les différents paramètres d'une exploitation. Les lignes de commentaires qui précèdent chaque paramètre précisent son rôle.
# --------------------------------------------------------------------------
# NOMS :
# nom du service
NETMAT-SERVICE-NAME Flux
# adresse à laquelle envoyer un message en cas d'erreur au démarrage
NETMAT-SERVICE-MAIL moi@chez-moi.fr
# --------------------------------------------------------------------------
# PATH - PATH - PATH
# Le répertoire d'activation du service
NETMAT-SERVICE-PATH /home/netmat/Metrologie/Flux
# Le répertoire des exécutables écrits ec C++ MainThread, MonitorMain...
# Par défaut un sous-répertoire du répertoire d'activation mais ce
# pourrait être un lien vers un répertoire partagé.
NETMAT-BIN-PATH /home/netmat/Metrologie/Flux/bin
# Emplacement des répertoires contenant les fichiers de données brutes
NETMAT-DATA-PATH /home/netmat/Metrologie/Flux/DATA
# Le répertoire "racine" de toute l'arborescence des répertoires
# contenant les fichiers json générés et les matrices "sérialisées"
NETMAT-HTML-PATH /home/netmat/Metrologie/Flux/HTML
# L'URL du service
NETMAT-HTML-URL http://netmat.monsite.fr
# --------------------------------------------------------------------------
# FICHIERS :
# nom du fichier des sous-réseaux (organismes)
# Le fichier des organismes de la journée en cours doit être placé dans le répertoire
# NETMAT-DATA-PATH.
# La fonction SubnetFileBuilder::buildSubnetFile() appelée par le script mkConfFiles.pl
# peut être complétée pour (re)créer chaque jour ce fichier après avoir copié le
# fichier existant éventuel dans le sous-répertoire de __netmat_data_path__ du jour
# précédent (NETMAT-DATA-PATH/aaaa-mm/aaaa_mm-jjj) si ce répertoire ne contient pas
# déjà un fichier de même nom.
NETMAT-ORGA-FILE organismes.def
# nom local des fichiers de collecte
NETMAT-DUMP-FILE-NAME zzaccounting.dmp
# --------------------------------------------------------------------------\\
# DESIGN - DESIGN - DESIGN
# Attention, la modification de ces paramètres complique
# la mise à jour d'une activation existante (upgrade_netmat_service.sh)
# nom local des fichiers temporaires de collecte
NETMAT-TMP-DUMP-FILE-NAME tmpaccounting.dmp
# nom local des fichiers de reprise de collecte
NETMAT-RECOVERY-DUMP-FILE-NAME recover.dmp
# racine des noms locaux (relatif au répertoire journalier) des répertoires
# contenant les fichiers de collecte sur X mns, les noms sont obtenus par
# concaténation de '<période>mns' à cette racine, par exemple DETAIL5mns
DATA-XMNS-DIRECTORY-LOCAL-NAME DETAIL
# Seuil (nombre d'octets pour le service / total des octets échangés)
# en dessous duquel le service n'apparait pas dans les tableaux
# placés dans les pages de résultats
NETMAT-SERVICE-THRESHOLD-REAL 0.02
# Seuil en dessous duquel les données sont ignorées dans les "camemberts"
# visualisant des pourcentages, 3.0% en raison de limitations graphiques
NETMAT-PIE-THRESHOLD-REAL 3.0
# Nom du fichier descriptif de la collecte (paramètre --configuration de MainThread)
NETMAT-COLLECTOR-FILE-NAME /home/netmat/Metrologie/Flux/etc/netmat.conf
# Adresse IP/port d'écoute du collecteur
# La valeur doit être identique à celle de la clause NETFLOW_LISTEN_ADDR_PORT
# du fichier NETMAT-COLLECTOR-FILE-NAME
COLLECTOR-LISTENING-IP-PORT xxx.xxx.xxx.xxx/8080
# --------------------------------------------------------------------------
## Pour la nouvelle version (à partir de 4.0_json) -------------------------
# Adresse IP et port d'écoute du serveur hypnotoad, à changer si on veut faire
# cohabiter plusieurs services netMET/netMAT
# Il faut remplacer __HYPNOTOAD_LISTENING_IP_PORT__ par ce paramètre dans 'serveur_netmat/'
HYPNOTOAD-LISTENING-IP-PORT 127.0.0.1:3000
# Nombre d'organismes/de messages dans les tables de "tops"
NETMAT-ORGA-TOP-N 10
NETMAT-HOSTS-TOP-n 10
# Nom du réseau métropolitain
NETMAT-MAN-NAME ReseauLorrain
# Périodicité des dumps du collecteur en minutes
NETMAT-DUMP-PERIOD 5
# Période considérée pour les "tops" instantanés (en minutes)
NETMAT-TOP-N-PERIOD 5
Les paramètres NETMAT-SERVICE-NAME, NETMAT-SERVICE-MAIL, NETMAT-DATA-PATH, NETMAT-HTML-PATH, NETMAT-HTML-URL et NETMAT-ORGA-FILE sont ceux qui sont le plus susceptibles d'être «personnalisés». Dans l'exemple présenté un utilisateur nommé netmat active une exploitation nommée Flux, placée dans le répertoire Metrologie de son répertoire personnel. En cas d'erreur au démarrage du collecteur un courriel sera envoyé à moi@chez-moi.fr. Les exécutables MainThread, MonitorMain, netMETexp, etc. sont placés dans le répertoire /home/netmat/Metrologie/Flux/bin. Les fichiers de collecte sont dans /home/netmat/Metrologie/Flux/DATA et les pages fichiers «résultats» dans /home/netmat/Metrologie/Flux/HTML. Si ce même utilisateur souhaite activer une autre exploitation de netMAT il devra au minimum placer les fichiers résultats dans un répertoire autre que /home/netmat/Metrologie/Flux/HTML et déclarer une autre URL.
Si les caractéristiques de la collecte sont identiques pour les deux exploitations un seul collecteur suffira et les fichiers de collecte seront communs aux deux exploitations.
Dans le cas contraire il faudra activer deux collecteurs et placer les fichiers de collecte dans deux répertoires distincts. Les autres paramètres pourront en revanche être identiques.
Fichier descriptif des sous-réseaux
Un autre fichier est indispensable à netMAT, c'est le fichier associant à chaque adresse de sous-réseau son organisme de rattachement (paramètre NETMAT-ORGA-FILE du fichier cfgfile de configuration de l'exploitation). Chaque ligne de ce fichier est soit une ligne de commentaire commençant par # ou placée entre /* et */, soit une ligne contenant une adresse de sous-réseau au format CIDR (adresse de base /longueur de masque) suivie du nom de son entité de rattachement entre double quotes ("). Les noms d'entités sont des notations pointées.
# ---------- Descriptif des sous réseaux ----------
rrr.rrr.rrr.rrr/32 "ORGA_1.Subnet1"
nnn.nnn.nnn.nnn/mm "ORGA_1.Subnet1"
nnn.nnn.nnn.nnn/mm "ORGA_2.Subnet2"
nnn.nnn.nnn.nnn/mm "ORGA_3.Subnet1"
# on peut aussi avoir
# 0.0.0.0/0 "Reste.du_monde"
Dans ce fichier la notation 0.0.0.0/0 peut être utilisée pour représenter un sous-réseau par défaut auquel toute adresse appartient. Il est ainsi possible de constituer un organisme «virtuel» regroupant toutes les adresses extérieures aux sous-réseaux énumérés. Cette notation permet par exemple de regrouper les adresses de l'Internet quand celles-ci n'ont pas été agrégées lors de la collecte ou peut aider à détecter d'éventuelles erreurs de configuration en lui association un organisme «Inconnu».
Ce fichier peut contenir des adresses IPv6, et une ligne de la forme :
0::0/0 "Reste.du_monde"
<< La mise à jour des graphes de débit | Documentation | Configuration du serveur Apache >>
