From 9d673764a7c7fd830f0dedc60e402292374bc2c5 Mon Sep 17 00:00:00 2001
From: Maxime BOURIEAU <m.bourieau+syscop@systel-sa.com>
Date: Wed, 9 Sep 2026 17:37:07 +0200
Subject: [PATCH] Refactor documentation for NSClient++ configuration,
 enhancing clarity and detail in sections on module activation, NRPE server
 settings, and service restart procedures.

---
 ... pour le modèle OS-Windows-NRPE-2-Disks.md | 84 ++++++++++++++++++-
 1 file changed, 81 insertions(+), 3 deletions(-)

diff --git a/Centreon/Configuration du fichier NSClient++ pour le modèle OS-Windows-NRPE-2-Disks.md b/Centreon/Configuration du fichier NSClient++ pour le modèle OS-Windows-NRPE-2-Disks.md
index 3402211..764d14d 100644
--- a/Centreon/Configuration du fichier NSClient++ pour le modèle OS-Windows-NRPE-2-Disks.md	
+++ b/Centreon/Configuration du fichier NSClient++ pour le modèle OS-Windows-NRPE-2-Disks.md	
@@ -39,7 +39,8 @@ insecure = true
 timeout = 60
 ```
 ## 4. Description des paramètres
-### 4.1 Section [/module] Cette section permet d'activer (1) ou de désactiver (0) les différents modules de l'agent NSClient ++.
+### 4.1 Section [/module] 
+Cette section permet d'activer (1) ou de désactiver (0) les différents modules de l'agent NSClient ++.
 
 **CheckSystem = 1** 
 Active le module de supervision système. Il permet à Centreon de contrôler :
@@ -62,7 +63,8 @@ Autorise l'exécution d scripts externes présents sur le serveur Windows, tel q
 **NRPEServer = 1** 
 Active le serveur NRPE intégré à NSClient++. Ce service permet au poller Centreon d'interroger le serveur Windows via le protocole NRPE (Nagios Remote Plugin Executor).
 
-### 4.2 Section [/settings/default] Cette section définit les paramètres généreux de communication.
+### 4.2 Section [/settings/default] 
+Cette section définit les paramètres généreux de communication.
 
 **allowed hosts**
 
@@ -76,4 +78,80 @@ Dans cet exemple, seul le poller Centreon disposent de l'adresse IP 192.168.1.10
 
 Définit le délai maximal d'attente d'une requête avant expiration.
 
-### 4.3 Section [/settings/NRPE/server] Cette section configure le fonctionnement du serveur NRPE.
\ No newline at end of file
+### 4.3 Section [/settings/NRPE/server] 
+Cette section configure le fonctionnement du serveur NRPE.
+
+**allow arguments = true**
+
+Autorise le poller Centreon à transmettre des arguments dynamiques aux commandes exécutées sur le serveur.
+
+Exemple :
+* Seuil d'alerte CPU à 80 %
+* Seuil d'espace disque libre à 10 %
+
+**allow nasty characters = true**
+
+Autorise l'utilisation de caractères spéciaux dans les arguments transmis par Centreon.
+
+Exemples : 
+-, $, |, &
+
+Ce paramètre est souvent nécessaire pour certains scripts ou commandes avancées.
+
+**port = 5666**
+
+Définit le port TCP utilisé par le service NRPE pour écouter les connexions entrantes.
+Le port standard NRPE est : 
+* 5666/TCP
+
+**use ssl = false**
+
+Désactive le chiffrement SSL des échanges entre Centreon et NSClient++.
+Les données transitent donc en clair sur le réseau.
+
+**insecure = true**
+
+Désactive certaines vérifications de sécurité liées aux certificats et aux protocoles de chiffrement.
+Associé à use ssl = false, ce paramètre simplifie la mise en oeuvre du service NRPE.
+
+**timeout ) 60**
+
+Détermine le délai maximum accordé à l'exécution d'une requête NRPE avant expiration.
+
+## 5. Redémarrage du service
+
+Une fois les modifications enregistrées dans le fichier nsclient.ini, il est nécessaire de redémarrer le service NSClient++ afin de prendre en compte la nouvelle configuration.
+Vous pouvez effectuer cette opération :
+* Depuis la console Service Windows (services.msc)
+* Ou via une invite de commandes administrateur
+```bash
+net stop nscp
+net start nscp
+```
+
+## 6. Configuration Centreon
+
+Après la configuration de l'agent NSClient++, il est nécessaire de modifier les paramètres de l'hôte supervisé dans Centreon.
+
+**Macros personnalisée**
+
+Dans les macros personnalisées de l'hôte, renseigner la valeur suivante :
+```bash
+Macro : NRPEEXTRATIONS
+Valeur : -n -2 -t 30
+```
+**Description des options**
+* **-n** : Désactive le chiffrement SSL côté Centreon
+* **-2** : Force l'utilisation du protocole NRPE version 2
+* **-t 30** : Définit un délai d'attente de 30 secondes pour les contrôles NRPE
+
+## 7. Validation
+
+Une fois la configuration terminée :
+
+* Vérifier que le port **5666/TCP** est accessible depuis le poller Centreon
+* Redémarrer le service NSClient++
+* Effectuer un test de supervision depuis Centreon
+* Contrôler que les services remontent correctement et que les états sont au vert
+
+**La communcation Centreon <-> NSClient ++ est désormais opérationnelle pour le modèle de supervision OS-Windows-NRPE-2-Disks**
\ No newline at end of file