====== NSClient++ ======
Der NSClient ist der Windows-Client für NRPE.
Downloaden kann man den Client hier: [[https://www.nsclient.org/download/]]
Der Nagiosserver fragt den NSClient per "check_nrpe" ab.

===== Installation =====
Der Client kann defaultmäßig instliert werden.
Wenn nichts eingestellt ist, benötigt man Certifikate zur verschlüsselten Kommunikation zwischen Server und Client.
Benötigt man keine Verschlüsselung, kann diese in der Install-GUI abschalten, oder in der Konfiguration diesen Parameter wie folgt setzen:
<code>insecure = true</code>

===== Module =====
Der NSClient besteht aus Modulen, welche aktiviert und konfiguriert werden können.

^ Modulname ^ Beschreibung ^
| [[#NRPE-Client|NRPE]] | Protokol über das Nagios zum NSClient spricht. |
| [[#NSCA-Client|NSCA]] | Protokol mit dem der Client zu Nagios kommunizieren kann |
| [[#Webserver|WEBServer]] | Webserver im NSClient |

===== Konfiguration =====
Nach der Installation sollte die ''nsclient.ini'', aus dem Installationsverzeichnis, angepasst werden. Man kann sich aber auch eine allgemeine Konfigurationsdatei erstellen, und
diese immer anwenden.
Nachdem die ''nsclient.ini'' angepasst wurde, muss der Dienst zwingend neugestartet werden.

Nachfolgend werden Konfigurationsbeispiele als einzelne Abschnitte der ''nsclient.ini'' beschrieben.

==== Defaults (unverschlüsselt) ====
Diese Defaults sollten immer angepasst werden.
<code>[/settings/default]
allowed hosts = 127.0.0.1, <WEITERE_IP>, <WEITERE_IP>
bind to = 
cache allowed hosts = true
inbox = inbox
timeout = 30
use ssl = false</code>

==== NRPE-Client ====
<code>[/modules]
NRPEClient = 0</code>
<code>[/settings/NRPE/client]
channel = NRPE</code>

==== NSCA-Client ====
<code>[/modules]
NSCAClient = 0</code>
<code>[/settings/NSCA/client]
channel = NSCA
hostname = auto</code>

==== Webserver ====
Die URL für die Webseite lautet [[https://127.0.0.1:8443/]]
<code>[/modules]
; Start NSClient++ WebServer
WEBServer = 1

[/settings/WEB/server]
allowed hosts = 127.0.0.1
cache allowed hosts = true
certificate = ${certificate-path}/certificate.pem
password = <PASSWORD>
port = 8443</code>

==== Aliase ====
Mit Aliasen kann man den eigentlichen Check-Befehlen, mit ihren Parametern, aussagekräftige Namen geben, welche in Nagios dann als Argument für den Befehl verwendet werden können.
Syntax:
<code>[/settings/external scripts/alias]
<ALIAS_NAME> = <CHECK_COMMAND> <ARGUMENTS></code>

Beispiele:
<code>[/settings/external scripts/alias]
; alias_cpu - Alias for alias_cpu. To configure this item add a section called: /settings/external scripts/alias/alias_cpu
alias_cpu = checkCPU warn=80 crit=90 time=5m time=1m time=30s</code>
<code>[/settings/external scripts/alias]
; alias_process - Alias for alias_process. To configure this item add a section called: /settings/external scripts/alias/alias_process
alias_process = checkProcState "$ARG1$=started"

; alias_process_count - Alias for alias_process_count. To configure this item add a section called: /settings/external scripts/alias/alias_process_count
alias_process_count = checkProcState MaxWarnCount=$ARG2$ MaxCritCount=$ARG3$ "$ARG1$=started"</code>