= 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 '''site'''bdii 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
/usr/share/grid-monitoring/config-gen/nagios/wlcg.nagios/sendtomsg.template

* Générer la configuration
# /usr/bin/ncg.pl -v

* Redémarrer nagios
# /etc/init.d/nagios restart

= Documentations et liens utiles =

* Guide d'installation de Nagios NCG avec YAIM
https://twiki.cern.ch/twiki/bin/view/EGEE/GridMonitoringNcgYaim
* Guide d'installation de Nagios NCG sans Yaim
https://twiki.cern.ch/twiki/bin/view/LCG/GridServiceMonitoringInfo
* Description du fonctionnement de NCG
https://twiki.cern.ch/twiki/bin/view/EGEE/GridMonitoringNcgOverview
* Astuces de configuration pour NCG
https://twiki.cern.ch/twiki/bin/view/EGEE/GridMonitoringNcgRecipes

* Page de l'OAT
https://twiki.cern.ch/twiki/bin/view/LCG/GridServiceMonitoringInfo
* Page de WLCG Monitoring Wokring Group
https://twiki.cern.ch/twiki/bin/view/LCG/GridServiceMonitoringInfo

Installer Nagios NCG sans YAIM

Pbrinette: /* Structure et syntaxe des sondes */

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY -n
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/etc/nagios/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ 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"
# avec des Expression rationelles
$ 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=ccegeevm*"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur le batch systeme, queue '''jobmanager-pbs'''
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u grid63.lal.in2p3.fr:2119/jobmanager-pbs -o "(queue=dteam)" -n
GRAM OK: Command successfully executed. Output is: "1232541226 ". Result matches the expected result.

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /etc/nagios/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u myproxy.grif.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u myproxy.grif.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u myproxy.grif.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s myproxy.grif.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s myproxy.grif.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s myproxy.grif.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T13:04:42Z

Pbrinette:

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/etc/nagios/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ 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"
# avec des Expression rationelles
$ 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=ccegeevm*"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur le batch systeme, queue '''jobmanager-pbs'''
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u grid63.lal.in2p3.fr:2119/jobmanager-pbs -o "(queue=dteam)" -n
GRAM OK: Command successfully executed. Output is: "1232541226 ". Result matches the expected result.

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /etc/nagios/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u myproxy.grif.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u myproxy.grif.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u myproxy.grif.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s myproxy.grif.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s myproxy.grif.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s myproxy.grif.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T12:43:22Z

Pbrinette: /* hr.srce.ResourceBroker-RunJob */

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III|sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/etc/nagios/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ 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"
# avec des Expression rationelles
$ 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=ccegeevm*"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur le batch systeme, queue '''jobmanager-pbs'''
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u grid63.lal.in2p3.fr:2119/jobmanager-pbs -o "(queue=dteam)" -n
GRAM OK: Command successfully executed. Output is: "1232541226 ". Result matches the expected result.

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /etc/nagios/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u myproxy.grif.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u myproxy.grif.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u myproxy.grif.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s myproxy.grif.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s myproxy.grif.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s myproxy.grif.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T12:36:39Z

Pbrinette:

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III|sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/etc/nagios/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ 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"
# avec des Expression rationelles
$ 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=ccegeevm*"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur le batch systeme, queue '''jobmanager-pbs'''
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u grid63.lal.in2p3.fr:2119/jobmanager-pbs -o "(queue=dteam)" -n
GRAM OK: Command successfully executed. Output is: "1232541226 ". Result matches the expected result.

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /etc/nagios/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u myproxy.grif.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u myproxy.grif.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u myproxy.grif.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s myproxy.grif.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s myproxy.grif.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s myproxy.grif.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T12:34:54Z

Pbrinette: /* hr.srce.GRAM-Command */

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III|sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/etc/nagios/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ 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"
# avec des Expression rationelles
$ 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=ccegeevm*"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur le batch systeme, queue '''jobmanager-pbs'''
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u grid63.lal.in2p3.fr:2119/jobmanager-pbs -o "(queue=dteam)" -n
GRAM OK: Command successfully executed. Output is: "1232541226 ". Result matches the expected result.

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /etc/nagios/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u myproxy.grif.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u myproxy.grif.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u myproxy.grif.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s myproxy.grif.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s myproxy.grif.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s myproxy.grif.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T12:27:50Z

Pbrinette:

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III|sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/etc/nagios/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ 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"
# avec des Expression rationelles
$ 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=ccegeevm*"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur la queue '''jobmanager-bqs'''
/usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-bqs -t 240
serviceType: globus-GRAM
metricName: hr.srce.GRAM-Command
metricStatus: OK
timestamp: 2008-12-08T16:59:52Z
summaryData: GRAM OK: Command successfully executed. Output is: "'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * BQS Batch Queueing System Rel. 6.4 * * Centre de Calcul de l'IN2P3, Villeurbanne * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Starting on: 12/08/2008-17:59:44 * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* Executing lcg-prologue-dteam.sh... subject : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy/CN=limited proxy issuer : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy identity : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette type : limited legacy globus proxy strength : 512 bits path : /scratch/dteam00520233.ccwl1020/tmp/.x509up_u18151 timeleft : 9:30:19 1228755406 Executing lcg-epilogue-dteam.sh... ---------------------------------------------------- Contents of HOME after execution total 56 drwx------ 2 dteam005 dteam 4096 Dec 8 17:59 . drwxr-xr-x 2025 root root 32768 Dec 4 10:15 .. -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .cshrc -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .login -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .profile -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .tcshrc ---------------------------------------------------- '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: 1.ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Started on: 12/08/2008-17:59:43 * * Ended on: 12/08/2008-17:59:45 * * with status: ENDED * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Elapsed time: 0:00:02 * * CPU total real: 0:00:01 * * total normalized: 0:00:32 (time limit: 1:40:00) * * system real: 0:00:00 * * SCRATCH: 0 MB * * VIRTUAL STORAGE: 0 MB * * CPU Rate Raw (CPU/elaps):50 % * * Corrected: 50 % * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* ". Result matches the expected result.
serviceURI: cclcgceli03:2119/jobmanager-bqs
gatheredAt: cclcgsrvli01
EOT

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /etc/nagios/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u myproxy.grif.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u myproxy.grif.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u myproxy.grif.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s myproxy.grif.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s myproxy.grif.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s myproxy.grif.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/etc/nagios/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T12:22:22Z

Pbrinette: /* Mode de fonctionnement */

pbrinett@ccpeb:~/Mes documents/Doc/Formation/Nagios 2009$ bash conv.sh
== Descriptif des sondes grilles ==

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III|sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/opt/nagios/var/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ myproxy-init -c 336 -k NagiosRetrieve-ccegeevmli10.in2p3.fr-dteam -s cclcgproxli01.in2p3.fr -l nagios -x -Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccnagios01.in2p3.fr"
# avec des Expression rationelles
$ myproxy-init -c 336 -k NagiosRetrieve-ccegeevmli10.in2p3.fr-dteam -s cclcgproxli01.in2p3.fr -l nagios -x -Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccnagios0[0-9].in2p3.fr"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur la queue '''jobmanager-bqs'''
/usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-bqs -t 240
serviceType: globus-GRAM
metricName: hr.srce.GRAM-Command
metricStatus: OK
timestamp: 2008-12-08T16:59:52Z
summaryData: GRAM OK: Command successfully executed. Output is: "'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * BQS Batch Queueing System Rel. 6.4 * * Centre de Calcul de l'IN2P3, Villeurbanne * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Starting on: 12/08/2008-17:59:44 * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* Executing lcg-prologue-dteam.sh... subject : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy/CN=limited proxy issuer : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy identity : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette type : limited legacy globus proxy strength : 512 bits path : /scratch/dteam00520233.ccwl1020/tmp/.x509up_u18151 timeleft : 9:30:19 1228755406 Executing lcg-epilogue-dteam.sh... ---------------------------------------------------- Contents of HOME after execution total 56 drwx------ 2 dteam005 dteam 4096 Dec 8 17:59 . drwxr-xr-x 2025 root root 32768 Dec 4 10:15 .. -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .cshrc -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .login -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .profile -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .tcshrc ---------------------------------------------------- '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: 1.ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Started on: 12/08/2008-17:59:43 * * Ended on: 12/08/2008-17:59:45 * * with status: ENDED * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Elapsed time: 0:00:02 * * CPU total real: 0:00:01 * * total normalized: 0:00:32 (time limit: 1:40:00) * * system real: 0:00:00 * * SCRATCH: 0 MB * * VIRTUAL STORAGE: 0 MB * * CPU Rate Raw (CPU/elaps):50 % * * Corrected: 50 % * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* ". Result matches the expected result.
serviceURI: cclcgceli03:2119/jobmanager-bqs
gatheredAt: cclcgsrvli01
EOT

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /opt/nagios/var/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u cclcgproxli01.in2p3.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u cclcgproxli01.in2p3.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u cclcgproxli01.in2p3.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s cclcgproxli01.in2p3.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s cclcgproxli01.in2p3.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s cclcgproxli01.in2p3.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T12:21:55Z

Pbrinette:

pbrinett@ccpeb:~/Mes documents/Doc/Formation/Nagios 2009$ bash conv.sh
== Descriptif des sondes grilles ==

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III|sur le Wiki de l'OAT]].

= Structure et syntaxe des sondes =

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

= Mode de fonctionnement =

'''Dans le contexte du Nagios CC''', ces sondes sont prévu pour exécuté par NRPE (voir [[installation_service_nagios#nrpe]]) sur une machine '''cclcgsrvli01''' de type UI grille.

La procédure d'installation est décrite sur la page [[installation_service_nagios#installation_des_sondes_du_wlcg_monitoring_working_group]]

= Pagkages RPM =

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

= Package nagios-proxy-refresh =

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/opt/nagios/var/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ myproxy-init -c 336 -k NagiosRetrieve-ccegeevmli10.in2p3.fr-dteam -s cclcgproxli01.in2p3.fr -l nagios -x -Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccnagios01.in2p3.fr"
# avec des Expression rationelles
$ myproxy-init -c 336 -k NagiosRetrieve-ccegeevmli10.in2p3.fr-dteam -s cclcgproxli01.in2p3.fr -l nagios -x -Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccnagios0[0-9].in2p3.fr"

= Package grid-monitoring-fm-nagios-local =

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

= Package grid-monitoring-probes-cern =

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

== FTS-probe ==
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

== LFC-probe ==

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

=== ch.cern.LFC-Write ===

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
=== ch.cern.LFC-Read ===
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

=== ch.cern.LFC-ReadDli ===
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

=== ch.cern.LFC-Readdir ===

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

== RGMA-probe ==
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

=== ch.cern.RGMA-CertLifetime ===
Ce module teste la validité du certificat serveur du service RGMA.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== ch.cern.RGMA-ServiceStatus ===

Vérifie le status du service RGMA.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

= Package grid-monitoring-probes-hr.srce =

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

== CAdist-probe ==
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

=== Utilisation ===
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

== DPM-probe ==
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

== DPNS-probe ==
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

== GRAM-probe ==

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
=== hr.srce.GRAM-CertLifetime ===
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.GRAM-Auth ===
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

=== hr.srce.GRAM-Command ===

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur la queue '''jobmanager-bqs'''
/usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-bqs -t 240
serviceType: globus-GRAM
metricName: hr.srce.GRAM-Command
metricStatus: OK
timestamp: 2008-12-08T16:59:52Z
summaryData: GRAM OK: Command successfully executed. Output is: "'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * BQS Batch Queueing System Rel. 6.4 * * Centre de Calcul de l'IN2P3, Villeurbanne * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Starting on: 12/08/2008-17:59:44 * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* Executing lcg-prologue-dteam.sh... subject : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy/CN=limited proxy issuer : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy identity : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette type : limited legacy globus proxy strength : 512 bits path : /scratch/dteam00520233.ccwl1020/tmp/.x509up_u18151 timeleft : 9:30:19 1228755406 Executing lcg-epilogue-dteam.sh... ---------------------------------------------------- Contents of HOME after execution total 56 drwx------ 2 dteam005 dteam 4096 Dec 8 17:59 . drwxr-xr-x 2025 root root 32768 Dec 4 10:15 .. -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .cshrc -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .login -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .profile -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .tcshrc ---------------------------------------------------- '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: 1.ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Started on: 12/08/2008-17:59:43 * * Ended on: 12/08/2008-17:59:45 * * with status: ENDED * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Elapsed time: 0:00:02 * * CPU total real: 0:00:01 * * total normalized: 0:00:32 (time limit: 1:40:00) * * system real: 0:00:00 * * SCRATCH: 0 MB * * VIRTUAL STORAGE: 0 MB * * CPU Rate Raw (CPU/elaps):50 % * * Corrected: 50 % * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* ". Result matches the expected result.
serviceURI: cclcgceli03:2119/jobmanager-bqs
gatheredAt: cclcgsrvli01
EOT

== GridFTP-probe ==

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== GridProxy-probe ==

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /opt/nagios/var/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

== MyProxy-probe ==

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

=== hr.srce.MyProxy-CertLifetime ===

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u cclcgproxli01.in2p3.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

=== hr.srce.MyProxy-ProxyLifetime ===
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u cclcgproxli01.in2p3.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

=== hr.srce.MyProxy-Store ===
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u cclcgproxli01.in2p3.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s cclcgproxli01.in2p3.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s cclcgproxli01.in2p3.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s cclcgproxli01.in2p3.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

== ResourceBroker-probe ==
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

=== hr.srce.ResourceBroker-CertLifetime ===
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

=== hr.srce.ResourceBroker-RunJob ===

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== SRM-probe ==

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

=== hr.srce.SRM1-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
=== hr.srce.SRM1-Ping ===

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

=== hr.srce.SRM2-CertLifetime ===
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

=== hr.srce.SRM-Transfer ===
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== WMProxy-probe ==
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

=== hr.srce.WMProxy-CertLifetime ===
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

=== hr.srce.WMProxy-RunJob ===
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

== WMS-probe ==
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

== refresh_proxy ==

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \

2009-01-21T12:20:10Z

Pbrinette:

Cette page décrit les sondes grilles délivrées par le projet (WLCG Monitoring Working group).

Les informations sur ces sondes sont disponibles [[https://twiki.cern.ch/twiki/bin/view/EGEE/OAT_EGEE_III|sur le Wiki de l'OAT]].

== Structure et syntaxe des sondes ==

Les sondes délivrés par le projet ne sont pas limités qu'à une utilisation dans Nagios, elles ont été développés de façon à pouvoir être intégré dans d'autres outils de monitoring (Lemon,...).

Le projet a donc défini des spécifications pour l'écriture de ces sondes. Ces spécifications sont disponibles sur [[https://twiki.cern.ch/twiki/bin/view/LCG/GridMonitoringProbeSpecification|le Wiki du WLCG Monitoring Working Group]].

Les sondes développés en suivant ces spécifications intègrent des options standard :
* '''-h|--help''' : affiche l'aide sur l'utilisation de la sonde.
* '''-l''' : Liste les "métriques" testé par la sondes. Une seule et même sonde peut intégrer plusieurs métriques, c'est à dire des tests différents.
* '''-m''' : Spécifie la "métrique" à invoquer.
* '''-x''' : Chemin vers le fichier de proxy.
* '''-n''' : Affiche le résultat de la sonde au format Nagios (résultat sur 1 seule ligne + valeur de retour).
* '''-u''' : URI du service à tester (dans le cas de sondes non locale).

Par défaut, le résultat d'exécution de la sonde est affiché au format WLCG.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
serviceType: GridProxy
metricName: hr.srce.GridProxy-Valid
metricStatus: OK
timestamp: 2008-11-27T11:38:49Z
summaryData: Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
hostName: cclcgsrvli01
EOT

L'exécution de la sonde renvoi deux codes retour possibles (qui sont différent de ceux de nagios) :
* '''0''' : La sonde a effectué sont traitement correctement (même si le metricStatus est CRITICAL)
* '''1''' : La sonde n'a pas pu effectuer sont traitement correctement (échec de connexion au service par exemple).

L'option '''-n''' permet d'exécuter ces sondes avec une sortie formaté pour nagios.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x $X509_USER_PROXY
Grid proxy is valid. Certificate will expire in 10.85 hours (Nov 27 22:30:05 2008 GMT).
$ echo $?
0

== Mode de fonctionnement ==

'''Dans le contexte du Nagios CC''', ces sondes sont prévu pour exécuté par NRPE (voir [[installation_service_nagios#nrpe]]) sur une machine '''cclcgsrvli01''' de type UI grille.

La procédure d'installation est décrite sur la page [[installation_service_nagios#installation_des_sondes_du_wlcg_monitoring_working_group]]

== Pagkages RPM ==

4 packages RPM contiennent les sondes et les outils nécessaire à l'exécution de ces sondes :

nagios-proxy-refresh-1.7-3.noarch
grid-monitoring-probes-hr.srce-0.10.1-1.noarch
grid-monitoring-probes-ch.cern-0.12.0-1.x86_64
grid-monitoring-fm-nagios-local-0.11.1-1.noarch

Le nom des packages de sondes contient le nom de l'organisme délivrant les sondes (pour le moment uniquement cern.ch et srce.hr).

== Package nagios-proxy-refresh ==

Ce paquet contient le mécanisme de renouvellement de proxy.

Le fichier de configuration est '''/etc/nagios-proxy-refresh.conf'''. Le renouvellement de proxy est effectué toute les 4 heures par le script cron '''/etc/cron.d/nagios-proxy-refresh'''.
Ce script ne s'exécute que si le service est démarré. Le script de démarrage du service est /etc/init.d/nagios-proxy-refresh. Ce dernier positionne un fichier de lock qui autorise ou non le script cron a s'exécuter.

Le proxy généré est stocké dans le fichier '''/opt/nagios/var/globus/userproxy.pem'''. L'accès à ce fichier n'est autorisé que pour l'utilisateur ''nagios''.

Par défaut, le proxy est récupéré en s'authentifiant sur le serveur myproxy avec le '''certificat machine''' (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem). Il faut que la commande '''/usr/sbin/nagios-proxy-refresh''' soit appelé sous l'identité '''root'''.

Le proxy préalablement déposé sur le serveur myproxy doit donc explicitement authoriser le DN du certificat machine a générer des certificat.

$ myproxy-init -c 336 -k NagiosRetrieve-ccegeevmli10.in2p3.fr-dteam -s cclcgproxli01.in2p3.fr -l nagios -x -Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccnagios01.in2p3.fr"
# avec des Expression rationelles
$ myproxy-init -c 336 -k NagiosRetrieve-ccegeevmli10.in2p3.fr-dteam -s cclcgproxli01.in2p3.fr -l nagios -x -Z "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=ccnagios0[0-9].in2p3.fr"

== Package grid-monitoring-fm-nagios-local ==

Ce package contient ne contient pas de sondes mais 2 utilitaires :
* '''check_wlcg''' : un wrapper permettant de positionner l'environnement prealablement à l'exécution des sondes grilles.
* '''nagios-run-check''' : programme permettant d'éxécuter un test de service sur un host à partir de la configuration nagios. Cette commande doit être éxécuté sous l'identité '''root''':
# nagios-run-check cclcgceli01.in2p3.fr hr.srce.GridFTP-Transfer
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

== Package grid-monitoring-probes-cern ==

Ce package contient des sondes fournies par le CERN. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/ch.cern/'''.

==== FTS-probe ====
Cette sonde test le service FTS en se connectant sur le serveur TOMCAT du service et en récupérant la liste des canaux ouvert. Elle ne contient qu'un seul module ('''ch.cern.FTS-ChannelList''').

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/FTS-probe -m ch.cern.FTS-ChannelList -u cclcgftsprod.in2p3.fr -x $X509_USER_PROXY -n
OK - Found 74 channels

==== LFC-probe ====

Cette sonde permet de tester un Service LFC. La particularité de cette sonde est qu'elle ne supporte pas le format de sortie Nagios (option -n) et quelle est écrite en Python. Elle contient 4 modules.

==== ch.cern.LFC-Write ====

Ce module écrit une entrée dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Write-u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK
==== ch.cern.LFC-Read ====
Ce module lie l'entrée précédemment crée par le module ch.cern.LFC-Write dans le répertoire /grid/VO d'un serveur LFC donné en utilisant l'API python.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Write -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:09:15.330553
voName: dteam
summaryData: OK
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Write
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Read -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
OK

==== ch.cern.LFC-ReadDli ====
Ce module vérifie la présence d'une entrée précédemment crée par le module ch.cern.LFC-Write en se connectant sur le serveur TOMCAT du service.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:17:58.569287
voName: dteam
summaryData: Found 1 PFN
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-ReadDli
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-ReadDli -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
Found 1 PFN

==== ch.cern.LFC-Readdir ====

Cette sonde lit les entrée d'un répertoire LFC et affiche le temps d'exécution de la commande.

$ /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -v dteam -x $X509_USER_PROXY
serviceType: glite-LFC
gatheredAt: ccegeevmli10
metricStatus: OK
timestamp: 2009-01-21T10:19:07.828381
voName: dteam
summaryData: 0.053
serviceURI: lfc-prod.in2p3.fr
metricName: ch.cern.LFC-Readdir
EOT

$ /usr/libexec/grid-monitoring/plugins/nagios/check_wlcg -m ch.cern.LFC-Readdir -u lfc-prod.in2p3.fr -P /usr/libexec/grid-monitoring/probes/ch.cern/LFC-probe -o "-v dteam" -x $X509_USER_PROXY
0.048

==== RGMA-probe ====
Cette sonde permet de tester le service MON Box. Elle se connecte sur le serveur TOMCAT de la machine et récupère le status du service.
Elle contient 2 modules

==== ch.cern.RGMA-CertLifetime ====
Ce module teste la validité du certificat serveur du service RGMA.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/ch.cern/RGMA-probe -m ch.cern.RGMA-CertLifetime -u cclcgmoli01 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

==== ch.cern.RGMA-ServiceStatus ====

Vérifie le status du service RGMA.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
./RGMA-probe -m ch.cern.RGMA-ServiceStatus -u cclcgmoli01 -n -x /etc/nagios/globus/userproxy.pem
OK

== Package grid-monitoring-probes-hr.srce ==

Ce package contient des sondes fournies par SRCE. Elle sont installés dans le répertoire '''/usr/libexec/grid-monitoring/probes/hr.srce/'''.

==== CAdist-probe ====
Cette sonde permet de tester si la version des CA distribué par le projet sur une machine donnée est bien à jour.

La sonde télécharge la version des CA courante sur les site de l'IGTF et du respository LCG et les compare de deux façon possible :
* Soit localement en extrayant les données du fichier /etc/grid-security/certificates/policy-igtf-classic.info
* Soit à distance (si un nom de Host est passé en paramètre) en transférant ce même fichier par gridftp

==== Utilisation ====
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/CAdist-probe -m hr.srce.CAdist-Version -n

==== DPM-probe ====
Cette sonde permet de tester un serveur DPM.

Elle contient un seul module '''hr.srce.DPM-Query''' qui effectue une commande '''dpm-qryconf'''

==== DPNS-probe ====
Cette sonde permet de tester le service DPNS.

Elle contient un seul module '''hr.srce.DPNS-List''' qui exécute une command '''dpns-ls'''.

==== GRAM-probe ====

Cette sonde permet de tester des services (essentiellement les '''CEs''') en utilisant la couche Globus GRAM (Globus Resource Allocation Manager). Les services GRAM sont utilisé coté client pour s'authentifier auprès d'un service et effectuer des action (telles que la soumission de job).

Cette sonde contient 3 modules :
==== hr.srce.GRAM-CertLifetime ====
Ce module permet de tester la validité d'un certificat en se connectant sur la port du service (2119 par défaut.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-CertLifetime -u ccsrm:8443 -n
Certificate will expire in 253.99 days (Aug 14 14:01:00 2009 GMT).

==== hr.srce.GRAM-Auth ====
Ce module permet de tester l'authentification auprès du service Gatekeeper d'un CE et voir ainsi si le service reconnaît le DN du proxy.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Auth -u cclcgvmli03 -n
GRAM Authentication test successful

==== hr.srce.GRAM-Command ====

Ce module permet de soumettre un job sur un CE via la commande "globus-job-run". Le paramètre '''-u (URL)''' permet de spécifier le jobmanager que l'on souhaite utiliser. En cas de soumission sur le système de batch, il faut spécifier l'option '''-t (timeout)''' avec un valeur minimale de 600 secondes.

* Soumission sur la queue '''jobmanager-fork'''
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-fork -n
GRAM OK: Command successfully executed. Output is: "1228755558 ". Result matches the expected result.
* Soumission sur la queue '''jobmanager-bqs'''
/usr/libexec/grid-monitoring/probes/hr.srce/GRAM-probe -m hr.srce.GRAM-Command -u cclcgceli03:2119/jobmanager-bqs -t 240
serviceType: globus-GRAM
metricName: hr.srce.GRAM-Command
metricStatus: OK
timestamp: 2008-12-08T16:59:52Z
summaryData: GRAM OK: Command successfully executed. Output is: "'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * BQS Batch Queueing System Rel. 6.4 * * Centre de Calcul de l'IN2P3, Villeurbanne * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Starting on: 12/08/2008-17:59:44 * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* Executing lcg-prologue-dteam.sh... subject : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy/CN=limited proxy issuer : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette/CN=proxy/CN=proxy/CN=proxy/CN=proxy identity : /O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette type : limited legacy globus proxy strength : 512 bits path : /scratch/dteam00520233.ccwl1020/tmp/.x509up_u18151 timeleft : 9:30:19 1228755406 Executing lcg-epilogue-dteam.sh... ---------------------------------------------------- Contents of HOME after execution total 56 drwx------ 2 dteam005 dteam 4096 Dec 8 17:59 . drwxr-xr-x 2025 root root 32768 Dec 4 10:15 .. -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .cshrc -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .login -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .profile -r-------- 1 dteam005 dteam 64 Dec 8 17:59 .tcshrc ---------------------------------------------------- '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * User: dteam005 * * Group: dteam * * Share: COMMON:dteam@anastasie * * Jobname: lcg1208175646-02901 * * JobID: 20233.ccwl1020 * * Class: A * * Worker: 1.ccwl1020.in2p3.fr * * Operating system: Linux 2.6.9-55.0.9.ELsmp * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Queued on: 12/08/2008-17:56:46 * * Eligible since: 12/08/2008-17:56:46 * * Started on: 12/08/2008-17:59:43 * * Ended on: 12/08/2008-17:59:45 * * with status: ENDED * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* * Elapsed time: 0:00:02 * * CPU total real: 0:00:01 * * total normalized: 0:00:32 (time limit: 1:40:00) * * system real: 0:00:00 * * SCRATCH: 0 MB * * VIRTUAL STORAGE: 0 MB * * CPU Rate Raw (CPU/elaps):50 % * * Corrected: 50 % * '''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''* ". Result matches the expected result.
serviceURI: cclcgceli03:2119/jobmanager-bqs
gatheredAt: cclcgsrvli01
EOT

==== GridFTP-probe ====

Cette sonde permet de tester un service GridFTP en effectuant un transfert (écriture/lecture/suppression). Il est possible de spécifier des paramètres optionnels tels que :
* '''-vo''' : Nom de la Vo utilisé pour faire le test
* '''-t''' : timeout (par défaut 600 s)
* '''--path=''' : répertoire de destination (par défaut /tmp)

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u cclcgceli01 -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridFTP-probe -m hr.srce.GridFTP-Transfer -u gsiftp://cclcgseli01:2811 --path=/grid/dteam -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

==== GridProxy-probe ====

Cette sonde teste si un proxy est valide. Elle est utilisé pour tester le proxy utilisé par Nagios :

$ /usr/libexec/grid-monitoring/probes/hr.srce/GridProxy-probe -x /opt/nagios/var/globus/userproxy.pem -n -v dteam
Grid proxy is valid. Certificate will expire in 9.15 hours (Dec 09 02:30:03 2008 GMT).

==== MyProxy-probe ====

Cette sonde permet de tester la validité du proxy stocké sur le serveur MyProxy.
Cette sonde contient 3 modules

==== hr.srce.MyProxy-CertLifetime ====

Ce module teste la validité du certificat serveur du service MyProxy.
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-CertLifetime -u cclcgproxli01.in2p3.fr -n
Certificate will expire in 147.85 days (Jun 17 14:00:37 2009 GMT).

==== hr.srce.MyProxy-ProxyLifetime ====
Ce module test la validité du proxy longue durée déposé sur le serveur MyProxy. L'authentification sur le serveur myproxy est faite en utilisant le certificat préalablement chargé.
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-ProxyLifetime -u cclcgproxli01.in2p3.fr -x $X509_USER_PROXY -n
Certificate will expire in 8.83 days (Jan 29 13:35:21 2009 GMT).

==== hr.srce.MyProxy-Store ====
Ce module permet de tester que le service Myproxy fonctionne bien. Il crée un nouveau proxy à partir du proxy courant, le dépose sur le serveur myproxy, affiche les informations puis le supprime en fin de test
$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/MyProxy-probe -m hr.srce.MyProxy-Store -u cclcgproxli01.in2p3.fr --verbose -n
INFO: getting proxy certificate info
COMMAND: /opt/globus/bin/grid-proxy-info 2>&1
COMMAND: /opt/globus/bin/myproxy-init -x -S -k nagios -l nagios -c 1 -s cclcgproxli01.in2p3.fr -p 7512 -r "/O=GRID-FR/C=FR/O=CNRS/OU=CC-LYON/CN=Pierre-Emmanuel Brinette"
COMMAND: /opt/globus/bin/myproxy-info -l nagios -s cclcgproxli01.in2p3.fr -p 7512
COMMAND: /opt/globus/bin/myproxy-destroy -k nagios -l nagios -s cclcgproxli01.in2p3.fr -p 7512
MyProxy credential created. Querying stored credential succeeded. MyProxy credential destroyed.

==== ResourceBroker-probe ====
Cette sonde permet de tester un Ressource Broker. Elle contient 2 modules

==== hr.srce.ResourceBroker-CertLifetime ====
Ce module teste la validité du certificat serveur du service Ressource Broker.
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-CertLifetime -u rb104.cern.ch -n
Certificate will expire in 66.65 days (Mar 28 09:27:28 2009 GMT).

==== hr.srce.ResourceBroker-RunJob ====

Ce module permet de tester un Ressource Broker en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/ResourceBroker-probe -m hr.srce.ResourceBroker-RunJob -u rb104.cern.ch -v dteam --ce=cclcgceli02.in2p3.fr -n -x $X509_USER_PROXY
Job https://rb104.cern.ch:9000/LHRfaNYfsybHGqNWwsKkmw successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

==== SRM-probe ====

Cette sonde permet de tester les services SRMv1 et SRMv2. Elle contient 4 modules:

==== hr.srce.SRM1-CertLifetime ====
Ce module teste la validité du certificat serveur du service SRMv1

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).
==== hr.srce.SRM1-Ping ====

Teste si l'interface du service SRM répond à une requete SRM-ping.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM1-Ping -u ccsrm.in2p3.fr -n -x $X509_USER_PROXY
SRM ping successful.

==== hr.srce.SRM2-CertLifetime ====
Ce module teste la validité du certificat serveur du service SRMv2.

$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM2-CertLifetime -u ccsrm.in2p3.fr -n
Certificate will expire in 205.83 days (Aug 14 14:01:00 2009 GMT).

==== hr.srce.SRM-Transfer ====
Effectue un transfert d'un fichier sur le serveur SRM. Les options utiles sont :
* ''' --path ''' : spécifie le répertoire de déstination (par défault /tmp)
* ''' -t ''' : Timeout de la commande (par défaut 600s)

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/SRM-probe -m hr.srce.SRM-Transfer -x $X509_USER_PROXY -u ccsrm02 --path /pnfs/in2p3.fr/data/dteam/ -n
Upload to remote computer succeeded. Download from remote computer succeeded. File successfully removed from remote computer. Received file is valid.

==== WMProxy-probe ====
Cette sondes et le pendant de la sonde [[descriptif_des_sondes_grille#resourcebroker-probe|ResourceBroker-probe]] pour le WMS. Elle permet de tester un WMS en soumettant un job.

Elle contient 2 modules :

==== hr.srce.WMProxy-CertLifetime ====
Ce module teste la validité du certificat serveur du service WMS:

$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-CertLifetime -u wms114.cern.ch -n
Certificate will expire in 210.86 days (Aug 19 15:32:13 2009 GMT).

==== hr.srce.WMProxy-RunJob ====
Ce module permet de tester un WMS en soumettant un job et en récupérant le résultat. Les options utiles sont :
* '''-v''' : Nom de la vo utilisé pour soumettre le job
* '''--ce''' : Force le hostname d'un CE de déstination
* '''-t (timeout)''' : Par défaut 600s, nécessite peut-etre d'être augmenté.

'''ATTENTION''' Les WMS sont particulièrement sensible au décalage d'horloges. Si la machine qui exécute la sondes à quelques secondes d'avance sur l'horloge des WMS vous obtenez le message:
Proxy exception: Proxy validity starting time in the future

Le résultat de cette sonde est considéré comme valide lorsque le job s'est exécuté et que l'output de job a bien été récupéré.

$ lcg_env
$ export X509_USER_PROXY=/opt/nagios/var/globus/userproxy.pem
$ /usr/libexec/grid-monitoring/probes/hr.srce/WMProxy-probe -m hr.srce.WMProxy-RunJob -x $X509_USER_PROXY -u wms114.cern.ch -v dteam -t 3600 --ce cclcgceli02.in2p3.fr -n
Job https://wms114.cern.ch:9000/dqlZqLb2bdXRxPEC9eRSuQ successfully submitted. Job successfully finished. Job output successfully retrieved. Received file is valid.

==== WMS-probe ====
Cette sonde est similaire à la sonde VMProxy-probe. Elle utilise les commande '''glite-job-* ''' qui on disparu du middleware.
'''Cette sonde n'est plus utilisé'''

==== refresh_proxy ====

Ce n'est pas une sonde ! Ce script est utilisé par la commande '''/usr/sbin/nagios-proxy-refresh''' pour obtenir un proxy préalablement déposé sur le serveur Myproxy. Pour pouvoir utiliser le '''certificat machine''' pour s'authentifier (/etc/grid-security/hostcert.pem; /etc/grid-security/hostkey.pem), , ce script doit être éxécuté sous l'identité '''root''' afin de pouvoir lire la clé privé.

/usr/libexec/grid-monitoring/probes/hr.srce/refresh_proxy \
-x $OUTPUT_PROXY \
-m hr.srce.GridProxy-Get \
-u $MYPROXY_HOST \
--myproxyuser $MYPROXY_USER \
--name $MYPROXY_NAME \
--localuser $LOCALUSER \
--vo $NAGIOS_VO \