Refine NSClient++ configuration documentation for Windows, enhancing clarity and consistency in language and formatting.

This commit is contained in:
Maxime BOURIEAU
2026-10-13 09:04:01 +02:00
parent 37bc2b7e5d
commit 0fa04f4f4e
@@ -1,47 +1,48 @@
# Configuration du fichier NSClient++ pour le modèle OS-Windows-NRPE-2-Disks
# Configurer NSClient++ pour le modèle OS-Windows-NRPE-2-Disks
## 1. Objectif
Cette procédure décrit la configuration de l'agent NSClient ++ sur un serveur Windows afin de permettre sa supervision par Centreon à l'aide du protocole NRPE.
Cette procédure décrit la configuration de l'agent NSClient++ sur un serveur Windows afin de permettre sa supervision par Centreon au moyen du protocole NRPE.
## 2. Emplacement du fichier de configuration
Le fichier de configuration NSClient++ se trouve sur le serveur Windows à superviser :
* C:\Program Files\NSClient++\nsclient.ini
Il est recommandé d'ouvrir ce fichier avec Notepad++ afin de faciliter les modifications et l'enregistrement des paramètres.
* `C:\Program Files\NSClient++\nsclient.ini`
Il est recommandé d'ouvrir ce fichier avec Notepad++ pour faciliter la modification et l'enregistrement des paramètres.
## 3. Configuration de base
Les paramètres suivants doivent être présents dans le fichier nsclient.ini
Les paramètres suivants doivent être présents dans le fichier `nsclient.ini`.
**Section [/modules]**
**Section `[/modules]`**
```bash
[/module]
```ini
[/modules]
CheckSystem = 1
CheckDisk = 1
CheckExternalScripts = 1
NRPEServer = 1
```
**Section [\settings.default]**
**Section `[/settings/default]`**
```bash
```ini
[/settings/default]
; Adresse IP du collecteur/poller Centreon
allowed hosts = 127.0.0.1,<IP_DU_POLLER>
timeout = 60
```
**Section [/settings/NRPE/server]**
**Section `[/settings/NRPE/server]`**
```bash
```ini
[/settings/NRPE/server]
allow arguments = true
allow nasty characters = true
port = 5666
use sll = false
use ssl = false
insecure = true
timeout = 60
```
@@ -50,35 +51,34 @@ timeout = 60
### 4.1 Section [/module]
Cette section permet d'activer (1) ou de désactiver (0) les différents modules de l'agent NSClient ++.
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 :
* L'utilisation du processeur (CPU)
* La consommation de la mémoire vive (RAM)
* L'état des services Windows
* L'utilisation du processeur (CPU).
* La consommation de la mémoire vive (RAM).
* L'état des services Windows.
#### CheckDisk = 1
Active le module de supervision du stockage. Il est indispensable pour surveiller :
* L'espace disque disponible
* L'utilisation des volumes
* Les fichiers d'échange (swap)
* L'espace disque disponible.
* L'utilisation des volumes.
#### CheckExternalScripts = 1
Autorise l'exécution de scripts externes présents sur le serveur Windows, tel que :
Autorise l'exécution de scripts externes présents sur le serveur Windows, tels que :
* Scripts PowerShell
* Scripts Batch (.bat)
* Scripts personnalisés
* Scripts PowerShell.
* Scripts Batch (`.bat`).
* Scripts personnalisés.
#### 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).
Active le serveur NRPE intégré à NSClient++. Ce service permet au poller Centreon d'interroger le serveur Windows au moyen du protocole NRPE (Nagios Remote Plugin Executor).
### 4.2 Section [/settings/default]
@@ -90,9 +90,9 @@ Exemple :
allowed hosts = 127.0.0.1, 192.168.1.10
Dans cet exemple, seul le poller Centreon disposant de l'adresse IP 192.168.1.10 pourra envoyer des requêtes NRPE.
Dans cet exemple, seul le poller Centreon dont l'adresse IP est `192.168.1.10` pourra envoyer des requêtes NRPE.
#### timeout (default) = 60
#### Délai d'attente par défaut (`timeout = 60`)
Définit le délai maximal d'attente d'une requête avant expiration.
@@ -102,12 +102,12 @@ 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.
Autorise le poller Centreon à transmettre des arguments dynamiques aux commandes exécutées sur le serveur. N'activer cette option que si elle est nécessaire et limiter l'accès au service NRPE aux pollers autorisés.
Exemple :
* Seuil d'alerte CPU à 80 %
* Seuil d'espace disque libre à 10 %
* Seuil d'alerte CPU à 80 %.
* Seuil d'espace disque libre à 10 %.
#### allow nasty characters = true
@@ -115,43 +115,39 @@ Autorise l'utilisation de caractères spéciaux dans les arguments transmis par
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 :
Définit le port TCP utilisé par le service NRPE pour écouter les connexions entrantes. Le port standard NRPE est :
* 5666/TCP
* `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.
Désactive le chiffrement SSL des échanges entre Centreon et NSClient++. Les données transitent donc en clair sur le réseau ; réserver cette configuration à un réseau de confiance.
#### 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.
Désactive certaines vérifications de sécurité liées aux certificats et aux protocoles de chiffrement. Cette option ne chiffre pas les échanges et ne remplace pas une configuration réseau sécurisée.
#### timeout = 60
#### Délai d'attente 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 :
Après avoir enregistré les modifications dans `nsclient.ini`, redémarrer le service NSClient++ pour appliquer la nouvelle configuration. Cette opération peut être effectuée :
* Depuis la console Service Windows (services.msc)
* Ou via une invite de commandes administrateur
* Depuis la console des services Windows (`services.msc`).
* Depuis une invite de commandes ouverte en tant qu'administrateur.
```bash
```bat
net stop nscp
net start nscp
```
@@ -160,30 +156,30 @@ net start nscp
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
### Macro personnalisée
Dans les macros personnalisées de l'hôte, renseigner la valeur suivante :
```bash
```text
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
* **`-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
* 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.
* Vérifier que les services remontent correctement et que leur état est conforme.
### Conclusion
La communication Centreon <-> NSClient ++ est désormais opérationnelle pour le modèle de supervision OS-Windows-NRPE-2-Disks
La communication entre Centreon et NSClient++ est désormais configurée pour le modèle de supervision OS-Windows-NRPE-2-Disks.