{{tag>sysadmin supervision software application nagios plugin nrpe}}


====== Nagios: nsclient++ le client NRPE pour Windows ======

Le programme NSClient++ (NSCP) intègre un serveur NRPE sous forme de module pour les systèmes Windows.


===== Installation =====

  * Télécharger et installer les binaires NSClient++ disponible à l'URL http://www.nsclient.org/download/
  * Vérifier que le pare-feu autorise les connexions sur le port utilisé par le module NRPEServer **5666/tcp**
  * Générer une configuration minimale pour tester le bon fonctionnement du module


==== Configuration initiale sans SSL ====

Après installation, générer le  fichier de configuration avec la commande:
<code batch>
cd "\Program Files\NSClient++"
nscp settings --generate --add-defaults
</code>


Modifier le fichier ini pour désactiver l'utilisation de SSL
<file>
[/settings/default]
allowed hosts = 192.168.0.10/24

[settings/NRPE/server]
insecure = false
use ssl = false
</file>

Lancer NSClient++ en mode test



Depuis le superviseur Nagios, tester la connexion via la ligne de commande:
<code bash>
su nagios
/usr/lib/nagios/plugins/check_nrpe -H hostname
</code>


===== Vérifier la configuration =====

NSClient++ stocke sa configuration dans une structure arborescente contenant des paires clé/valeur. Dans la plupart des cas, des fichiers plats avec une syntaxe de type INI sont utilisés ayant pour section les chemins (paths)

<file ini>
; comment
[some/path]
key1=value1
key2=value2
</file>

D'autres méthodes de stockage de la configuration existent (dans le registre notamment). Pour visualiser la méthode de stockage de la configuration actuellement utilisée par NSClient++:
<code batch>
nscp settings --show
</code>

Lister les valeurs définies:

<code batch>
nscp settings --list
</code>


Pour utiliser ponctuellement une configuration différente, ici en lançant en mode test:
<code batch>
nscp test --settings nsclient2.ini
</code>



===== Lancement en mode test =====

Arrêter le service:
<code batch>
net stop nscp
</code>

Depuis le répertoire d'installation de NSCP, lancer l'exécutable dans une console administration:
<code batch>
cd \Program Files\NSClient++\
nscp test
</code>

Il est possible de lancer NSCP sans s'appuyer sur les fichiers de configuration. Il faudra alors définir les paramètres depuis le prompt.

<code batch>
nscp test --settings dummy
</code>

===== Troubleshooting =====

Lors de la vérification de la connexion entre le client NRPE (présent sur le superviseur Nagios)  et le serveur NSClient++ (sur l’hôte à superviser) le message suivant est affiché:

<file>
CHECK_NRPE: Error - Could not complete SSL handshake with 192.168.0.10: 1
</file>

Le problème a pu être identifié en lançant le serveur NSClient++ en mode test. Le dump de la configuration indiquait que le masque associé par défaut à l'adresse autorisé pour le serveur de monitoring était incorrecte. Après modification de la déclaration et redémarrage du service, le problème a été résolu.


<code bash>
/usr/lib/nagios/plugins/check_nrpe -V
</code>

===== Références =====

  * http://www.nsclient.org/
  * http://docs.nsclient.org/howto/nrpe/#nrpe-specific-setting-in-nsclient
  * http://docs.nsclient.org/getting_started/
  * https://docs.nsclient.org/howto/nrpe/
  * https://medin.name/blog/2013/06/05/nsclient-for-nrpe-users/
  * https://support.nagios.com/forum/viewtopic.php?t=55582
  * https://serverfault.com/questions/749681/nsclient-failed-to-establish-secure-connection#750088
  * https://www.sugarbug.fr/atelier/techniques/monitoring_lan/nsclient/mode_nrpe/