======Vorwort und Voraussetzungen======
<note>Dieser Artikel stellt ein "//Kochrezept//" für mein fenrtiges IPCop-Plugin **nrpe** (//[[http://ipcop.stankowic-development.net]]//) dar</note>

Mithilfe von NRPE kann ein Host über ein Nagios/Icinga Monitoringsystem bezüglich System-/Status-Veränderungen befragt werden.

Benötigt wird:
  * IPCop-Entwicklungssystem, idealerweise über das folgende Abbild installiert: [[http://it-connect-unix.de/index.php?option=com_jdownloads&view=viewcategory&catid=18&Itemid=78]]
  * Quellcode der NRPE-Plugins bzw. Monitoring-Plugins: [[https://www.monitoring-plugins.org]]
  * Quellcode von **nrpe**: [[http://sourceforge.net/projects/nagios/files/nrpe-3.x/]]

======Monitoring-Plugins======
Die Monitoring-Plugins werden heruntergeladen und auf dem Entwicklungssystem entpackt. Anschließend wird die Übersetzung wie folgt vorgenommen:
<code>
# ./configure --prefix=/var/ipcop/addons/nrpe --disable-nls --libexecdir=/var/ipcop/addons/nrpe/plugins --with-nagios-user=nagios --with-nagios-group=nagios
# make
# make install
# rm -rf /var/ipcop/addons/nrpe/include
</code>

======NRPE======
Zur Übersetzung von NRPE wird der Quellcode von der Projektseite bezogen und ebenfalls auf dem Entwicklungssystem entpackt. Anschließend erfolgt in bereits bekannter Manier das gleiche Übersetzungsprocedere:
<code>
# ./configure --prefix=/var/ipcop/addons/nrpe --sysconfdir=/var/ipcop/addons/nrpe --bindir=/var/ipcop/addons/nrpe --with-nagios-user=nagios --with-nagios-group=nagios --disable-nls --enable-command-args
# make nrpe
</code>

Anschließend muss der ``nagios`` Systembenutzer erstellt werden, bevor der Dienst installiert werden kann:
<code>
# useradd -d /dev/null -M -r -s /bin/false nagios
# make install-daemon
</code>

Darüber hinaus ist es ratsam eine Beispielkonfiguration in der Datei ``/var/ipcop/addons/nrpe/nrpe.cfg`` zu definieren. Diese sollte neben Benutzernamen/-gruppen auch einige andere wichtige Parameter und auch Standard-Plugins enthalten:
<code>
#IPCop NRPE example config
log_facility=daemon
pid_file=/var/run/nrpe.pid
nrpe_user=nagios
nrpe_group=nagios

#nrpe port - feel free to change port to enhance security
server_port=5666

#specify server address to listen to
#server_address=192.168.1.1

#specify hosts which are allowed to talk to us
allowed_hosts=127.0.0.1

#set to 1 if you want to pass args (which IS a security risk!)
dont_blame_nrpe=0

#debug and timeouts
debug=0
command_timeout=60
connection_timeout=300

#some plugins
command[check_users]=/var/ipcop/addons/nrpe/plugins/check_users -w 5 -c 10
command[check_load]=/var/ipcop/addons/nrpe/plugins/check_load -w 15,10,5 -c 30,25,20
command[check_hda1]=/var/ipcop/addons/nrpe/plugins/check_disk -w 20% -c 10% -p /dev/hda1
command[check_zombie_procs]=/var/ipcop/addons/nrpe/plugins/check_procs -w 5 -c 10 -s Z
command[check_total_procs]=/var/ipcop/addons/nrpe/plugins/check_procs -w 150 -c 200
</code>

======Tarball erstellen======
Für das spätere Archiv wird ein Ordner angelegt, in welchem die später unterhalb **/var/ipcop/addons/nrpe** einzufügenden Addon-Dateien in einem Tarball komprimiert werden.
<code>
# mkdir nrpe-ipcop-VERSION
# cd nrpe-ipcop-VERSION
# mkdir -p build/nrpe/libs
# cp /PFAD-ZU-NRPE-VERSION/src/send_nsca build/nsca/
# cp /PFAD-ZU-NRPE-VERSION/sample-config/nrpe.cfg build/nrpe/
# cp --preserve=all -r /opt/lib/* build/nrpe/libs
# cd build/
# tar cvfz ../nrpe.tar.gz nrpe/*
</code>

======Installer======
Herzstück des Addons ist ein Installationsskript, welches den **nrpe**-Tarball unterhalb von **/var/ipcop/addons** entpackt und den Nagios-Benutzer erstellt.
Mithilfe der Funktionen **addtofiletail** und **removefromfile** werden diese Eintragungen entsprechend maskiert, damit das Addons auch wieder sauber deinstalliert werden kann.
<code>
#!/bin/bash
# ipcop addon binary installer Ver 0.9b for IPCop 2.0

CMD="$1"

# clear screen
/usr/bin/tput clear

# check
if [ ! -e /usr/lib/ipcop/library.sh ]; then
    echo "Upgrade your IPCop, library.sh is missing"
    exit 1
fi

. /usr/lib/ipcop/library.sh
ismachine i486

if [ ${?} -ne 0 ]; then
    echo "This Addon is for i486 architecture only"
    exit 1
fi

# error handling
err()
{
        echo " "
        echo "Error : $1 "
        echo " "
        echo "Choose your option:"
        echo " "
        echo "./install -i   ---> to install"
        echo "./install -u   ---> to uninstall"
        echo " "
exit;exit;
}

# installation
ai()
{
	#create user
	/usr/sbin/useradd -d /dev/null -M -r -s /bin/false nagios
	#extract tarball and copy configuration
        tar xfz nrpe.tar.gz -C /var/ipcop/addons > /dev/null
	#copy configuration and rc-stuff
	cp nrpe.cfg /var/ipcop/addons/nrpe
	cp rc.nrpe /etc/rc.d
	addtofiletail nrpe local.add /etc/rc.d/rc.event.local
	echo "nrpe 5666/tcp" >> /etc/services
}

# deinstallation
au()
{
	#kill nrpe and delete user/files
	/usr/bin/killall -KILL nrpe 2> /dev/null
	rm -rf /var/ipcop/addons/nrpe
	rm /etc/rc.d/rc.nrpe
	/usr/sbin/userdel nagios
	removefromfile nrpe /etc/rc.d/rc.event.local
	grep -v "nrpe 5666/tcp" /etc/services > tmp
	mv tmp /etc/services
}


case $CMD in
         -i|i|install)
                echo " "
                echo "Installing now ..."
                ai
                echo "Successfully done!"
                echo " "
                echo "NOTE: dont forget to check /var/ipcop/addons/nrpe/nrpe.cfg"
                echo "      setup firewall rule to ensure connectivity from your nagios/icinga host to your ipcop"
                echo " ";;

        -u|u|uninstall)
                echo " "
                echo "Deinstalling now ..."
                au
                echo "Successfully done!"
                echo " "
                echo "NOTE: dont forget to delete nrpe firewall rule"
                echo " ";;
        *)
        err "Invalid Option";;
esac
sync
#end of file
</code>

======Packen und Aufräumen======
Letztendlich kann der Addon-Ordner (//mit Ausnahme des **build**-Ordners//) in einen Tarball verwandelt werden, damit das Addon komfortabel installiert werden kann:

<code>
# tar cfz nrpe-ipcop-VERSION.tar.gz nrpe-ipcop-VERSION/{local.add,install,nrpe.tar.gz}
# md5sum nrpe-ipcop-VERSION.tar.gz > nrpe-ipcop-VERSION.tar.gz.md5sum
</code>

Auf dem Entwicklungssystem können die Daten unterhalb /opt entfernt werden:
<code>
# rm -rf /opt
</code>