Installation du module Centreon_Nagvis

Attention, cette installation ne fonctionne qu'avec la version 1.5.9 de Nagvis. On peut utiliser la version 1.5.10 avec une modification du fichier setup.conf.

Pré requis

Le paquet curl doit être présent sur le serveur debian

apt-get install curl

Installation en ligne de commande

Vous devez récupérer les binaires sur le site de la forge monitoring-fr
Décompressez l'archive.

cd /usr/local/src
tar xzf centreon-nagvis-2.2b.tar.gz 
cd centreon-nagvis-2.2b

L'installation téléchargera automatiquement la dernière version de Nagvis si vous êtes connecté à Internet avec le serveur. Malheureusement dans certaine entreprise, vous n'avez pas accès à Internet pour les serveurs. Dans ce cas, copiez l'archive de Nagvis, préalablement téléchargée, dans le dossier /tmp

Configurez le fichier setup.conf

LOCALMACHINE correspond au nom du serveur pour la connexion MySql. Dans notre cas les connexions MySql pour Centreon se font avec centreon@localhost, car notre serveur comprend la base MySql. Dans le cas d'une base externe, il faudra mettre le nom du serveur.

#!/bin/bash
TMP="/tmp"
MODULE_NAME="nagvis"
LOCALMACHINE="localhost"

Ces lignes correspondent aux paramètres Apache

HTTPD_USER="www-data"
HTTPD_GROUP="www-data"
HTTPD_CONF="/etc/apache2/conf.d"
HTTPD_INIT="/etc/init.d/apache2"

Ces lignes correspondent aux paramétrages de Centreon.

CENTREON_WWW="/usr/local/centreon/www"
CENTREON_ETC="/etc/centreon"
NAGVIS_PATH="/usr/local/nagvis"
CENTREONURI="http://localhost/centreon"
CENTREONU="admin"
CENTREONP="passwd admin centreon"

Ces lignes correspondent aux paramétrages de Nagvis, normalement il faut laisser par défaut.

NAGVISBRANCH="1.5"
NAGVISVER="${NAGVISBRANCH}.9"
NAGVISDL="http://downloads.sourceforge.net/project/nagvis/NagVis%20$NAGVISBRANCH/nagvis-$NAGVISVER.tar.gz"
NAGVISPATH="/usr/local/nagvis"
NAGVISURI="/nagvis"

Pour utiliser la version 1.5.10 modifier la ligne suivante

NAGVISVER="${NAGVISBRANCH}.10"

Paramètre du broker ndoutils, le paramètre NAGVISLIVE ne sera pas utilisé

NAGVISBACKENDS="ndo2db"
NAGVISNDO="/usr/local/nagios/bin/ndo2db-3x"
NAGVISLIVE="unix:/opt/monitor/var/rw/live"

Paramètres pour Nagios, normalement par défaut

ENGINE="Nagios"
ENGINEPATH="/usr/local/nagios"
ENGINEBIN="/usr/local/nagios/bin/nagios"
GRAPHVIZBIN="/usr/bin"

Il reste à saisir les paramètres pour Mysql, et la création du user nagvis pour la base Mysql.

MYSQLUSER="root"
MYSQLPASSWD="passwd mysql"
MYSQLHOST="localhost"
MYSQLPORT="3306"
CENTREONDB="centreon"
CENTREONUSER="centreon"
CENTREONPASSWD="passwd centreon"
CENTSTATUSDB="centstatus"
NAGVISDB="nagvis"
NAGVISUSER="nagvis"
NAGVISPASS="passwd nagvis"
INSTANCE="Central"

Lancez l'installation

./setup.sh -i
Parsing arguments
Checking existing installation
 Checking database centreon for centreonnagvis table
 Checking database nagvis
 Checking centreon module /usr/local/centreon/www/modules/nagvis folder
Deploy module
Deploying databases modifications
 > creating table centreon nagvis in centreon
 > creating database nagvis
 > populating nagvis database
Install module
Getting nagvis
--2011-07-24 19:47:04--  http://downloads.sourceforge.net/project/nagvis/NagVis%201.5/nagvis-1.5.9.tar.gz
Résolution de downloads.sourceforge.net... 216.34.181.59, 216.34.181.59
Connexion vers downloads.sourceforge.net|216.34.181.59|:80...connecté.
requête HTTP transmise, en attente de la réponse...302 Found
Emplacement: http://freefr.dl.sourceforge.net/project/nagvis/NagVis%201.5/nagvis-1.5.9.tar.gz [suivant]
--2011-07-24 19:47:04--  http://freefr.dl.sourceforge.net/project/nagvis/NagVis%201.5/nagvis-1.5.9.tar.gz
Résolution de freefr.dl.sourceforge.net... 88.191.250.132
Connexion vers freefr.dl.sourceforge.net|88.191.250.132|:80...connecté.
requête HTTP transmise, en attente de la réponse...200 OK
Longueur: 3298253 (3,1M) [application/x-gzip]
Sauvegarde en : «nagvis-1.5.9.tar.gz»

100%[===============================================>] 3 298 253    315K/s   ds 9,3s    

2011-07-24 19:47:14 (347 KB/s) - «nagvis-1.5.9.tar.gz» sauvegardé [3298253/3298253]

installing nagvis

Configuration du module Centreon-Nagvis

Tout d'abord, une chose importante : un compte administrateur de Centreon ne peut pas visualiser la vue Nagvis. Si vous avez une installation flambante neuve, il vous faudra créer un utilisateur standard dans Centreon.

Création des utilisateurs

Nous allons créer un utilisateur supervision qui fera partie du groupe de contact niveau1. Celui-ci recevra les autorisations pour la vue Nagvis et l'accès aux ressources. Ce groupe sera limité à la vue dans Nagvis en lecture seule. Un groupe d'accès nagvisRO sera initialisé pour correspondre au groupe Read-Only de Nagvis.
Il faudra créer un utilisateur exploitant qui fera partie du groupe de contact niveau2. Ce groupe recevra des autorisations plus importantes telles que les actions d'acquittements des alarmes. En outre, ce groupe aura le droit de modifier la cartographie de Nagvis. Un groupe d'accès nagvisRW sera initialisé pour correspondre au groupe Administrators de Nagvis.

Création du groupe de contact niveau1.

Liste des groupes de contacts


Création de l'utilisateur supervision associé au groupe niveau1


Celui-ci n'est pas administrateur. Faire de même pour l'utilisateur exploitant et son groupe de contact associé niveau2


Liste des utilisateurs

Configuration des ACL de Centreon

Maintenant, créez deux groupes d'accès nagvisRW et nagvisRO.

supervision et niveau1 devront être sélectionnés pour le groupe d'accès nagvisRO


exploitant et niveau2 devront être sélectionnés pour le groupe d'accès nagvisRW

Nous donnerons accès aux menus de Centreon avec les groupes d'accès aux Menus MNUniveau1 et MNUniveau2.

Le niveau 1 aura une vue limitée au monitoring en temps réel de la supervision. Ne pas oublier d'associer le groupe d'accès nagvisRO.


Le niveau 2 aura une vue plus étendue. Ne pas oublier d'associer le groupe d'accès nagvisRW.


Ensuite nous utiliserons un groupe d'accès aux ressources nommé All Ressources (celui créé par défaut lors de l'installation de Centreon) et nous ajouterons les deux groupes d'accès nagvisRW et nagvisRO.


Pour information, nous créerons le groupe d'accès aux actions pour le niveau2 et nous ajouterons le groupe d'accès nagvisRW. Les actions permises par ce groupe seront cochées dans la liste proposée.

Configuration du mappage Nagvis-Centreon

Nos ACL étant créés, nous devons associer chaque groupe d'accès à un groupe de Nagvis. Sélectionnez Configuration -> Nagvis -> ACL

Dans notre exemple le groupe nagvisRO (nagios en lecture seule) sera associé au groupe Users (read-only) et le groupe nagvisRW (admin nagvis) sera associé au groupe Administrators. N'oubliez pas de sauvegarder.

Vérification

Et voila, votre module est fonctionnel. Vous pouvez le tester en vous connectant en exploitant. La vue Nagvis est parfaitement intégrée dans l'interface Centreon.


Un conseil, n'oublier pas de changer le mot de passe par défaut de l'administrateur nagiosadmin proposé par Nagvis.

Utilisation des utilisateurs en lecture seule

Dernière chose à paramétrer, un utilisateur Nagvis en lecture seule. Si vous vous connectez en supervision sans ce dernier paramétrage vous aurez cette vue ci-dessous.

Cette situation est tout à fait normale, car il n'y a pas de relation entre les utilisateurs Centreon et un utilisateur Nagvis en lecture seule (Il n'existe pas en fait). Pour remédier, se connecter en administrateur (par exemple en exploitant).
Sélectionnez le menu User Menu / Manage Users


Créer l'utilisateur supervision ou tout autre nom.


Lui affecter le rôle Users (read-only). N'oubliez pas de sauvegarder et quitter l'interface. Vous pouvez utiliser sans problème le compte supervision.