====== NRPE ======
  * Mit nrpe (Nagios Remote Plugin Executor) ist es möglich, Plugins auf entfernten Rechnern auszuführen.
  * Soll zum Beispiel der verfügbare Speicherplatz auf einem entfernten Rechner überprüft werden, wird das Plugin check_nrpe (Client) auf dem Nagios-Rechner ausgeführt. check_nrpe sendet nun einen String an den zu überwachenden Rechner. Der dort (auf Port 5666) hörende NRPE-Dienst (Server) vergleicht den ankommenden String mit den in seiner Konfigurationsdatei hinterlegten. Jedem dieser Strings ist ein Kommando zugeordnet. Findet er den vom Nagios Gesendeten in seiner Konfiguration, führt er das zugehörige Kommando aus und schickt das Ergebnis (Exitcode und Ausgabe) an check_nrpe der Nagiosmaschine zurück. check_nrpe wiederum reicht das Ergebnis an Nagios weiter, wo es, wie die Ergebnisse anderer Plugins auch dargestellt wird.

Via NRPE lassen sich nicht nur Checks aussführen, sondern jegliches Kommando. Aus diesem Grund besteht die Möglichkeit, die komplette Kommunikation (check_nrp <--> NRPE-Dienst) verschlüsselt ablaufen zu lassen. Weiterhin können nur die in der Konfigurationsdatei des NRPE-Dienstes festgelegten Kommandos ausgeführt werden. Diese Datei wird beim Starten des NRPE-Dienstes eingelesen, weswegen Änderungen in dieser Datei logischerweise einen Neustart des Dienstes nach sich ziehen.

===== Installieren =====
==== Windows ====
  * Den aktuellen nrpe-Dienst (hier: nrpe_nt.0.8-bin.zip) herunterladen: \\ http://www.miwi-dv.com/nrpent/
  * Zusätzlich die Standard-Plugins herunterladen: \\ http://www.nagiosexchange.org/cgi-bin/page.cgi?g=Detailed%2F2131.html;d=1
  * Entpacken des nrpe-Dienst in C:\NRPE
  * Im Verzeichniss bin\ taucht die wichtige Konfigurationsdatei nrpe.cfg auf.
  * Entpacken der Standard-Plugins in ''C:\NRPE\bin''
  * Jetzt befinden sich die 5 Plugins in diesem Verzeichnis:
    - diskspace_nrpe_nt.exe
    - cpuload_nrpe_nt.exe
    - memload_nrpe_nt.exe
    - service_nrpe_nt.exe
    - eventlog_nrpe_nt.exe
  * Zum installieren des nrpe-Dienstes in der Kommandozeile (cmd)<code>nrpe_nt –i</code> ausführen.
  * Zum Starten des Dienstes <code>net start nrpe_nt</code> ausführen (oder über die Dienste-Verwaltung von Windows starten)
  * Folgendes beachten bei der Konfiguration der nrpe.cfg:
    * Unter „allowed_hosts“ sollte natürlich der Nagios-Server stehen!
    * Standard-Port ist server_port=5666 (wenn vorhanden Firewall anpassen!)
  * Beispiel für Speicherplatz-Check: <code>command[nt_check_disk_c]=C:\NRPE\bin\diskspace_nrpe_nt.exe c: 80 90</code>
  * Beispiel für CPU-Auslastung: <code>command[nt_check_cpuload]=C:\NRPE\bin\cpuload_nrpe_nt.exe 90 95</code>
  * Beispiel für service-check: <code>command[nt_check_NTsyslog_service]=C:\NRPE\bin\service_nrpe_nt.exe "NTsyslog"</code>

=== NSClient++ ===
Für Windows gibt es noch einen anderen Serverdienst, welcher mit NRPE kommuniziert.
Siehe [[linux:nagios:nsclient]]

==== Linux ====
=== Vorbereiten des Betriebssystems ===
User anlegen, mit dem der Nagios NRPE später laufen soll: <code bash>useradd -M -s /bin/bash nagios</code>
Pakete installieren
  apt-get install libssl-dev build-essential

                             Nun dem OS noch sagen, dass der Service NRPE auf Port 5666 TCP laufen soll:
                             <code>echo "nrpe 5666/tcp" >> /etc/services</code>

=== Installation der Nagios-Plugins ===
Die Nagios Plugins, als User "nagios" wie [[http://wiki.stizi.de/linux:nagios:nagiosinstallation#nagios_plugins|hier]] beschrieben installieren.

=== Installation des NRPE Daemons ===
  * Aktuelle Version (hier: nrpe-3.2.1)herunterladen: <code bash>wget https://github.com/NagiosEnterprises/nrpe/releases/download/nrpe-3.2.1/nrpe-3.2.1.tar.gz</code>
  * Konfigurieren als User "nagios" mit <code>./configure --enable-command-args --enable-bash-command-substitution</code> Manchmal kann es vorkommen dass die "ssl-libraries" nicht gefunden werden. Dann einfach nach diesen (libssl.so) suchen und dann den jew. Pfad verwenden  <code>--with-ssl-lib=/usr/lib/x86_64-linux-gnu</code>
  * kompilieren mit <code bash>make -j all</code>
  * installieren als User "root" <code bash>make install-groups-users
make install
make install-config
make install-init
systemctl enable nrpe.service</code>
  * Die ausführbare Datei check_nrpe befindet sich im Verzeichniss ''src/'' \\ Diese Datei wird nach ''/usr/local/nagios/libexec/'' kopiert
  * Die Dateien ''services.cfg'' und ''checkcommands.cfg'' sollten den eigenen Vorstellungen entsprechend angepasst werden. \\ Beispiel checkcommands.cfg: <code>define command{
command_name nt_check_disk_c
command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c
nt_check_disk_c
}</code> Beispiel services.cfg: <code>define service{
host_name fileserver1
service_description Speicherplatz Partition C
check_command nt_check_disk_c
max_check_attempts 3
normal_check_interval 1
retry_check_interval 1
check_period 24x7
notification_interval 10
notification_period 24x7
notification_options w,c,u,r
contact_groups Nagios_Admin
}</code>

=== NRPE einrichten ===
Nun noch einige Einstellungen vornehmen.
  mkdir -p /usr/local/nagios/etc
  cp <PFAD_ZU_NRPE_INSTALLATIONSVERZEICHNIS>/sample-config/nrpe.cfg /usr/local/nagios/etc
  cp init-script.debian /etc/init.d/nrpe
  chmod 755 /etc/init.d/nrpe
  update-rc.d nrpe defaults

NRPE Konfigurationsdatei anpassen
  vi /usr/local/nagios/etc/nrpe.cfg
Folgende Zeilen anpassen:
<code>allowed_hosts=<NRPE_CLEINT_IP>
dont_blame_nrpe=1</code>
Ganz unten kann man noch "commands" angeben die der NRPE bedienen soll.

NRPE kann nun gestartet und abgefragt werden.

**Folgende Punkte können noch zusätzlich angegangen werden** 
Beim Aufruf kann man wählen, ob NRPE über XINETD oder als Daemon laufen soll. Davon abhängig sind die weiteren Vorbereitungen.

Wir benutzen überall den XINETD, da dieser über den TCPWrapper schon dafür sorgt, dass nur der Monitoringhost eine Verbindung aufbauen kann. Außerdem werden so bei jedem CHECK die configs neu angezogen, man spart sich also den reload des laufenden Daemons.

== Starten über den XINETD ==
Wir müssen dem XINETD nur im Config-Verzeichnis eine weitere Config für NRPE hinterlegen:
<code>cat <<EOF >/etc/xinetd.d/nrpe
# default: on
# description: NRPE (Nagios Remote Plugin Executor)
service nrpe
{
        flags           = REUSE
        socket_type     = stream
        wait            = no
        user            = nagios
        group           = nagios
        server          = /usr/local/nagios/nrpe
        server_args     = -c /usr/local/nagios/nrpe.cfg --inetd
        log_on_failure  += USERID
        disable         = no
        only_from       = IP_OF_YOUR_MONITORING_HOST
}
EOF
</code>

== Tipps & Tricks bei der Verwendung von NRPE ==
== Perl ==
Einige Perl Plugins haben Probleme, dass sie die utils.pm unter /usr/local/nagios/libexec (Standardpfad) nicht finden.
Kopier das PM in den Perl Include Pfad ..
Ein kurzes <code>perl -e 'print join "\n", @INC'</code> druckt uns die Include Pfade aus. Irgendwo hier wird unser utils.pm auch sein neues zuhause finden :-)
== Environment Entries ==
Bei Websphere und Oracle hatte ich öfters Probleme, dass die Environment Entries nicht so gepasst haben wie es nötig gewesen wäre.
Einfach ein Shellscript drum-rum wrappen und innerhalb des Scripts die ENV Entries setzen
== NRPE & sudo ==
Sudo-Probleme ueber NRPE sind manchmal schwer zu identifizieren, weil sich sudo per NRPE anders verhaelt als ueber die Kommandozeile, wenn in der /etc/sudoers die Zeile
<code>Defaults    requiretty</code> gesetzt ist.
Dieses Setting fuehrt dazu, dass nicht interaktive sudo-Aufrufe (also auch NRPE) nicht moeglich sind!
Richtig waere also:
<code>#Defaults    requiretty</code>