Sommaire

1 Installer Nagios NCG sans YAIM
2 Documentations et liens utiles

Installer Nagios NCG sans YAIM

L'installation et la configuration des packages NCG avec Yaim présentent des inconvénients majeurs. La distribution Nagios+NCG est actuellement testée par l'OAT comme un composant d'un système de monitoring régional distribué. Cette distribution évolue assez rapidement et intègre régulièrement de nouveaux composants qui ne sont pas utiles, et peuvent même être génant pour un système de monitoring de site. Par exemple:

l'accès à la page de status de nagios pour n'importe quelle personnes appartenant à la VO Ops ou dteam
L'envoi des résultat d'éxécution des sondes par Active MQ "quelque part"
Le stockage des informations dans une base de donnée mysql (NDOTools)
(ce qui vous agasse dans yaim) ...

Prérequis

NCG nécessite d'avoir accès à la SAM Programatic Interface (SAM-PI) afin de pouvoir générer la configuration et surtout récupérer les résultats des tests SAM. Pour obtenir un accès, il faut créer un ticket GGUS avec comme sujet:

SAM-PI Access request as profile "EGEE-SA1 Monitoring Profile"

Dans le message du ticket, il faut spécifier l'IP et/ou le Hostname de la machine qui accédera à la base SAM.

Installation de la machine

Configuration matérielle

256 Mo de RAM
5 Go de disque
SL 4.5 i386/x86_64
Installation minimale du système

Configurer les repository

Ajouter les repository suivant dans /etc/yum.repos.d/

LCG-CA
DAG
jpackage (pour glite-UI)
glite-UI

# cd /etc/yum.repos.d/
# wget http://grid-deployment.web.cern.ch/grid-deployment/glite/repos/[nom du repository].repo

egee-SA1

# wget http://www.sysadmin.hep.ac.uk/rpms/egee-SA1/sl4/egee-SA1.repo

Installation les packages nécessaire

installer la couche UI

# yum install LCG-CA
# yum install glite-UI
# yum install gcc-c++

Configuration de la couche 'UI' de la machine

Modification du site-info.def afin de le configurer pour un UI minimale

BDII_HOST=cclcgtopbdii01.in2p3.fr
VOS="ops dteam"
PX_HOST=myproxy.grif.fr
GLOBUS_TCP_PORT_RANGE=20000,250000

Configuration avec YAIM

# /opt/glite/yaim/bin/yaim -c -s site-info.def -n glite-UI

Installation de Nagios:

# yum install nagios nagios-plugins httpd

Installation des sondes et de ncg

# yum install nagios-proxy-refresh  grid-monitoring-probes-hr.srce grid-monitoring-probes-ch.cern
# yum install grid-monitoring-config-gen grid-monitoring-fm-nagios-local grid-monitoring-fm-nagios-remote grid-monitoring-probes-org.bdii

Configuration du service

Rafraîchissement de proxy

Il faut au préalable déposer un proxy longue durée sur le serveur MyProxy. Depuis un machine interactive, lancer la commande suivante :

$ export GT_PROXY_MODE=old
$ myproxy-init -c 336 -k NagiosRetrieve-ccegeevmli10.in2p3.fr-dteam -s myproxy.grif.fr -l nagios -x -Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccegeevmli10.in2p3.fr"

Cette commande permet de générer un proxy valide 14 jours.

Le login ( -l) : nagios
Le "Credential" (-k) : NagiosRetrieve-"hostname de nagios + domaine"-"VO"
Le DN de la machine autorisé de récupéré le proxy (-Z) : le DN du certificat machine du serveur nagios.

Il est possible d'autoriser plusieurs machine à récupérer ce proxy, le paramètre -Z autorise les expressions rationnelles (regexp):

-Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccegeevmli[0-3][0-9].in2p3.fr"

Le fichier de configuration du service est: /etc/nagios-proxy-refresh.conf

MYPROXY_HOST=myproxy.grif.fr
NAGIOS_VO=dteam
MYPROXY_USER=nagios
LOCALUSER=nagios
MYPROXY_NAME=NagiosRetrieve-`hostname -f`-${NAGIOS_VO}
OUTPUT_PROXY=/etc/nagios/globus/userproxy.pem

Démarrage du service de renouvellement de proxy

# /etc/init.d/nagios-proxy-refresh start

Configuration de HTTPd

Ajouter d'un utilisateur autorisé à se connecter à la console de Nagios.

# htpasswd -c /etc/nagios/htpasswd.users nagiosadmin 
New password: 
Re-type new password: 
Adding password for user nagiosadmin

Ajouter l'utilisateur apache au groupe nagios afin que le serveur web puisse envoyer dans commandes à nagios via un FIFO

# usermod -G nagiocmd apache
# usermod -G nagios apache

Démarrer le service

# /etc/init.d/httpd start

Configuration de NCG

Le fichier de configuration principal de NCG est /etc/ncg/ncg.cfg. Il inclut le fichier /etc/ncg/ncg.localdb permettant de personnaliser la configuration générée.

Le fichier principal est découpé en section. Le début du fichier permet de renseigner des variables utilisées dans la suite du fichier.

Les variables à renseigner en entête de fichier sont :

SITENAME : Le nom du site pour lequel générer la configuration
MYPROXY_SERVER : Serveur myproxy utilisé pour stocker le proxy longue durée
BDII : hostname du sitebdii du site à superviser
MAIN_DB_FILE=/etc/ncg/ncg.localdb : fichier contenant les définitions locales de la configuration.

# Exemple
SITENAME=IN2P3-CC
MYPROXY_SERVER=myproxy.grif.fr
BDII=cclcgip01.in2p3.fr
SAM_VOS=OPS
MAIN_DB_FILE=/etc/ncg/ncg.localdb

Le fichier est en suite découpé en section correspondant aux modules perl utilisés pour générer la configuration

Dans la section <NCG::ConfigGen> il faut renseigner les valeurs :

<NCG::ConfigGen>
  <Nagios> 
      MYPROXY_SERVER=${MYPROXY_SERVER} # utilise la variable déclaré précédement)
      PROBES_TYPE=local,remote,native  # type configuration nagios à générer
      # Emplacement des répertoire à utiliser, ne pas modifier pour une install SL4
      TEMPLATES_DIR = /usr/share/grid-monitoring/config-gen/nagios
      OUTPUT_DIR = /etc/nagios/wlcg.d
      NRPE_OUTPUT_DIR = /etc/nagios/nrpe/
      RESOURCES_OUTPUT_DIR = /etc/nagios
     
      # Adresse email par défaut de l'administrateur nagios
      NAGIOS_ADMIN=admin@mondomaine.fr
 
      # Nom du "Credential" utilisé pour récupérer un proxy depuis le serveur myproxy
      # Il faut utiliser la même valeur que celle définie dans /etc/nagios-proxy-refresh.conf
      MYPROXY_NAME=NagiosRetrieve-ccegeevmli08.in2p3.fr-dteam
 
      # nom de l'utilisateur utilisé pour récupérer un proxy depuis le serveur myproxy
      # Il faut utiliser la même valeur que celle définie dans /etc/nagios-proxy-refresh.conf
      MYPROXY_USER=nagios
 
      # Récupère les tests SAM non critique ?
      SAM_INCLUDE_ALL=0
 
      # Liste des VOs pour lesquels récupérer les tests SAM
      SAM_VOS=OPS
      # nom de la vo utilisée pour passer les tests locaux:
      VO=dteam
  </Nagios>
 </NCG::ConfigGen>

Attention : la syntaxe des noms des VOs utilisée par la variable SAM_VOS n'est pas la même que celle définie dans le CIC portal. De plus il faut respecter la casse. Pour récupérer la liste des VOs déclarée dans la base de SAM, il suffit de lancer depuis le serveur nagios la commande :

$ wget -q -O - http://lcg-sam.cern.ch:8080/same-pi/vo_names.jsp | xmllint --format -

Dans la section <NCG::SiteInfo> on peut spécifier des information complémentaires

Ajouter les neuds présents dans le BDII mais non déclaré dans la GOCDB:

# NCG modules for gathering site information
<NCG::SiteInfo>
[...]
 <LDAP>
   LDAP_ADDRESS=$BDII
   ADD_HOSTS=0
 </LDAP>
[...]

La dernière section <NCG::RemoteMetrics> permet de spécifier les actions concerntant SAM en utilisant les variables déclarés plus haut.

<NCG::RemoteMetrics>
 # Values of parameters will be taken from 
 # configuration of NCG::ConfigGen::Nagios
 <SAM>
   SAM_INCLUDE_ALL=$SAM_INCLUDE_ALL
   SAM_VOS=$SAM_VOS
 </SAM>
 <NPM/>
</NCG::RemoteMetrics>

Le fichier /etc/ncg/ncg.localdb permet de personnaliser la configuration générée :

Ajouter un contact supplémentaire

ADD_CONTACT!un_admin@mondomaine.fr

Supprimer un contact

Par défaut NCG prend le contact du site déclaré dans le BDII. La directive pour supprimer un contact est:

REMOVE_CONTACT!grid.admin@cc.in2p3.fr

Supprimer un 'host' :

REMOVE_HOST!hostname_de_la_machine

Supprimer un groupe de service sur une machine

REMOVE_SERVICE!ostname_de_la_machine!org.glite.LocalLogger

D'autres exemples sont visibles dans /etc/ncg/ncg.localdb.example

Génération de la configuration

Pour générer la configuration, il suffit de lancer la commande :

# /usr/sbin/ncg.pl

NCG génère la configuration Nagios en plusieurs passe :

Récupération des informations déclaré dans la GOC-DB au traver de la SAM-PI.
Récupération des informations dans le Site BDII
Croisement des données générés.
Génération de la configuration nagios dans /etc/nagios/wlcg.d

NCG se base sur des templates pour générer la configuration. Ces templates sont dans le répertoire /usr/share/grid-monitoring/config-gen/nagios/

Après génération de la configuation le répetoire /etc/nagios/wlcg.d contient les fichiers suivants :

commands.cfg
contacts.cfg
host.groups.cfg
hosts.cfg
host.templates.cfg
service.groups.cfg
services.cfg
service.templates.cfg
users.cfg
wlcg.nagios.cfg

ATTENTION ! Ne pas modifier ces fichiers, il seront écrasés au prochain appel NCG

Modification de la configuration de Nagios

Il faut modifier la configuration de Nagios pour inclure ces ficheirs de configuration. Le fichier de configuration est : /etc/nagios/nagios.cfg

Commenter la configuration par défaut:

#cfg_file=/etc/nagios/objects/localhost.cfg
#cfg_file=/etc/nagios/objects/commands.cfg
#cfg_file=/etc/nagios/objects/contacts.cfg
#cfg_file=/etc/nagios/objects/timeperiods.cfg
#cfg_file=/etc/nagios/objects/templates.cfg

Ajout du répertoire de la configuration NCG:

cfg_dir=/etc/nagios/wlcg.d

Modifier les paramètres comme suit :

check_external_commands=1

Pour un système de production, modifier le paramètre suivant. Cela éviter de générer des fichiers de logs inutiles lorsque Nagios importe les résultats des tests SAM.

log_passive_checks=1

En cas d'utilisation des sondes "local" ou "native", ajouter le fichier de ressource et modifier valeur de timeout des tests de services

resource_file=/etc/nagios/wlcg_resource.cfg
service_check_timeout=900

ATTENTION : Nagios ne supporte pas que des objet soit dupliqués dans la configuration. Pour tester la configuration, faut exécuter la commande suivante:

 # /usr/bin/nagios -v /etc/nagios/nagios.cfg

Si il n'y a pas d'erreur, il ne reste qu'à démarrer nagios.

 # /etc/init.d/nagios start

Puis à se connecter sur l'interface Web http://srv_nagios/nagios/ avec le login/mot de passe crée précédemment.

Exemple de configuration

Générer un configuration "Remote Only" pour un site donnée

La configuration NCG "Remote Only" permet de générer une configuration de nagios affichant le résultat des tests SAM

Renseigner les variables globales dans le fichier /etc/ncg/ncg.cfg

# Exemple
SITENAME=MON-SITE
MYPROXY_SERVER=myproxy.grif.fr
BDII=monbdii.mondaine.fr
SAM_VOS=OPS
MAIN_DB_FILE=/etc/ncg/ncg.localdb
[...]
<NCG::ConfigGen>
  <Nagios> 
      [...]
      PROBES_TYPE=remote
[...]

Générer la configuration

 # /usr/bin/ncg.pl -v

Redémarrer nagios

 # /etc/init.d/nagios restart

Générer un configuration utilisant les sondes grilles pour un site donnée

La configuration NCG "remote,local,native" permet de générer une configuration de nagios affichant le résultat des tests SAM et effectuant des tests sur les services.

Vérifier que le service de renouvellement de proxy est bien active

# /etc/init.d/nagios-proxy-refresh status
Cron nagios-proxy-refresh is enabled.

Forcer le renouvellement d'un proxy

# /usr/sbin/nagios-proxy-refresh 
MyProxy credential retrieved. VOMS credential retrieved.

Renseigner les variables globales dans le fichier /etc/ncg/ncg.cfg

# Exemple
SITENAME=MON-SITE
MYPROXY_SERVER=myproxy.grif.fr
BDII=monbdii.mondaine.fr
SAM_VOS=OPS
MAIN_DB_FILE=/etc/ncg/ncg.localdb
[...]
<NCG::ConfigGen>
  <Nagios> 
      [...]
      PROBES_TYPE=remote,local,native
      MYPROXY_NAME=NagiosRetrieve-ccegeevmli08.in2p3.fr-dteam
[...]

La configuration par défaut test un service org.glite.LocalLogger qui est en général inaccessible. Pour le supprimer de la configuration, il faut rajouter les lignes suivantes au fichier /etc/ncg/ncg.localdb

REMOVE_SERVICE!monce01.mondomaine.fr!org.glite.LocalLogger
REMOVE_SERVICE!monce02.mondomaine.fr!org.glite.LocalLogger
REMOVE_SERVICE!monce03.mondomaine.fr!org.glite.LocalLogger
REMOVE_SERVICE!monce04.mondomaine.fr!org.glite.LocalLogger

Suppression de sondes inutiles. La configuration générée incluent 2 services qui ne sont pas utilisé dans notre cas:
- org.egee.SendToMsg: Mécanisme de publication des résultats des sondes locale par ActiveMQ
- hr.srce.GridProxy-Get: Sonde obsolète permettant de rafraichir le proxy.

Ces deux services sont défini dans les templates de configuration. Pour les enlever, il faut commenter les entrées dans les fichiers :

/usr/share/grid-monitoring/config-gen/nagios/wlcg.nagios/gridproxy.template
 # define service{
 #         use                             ncg-generic-service
 #         host_name                       <NAGIOS_SERVER>
 #         service_description             hr.srce.GridProxy-Get
 ...
 # }
 
 # define servicedependency{
 #         host_name                       <NAGIOS_SERVER>
 #         dependent_host_name             <NAGIOS_SERVER>
 #         service_description             hr.srce.GridProxy-Get
 #         dependent_service_description   hr.srce.GridProxy-Valid
 ...
 # }

/usr/share/grid-monitoring/config-gen/nagios/wlcg.nagios/sendtomsg.template
 #define service{
 #        use                             ncg-generic-service
 #        host_name                       <NAGIOS_SERVER>
 #        service_description             org.egee.SendToMsg
 ...
 #}

Générer la configuration

 # /usr/bin/ncg.pl -v

Redémarrer nagios

 # /etc/init.d/nagios restart

Ajouter la supervision de services non décrit dans NCG dans nagios

Rappel : Nagios ne supporte que des noms d'objets uniques. Si un objet appairait plus d'une fois, cela génère des erreurs qui empêchent le daemon de démarrer.

Running configuration check... CONFIG ERROR!  Restart aborted.  Check your Nagios configuration.

Le test de validité de la configuration se fait par la commande

# nagios -v /etc/nagios/nagios.cfg
[...]
Warning: Duplicate definition found for contact 'nagiosadmin' (config file '/etc/nagios/wlcg.d/wlcg.nagios.cfg', starting on line 49)
Error: Could not add object property in file '/etc/nagios/wlcg.d/wlcg.nagios.cfg' on line 50.
[...]

Toute la configuration de NCG est générée dans /etc/nagios/wlcg.d. NCG génère l'ensemble des objet utiles à nagios. La plupart des noms des objets manipulés par nagios on été redéfinis sont préfixé par ncg- afin qu'il n'y ai pas de collisions dans le nom. Par exemple :

ncg-host-notify-by-email
ncg-check-tcp
ncg-24x7
...

Par défaut, le seul objet qui rentre en conflit est le contact nagiosadmin. Il faut donc le supprimer de la configuration Nagios par défaut. Le fichier est :

/etc/nagios/objects/contacts.cfg.
#define contact{
#        contact_name                    nagiosadmin            ; Short name of user
#        use                             generic-contact         ; Inherit default values from generic-contact template (defined above)
#        alias                           Nagios Admin           ; Full name of user
#        email                           nagios@localhost        ; <<***** CHANGE THIS TO YOUR EMAIL ADDRESS ******
#        }

Pour ajouter des test spécifique au site, la meilleur façon de procéder consiste à rajouter des sous répertoire à l'arborescence nagios. Par exemple :

/etc/nagios/local_template/
/etc/nagios/contacts/

/etc/nagios/storage_server/
/etc/nagios/network_server/

Puis créer les fichiers hosts.cfg et services.cfg à l'intérieur des répertoire de services. Il faut toutefois garder à l'esprit que le contact nagiosadmin et le groupe de contacts nagios-admins sont défini par NCG.

Il est maintenant possible de rajouter les objets par défaut et les sous répertoires contenant les configurations locale dans /etc/nagios/nagios.cfg.

/etc/nagios/nagios.cfg
# objet par défauts
cfg_file=/etc/nagios/objects/commands.cfg
cfg_file=/etc/nagios/objects/contacts.cfg
cfg_file=/etc/nagios/objects/timeperiods.cfg
cfg_file=/etc/nagios/objects/templates.cfg
# repertoire specifique
/etc/nagios/local_template/
/etc/nagios/contacts/
/etc/nagios/storage_server/
/etc/nagios/network_server/