L'installation d'un service netMAT s'effectue en exécutant le script d'installation install_netmat_service.sh depuis le répertoire d'installation de la distribution avec comme paramètres :
- le répertoire d'installation dans lequel va être créé le répertoire d'activation du service
- l'identifiant du service netMAT créé, ce sera le nom du répertoire d'activation
- un dernier argument facultatif,
no_collect ou sans_collecte permet la définition d'un service sans collecte, c'est-à-dire partageant les données collectées par un autre service préalablement défini ; dans ce cas le répertoire des fichiers de collecte du service sans collecte doit être celui du service effectuant la collecte. ATTENTION : le répertoire contenant l'arborescence des fichiers générés ne peut être partagé.
Lors de son exécution la commande lit sur l'entrée standard :
- le nom du réseau métropolitain (Lothaire par exemple, ce peut être le même que le nom du service)
- l'adresse mail de l'administrateur du service (pour signaler certaines erreurs)
- l'URL du service netMAT créé
- le nom du répertoire destiné à recevoir les fichiers de collecte des flux (ou le répertoire de collecte du service "avec collecte" dans le cas d'utilisation de l'argument 'no_collect' ou 'sans_collecte')
- le nom du répertoire destiné à recevoir l'arborescence des fichiers générés quotidiennement (fichiers json et matrices sérialisées)
- l'adresse et le port sur laquelle le collecteur reçoit les netFlows
- l'adresse et le port sur laquelle le serveur hypnotoad écoute les requètes
La commande crée dans le répertoire d'installation un répertoire ayant pour nom l'identifiant du service et contenant les scripts, commandes et fichiers de configuration nécessaires.
par exemple :
mkdir ~/Metrologie
./install_netmat_service.sh ~/Metrologie Flux
Lorsque l'installation réussit la commande affiche un message, pour l'exemple (/home/netmat/ représente le chemin absolu du répertoire personnel de l'utilisateur) :
./install_netmat_service.sh ~/Metrologie Flux
Enter metropolitan area network name (Lothaire for example) ? ReseauLorrain
Enter administrator email (for warning/error messages) ? moi@chez-moi.fr
Enter netMAT service URL ( http://... or https://... ) ? http://netmat.monsite.fr/
Enter directory name for data collected (or return if /home/netmat/Metrologie/Flux/DATA) ?\\
Enter directory name for resulting (json) files (or return if /home/netmat/Metrologie/Flux/HTML) ?
Enter netflows listening (IPv4) address/port used by collector (xxx.xxx.xxx.xxx/n) ? 192.168.10.10/8090
Enter hypnotoad listening (IPv4) address:port used by server (or return if 127.0.0.1:3000 ) ? 127.0.0.1:3030
Directories bin
etc
initng
lib
README.txt
scripts
serveur_netmat created
-----------------------------------------------------------------------------
Creating links to installed netMAT collector programs ...
-----------------------------------------------------------------------------
Checking data/html directories...
Check directory /home/netmat/Metrologie/Flux/HTML ... /home/netmat/Metrologie/Flux/HTML created.
Check directory /home/netmat/Metrologie/Flux/DATA ... /home/netmat/Metrologie/Flux/DATA created.
-----------------------------------------------------------------------------
/home/netmat/Metrologie/Flux/lib/ACCdates.pm syntax OK
/home/netmat/Metrologie/Flux/lib/ACCinfo.pm syntax OK
...
/home/netmat/Metrologie/Flux/scripts/topsEchanges.pl syntax OK
You must now
- probably update your Apache configuration file.
Look a the file /home/netmat/Metrologie/Flux/etc/httpd.conf as an example of file to
include in an Apache configuration file.
- change the file /home/netmat/Metrologie/Flux/serveur_netmat/STATIC/images/admin-logo.gif
- write collector configuration file /home/netmat/Metrologie/Flux/etc/netmat.conf
(it's a good idea to check them with /home/netmat/Metrologie/Flux/bin/configurationFileCheck)
- write definitions in /home/netmat/Metrologie/Flux/DATA/organismes.def
(format of the lines : xxx.xxx.xxx.xxx/mask "name"
warning : ReseauLorrain can't be used as name for organism
it's a good idea to check the file with commands :
/home/netmat/Metrologie/Flux/bin/subnetFileCheck /home/netmat/Metrologie/Flux/DATA/organismes.def
grep -c '[."]ReseauLorrain[."]' /home/netmat/Metrologie/Flux/DATA/organismes.def
if [ $? -ne 0 ] ; then echo 'incorrect file' ; fi
You can
- complete the function getOrganismsForUser() in /home/netmat/Metrologie/lib/Users.pm
for controlling access to Flux.
- complete the function buildSubnetFile() in /home/netmat/Metrologie/lib/SubnetFileBuilder.pm
for regenerating each day the "organism's" file (subnet's definitions).
- complete the function buildCollectorConfigurationFile() in /home/netmat/Metrologie/lib/CollectorConfigurationBuilder.pm
for regenerating the collector configuration file.
before starting .
-----------------------------------------------------------------------------
Use /home/netmat/Metrologie/Flux/initng/init-systemd-instal4Flux.sh as root to install service Flux for init Systemd
-----------------------------------------------------------------------------
********** netMAT service Flux : installation completed. **********
Lors de son exécution la commande a créé :
- le répertoire d'activation du service
~/Metrologie/Flux (cf. paragraphe Le répertoire d'activation du service)
- le répertoire
~/Metrologie/Flux/DATA
- le répertoire
~/Metrologie/Flux/HTML (cf. paragraphe Structure du répertoire «html»)
- le fichier
/home/netmat/Metrologie/Flux/initng/init-systemd-instal4Flux.sh, si l'«init» du système est systemd ; avec l'«init» system V c'est le script init-systemV-instal4Flux.sh qui aurait été généré et le fichier Flux.i avec initng (http://www.initng.org).
Comme l'indique le message affiché à l'issue de l'exécution de la commande un certain nombre de fichiers de configuration doivent être créés ou complétés. Ils sont situés dans le répertoire d'activation (~/Metrologie/Flux dans l'exemple).
Une fois ces fichiers de configuration créés il reste à installer le service systemd, init system V ou initng selon le cas en utilisant le script adéquat.
<< Installation de la distribution | Documentation | Démarrage et arrêt d'un service netMAT >>
