Refactor documentation for NSClient++ configuration, enhancing clarity and detail in sections on module activation, NRPE server settings, and service restart procedures.

This commit is contained in:
Maxime BOURIEAU
2026-09-09 17:37:07 +02:00
parent 9d978cee9b
commit 9d673764a7
@@ -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.
### 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**