Mithilfe von NRPE kann ein Host über ein Nagios/Icinga Monitoringsystem bezüglich System-/Status-Veränderungen befragt werden.
Benötigt wird:
Die Monitoring-Plugins werden heruntergeladen und auf dem Entwicklungssystem entpackt. Anschließend wird die Übersetzung wie folgt vorgenommen:
# ./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
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:
# ./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
Anschließend muss der ``nagios`` Systembenutzer erstellt werden, bevor der Dienst installiert werden kann:
# useradd -d /dev/null -M -r -s /bin/false nagios # make install-daemon
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:
#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
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.
# 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/*
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.
#!/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
Letztendlich kann der Addon-Ordner (mit Ausnahme des build-Ordners) in einen Tarball verwandelt werden, damit das Addon komfortabel installiert werden kann:
# 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
Auf dem Entwicklungssystem können die Daten unterhalb /opt entfernt werden:
# rm -rf /opt