maxime/Procedure-Systel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Maxime BOURIEAU
2026-10-13 09:04:01 +02:00
parent 37bc2b7e5d
commit 0fa04f4f4e
1 changed files with 53 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Centreon/Configuration du fichier NSClient++ pour le modèle OS-Windows-NRPE-2-Disks.md
+53 -57
View File
@@ -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 ## 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 ## 2. Emplacement du fichier de configuration
Le fichier de configuration NSClient++ se trouve sur le serveur Windows à superviser : Le fichier de configuration NSClient++ se trouve sur le serveur Windows à superviser :
* C:\Program Files\NSClient++\nsclient.ini * `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.
Il est recommandé d'ouvrir ce fichier avec Notepad++ pour faciliter la modification et l'enregistrement des paramètres.
## 3. Configuration de base ## 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 ```ini
[/module] [/modules]
CheckSystem = 1 CheckSystem = 1
CheckDisk = 1 CheckDisk = 1
CheckExternalScripts = 1 CheckExternalScripts = 1
NRPEServer = 1 NRPEServer = 1
``` ```
**Section [\settings.default]** **Section `[/settings/default]`**
```bash ```ini
[/settings/default] [/settings/default]
; Adresse IP du collecteur/poller Centreon ; Adresse IP du collecteur/poller Centreon
allowed hosts = 127.0.0.1,<IP_DU_POLLER> allowed hosts = 127.0.0.1,<IP_DU_POLLER>
timeout = 60 timeout = 60
``` ```
**Section [/settings/NRPE/server]** **Section `[/settings/NRPE/server]`**
```bash ```ini
[/settings/NRPE/server] [/settings/NRPE/server]
allow arguments = true allow arguments = true
allow nasty characters = true allow nasty characters = true
port = 5666 port = 5666
use sll = false use ssl = false
insecure = true insecure = true
timeout = 60 timeout = 60
``` ```
@@ -50,35 +51,34 @@ timeout = 60
### 4.1 Section [/module] ### 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 #### CheckSystem = 1
Active le module de supervision système. Il permet à Centreon de contrôler : Active le module de supervision système. Il permet à Centreon de contrôler :
* L'utilisation du processeur (CPU) * L'utilisation du processeur (CPU).
* La consommation de la mémoire vive (RAM) * La consommation de la mémoire vive (RAM).
* L'état des services Windows * L'état des services Windows.
#### CheckDisk = 1 #### CheckDisk = 1
Active le module de supervision du stockage. Il est indispensable pour surveiller : Active le module de supervision du stockage. Il est indispensable pour surveiller :
* L'espace disque disponible * L'espace disque disponible.
* L'utilisation des volumes * L'utilisation des volumes.
* Les fichiers d'échange (swap)
#### CheckExternalScripts = 1 #### 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 PowerShell.
* Scripts Batch (.bat) * Scripts Batch (`.bat`).
* Scripts personnalisés * Scripts personnalisés.
#### NRPEServer = 1 #### 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] ### 4.2 Section [/settings/default]
@@ -90,9 +90,9 @@ Exemple :
allowed hosts = 127.0.0.1, 192.168.1.10 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. 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 #### 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 : Exemple :
* Seuil d'alerte CPU à 80 % * Seuil d'alerte CPU à 80 %.
* Seuil d'espace disque libre à 10 % * Seuil d'espace disque libre à 10 %.
#### allow nasty characters = true #### allow nasty characters = true
@@ -115,43 +115,39 @@ Autorise l'utilisation de caractères spéciaux dans les arguments transmis par
Exemples : Exemples :
* - * `-`
* $ * `$`
* | * `|`
* & * `&`
Ce paramètre est souvent nécessaire pour certains scripts ou commandes avancées. Ce paramètre est souvent nécessaire pour certains scripts ou commandes avancées.
#### port = 5666 #### port = 5666
Définit le port TCP utilisé par le service NRPE pour écouter les connexions entrantes. Définit le port TCP utilisé par le service NRPE pour écouter les connexions entrantes. Le port standard NRPE est :
Le port standard NRPE est :
* 5666/TCP * `5666/TCP`
#### use ssl = false #### use ssl = false
Désactive le chiffrement SSL des échanges entre Centreon et NSClient++. 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.
Les données transitent donc en clair sur le réseau.
#### insecure = true #### insecure = true
Désactive certaines vérifications de sécurité liées aux certificats et aux protocoles de chiffrement. 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.
Associé à use ssl = false, ce paramètre simplifie la mise en oeuvre du service NRPE.
#### 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. Détermine le délai maximum accordé à l'exécution d'une requête NRPE avant expiration.
## 5. Redémarrage du service ## 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. 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 :
Vous pouvez effectuer cette opération :
* Depuis la console Service Windows (services.msc) * Depuis la console des services Windows (`services.msc`).
* Ou via une invite de commandes administrateur * Depuis une invite de commandes ouverte en tant qu'administrateur.
```bash ```bat
net stop nscp net stop nscp
net start 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. 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 : Dans les macros personnalisées de l'hôte, renseigner la valeur suivante :
```bash ```text
Macro : NRPEEXTRATIONS Macro : NRPEEXTRATIONS
Valeur : -n -2 -t 30 Valeur : -n -2 -t 30
``` ```
#### Description des options #### Description des options
* **-n** : Désactive le chiffrement SSL côté Centreon * **`-n`** : désactive le chiffrement SSL côté Centreon.
* **-2** : Force l'utilisation du protocole NRPE version 2 * **`-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 * **`-t 30`** : définit un délai d'attente de 30 secondes pour les contrôles NRPE.
## 7. Validation ## 7. Validation
Une fois la configuration terminée : Une fois la configuration terminée :
* Vérifier que le port **5666/TCP** est accessible depuis le poller Centreon * Vérifier que le port **5666/TCP** est accessible depuis le poller Centreon.
* Redémarrer le service NSClient++ * Redémarrer le service NSClient++.
* Effectuer un test de supervision depuis Centreon * Effectuer un test de supervision depuis Centreon.
* Contrôler que les services remontent correctement et que les états sont au vert * Vérifier que les services remontent correctement et que leur état est conforme.
### Conclusion ### 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.