Add initial documentation for NSClient++ configuration and compilation guidelines

2026-09-09 17:21:27 +02:00
parent 3d3923a661
commit 9d978cee9b
3 changed files with 101 additions and 0 deletions
@@ -0,0 +1,79 @@
+## 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.
+
+## 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.
+
+## 3.Configuration de base
+Les paramètres suivants doivent être présents dans le fichier nsclient.ini
+
+**Section [/modules]**
+
+```bash
+[/module]
+CheckSystem = 1
+CheckDisk = 1
+CheckExternalScripts = 1
+NRPEServer = 1
+```
+**Section [\settings.default]**
+
+```bash
+[/settings/default]
+; Adresse IP du collecteur/poller Centreon
+allowed hosts = 127.0.0.1,<IP_DU_POLLER>
+timeout = 60
+```
+**Section [/settings/NRPE/server]**
+
+```bash
+[/settings/NRPE/server]
+allow arguments = true
+allow nasty characters = true
+port = 5666
+use sll = false
+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 ++.
+
+**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
+**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)
+**CheckExternalScripts = 1**
+Autorise l'exécution d scripts externes présents sur le serveur Windows, tel que :
+
+* 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).
+
+### 4.2 Section [/settings/default] Cette section définit les paramètres généreux de communication.
+
+**allowed hosts**
+
+Exemple :
+
+allowed hosts = 127.0.0.1, 192.168.1.10
+
+Dans cet exemple, seul le poller Centreon disposent de l'adresse IP 192.168.1.10 pourra envoyer des requêtes NRPE.
+
+**timeout = 60**
+
+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.