ICINGA (NAGIOS FORK) INSTALL FAQ AUF DEBIAN SQUEEZE

ICINGA (NAGIOS FORK) INSTALL FAQ AUF DEBIAN SQUEEZE (Stand 16.10.2012) [ © Oliver Schuetz aka OppTupacShakur | http://OPPServer.net | http://unix.oppserver.net ]

Hier unsere Server/Client Beispiele dieser Anleitung:

ICINGA Server, Debian Squeeze 6.0x, IP 192.168.1.12, Hostname icinga.domain.de
Client 1/Homeserver, Debian Squeeze 6.0x, IP 192.168.1.13, Hostname homeserver.domain.de

Als erstes als User root einloggen:

sudo -s

SERVER PART

Benoetigte Pakete installieren (Debian Backports wird benoetigt):

aptitude install apache2 libapache2-svn mysql-server mysql-admin libdbd-mysql libapache2-mod-php5 php5-cgi php5-xsl php5-mcrypt php5-curl php5-imagick php5-mysql php5-pgsql php5-tidy php5-dev php5-cli phpmyadmin nagios-nrpe-plugin 
aptitude -t squeeze-backports install icinga icinga-idoutils icinga-doc icinga-phpapi

Apache mod_rewrite aktivieren:

a2enmod rewrite
/etc/init.d/apache2 reload

Konfiguriere icinga-cgi

Bitte waehlen Sie, welche Apache-Server fuer Icinga eingerichtet werden sollen. Hier waehlen wir apache2, damit icinga nachher per http://domain.de/icinga erreichbar ist.

Bitte geben Sie das Passwort fuer den Benutzer »icingaadmin« ein. Hier geben wir das neue Passwort fuer das icinga Webinterface an.

Konfiguriere icinga-idoutils

Konfigurieren der Datenbank fuer icinga-idoutils mit dbconfig-common? 
Ja

Datenbanktyp, der durch das Paket icinga-idoutils benutzt werden soll
mysql

Passwort des administrativen Datenbank-Benutzers:
mysql root Passwort

icinga Mysql Passwort einfach leer lassen, dann wird automatisch eins erzeugt.

Icinga stopen:

/etc/init.d/icinga stop

ido2db stopen:

/etc/init.d/ido2db stop

In /etc/icinga/objects/contacts_icinga.cfg aendern wir zuerst die Kontaktinformationen, damit die Benachrichtigungen auch an das richtige Ziel gehen.

Nun richten wir in /etc/icinga/icinga.cfg den cfg_dir fuer die zu ueberwachende Server/Clients ein:

cfg_dir=/etc/icinga/servers

mkdir /etc/icinga/servers

Hier kommen nun die .cfg Dateien fuer die einzelnen Server/Clients rein. Beispiel: /etc/icinga/servers/homeserver.cfg

##### Homeserver Definition #####
define host{
        use                     generic-host            ; Name of host template to use
        host_name               homeserver.domain.de
        alias                   Homeserver
        address                 192.168.1.13
        }

# Definiert ein Service zum ueberpruefen des Pings
define service{
        use                             generic-service         ; Name of service template to use
        host_name                       homeserver.domain.de
        service_description             PING
        check_command                   check_ping!100.0,20%!500.0,60%
}

# Definiert ein Service zum ueberpruefen der Speicherauslastung der root Partition.
# Warnung bei weniger als 10% freien Speicherplatz, Kritisch bei weniger als 5% freien Speicherplatz.
define service{
        use                             generic-service         ; Name of service template to use
        host_name                       homeserver.domain.de
        service_description             Disk Space
        check_command                   check_nrpe!check_all_disks!10%!5%
        }

# Definiert ein Service zum ueberpruefen der zur Zeit eingeloggten User.
# Warnung bei mehr als 20 User, Kritisch bei mehr als 50 User.
define service{
        use                             generic-service         ; Name of service template to use
        host_name                       homeserver.domain.de
        service_description             Current Users
        check_command                   check_nrpe!check_users!20!50
        }

# Definiert ein Service zum ueberpruefen der zur Zeit laufenden Prozesse.
# Warnung bei mehr als 250 Prozessen, Kritisch bei mehr als 400 Prozessen.
define service{
        use                             generic-service         ; Name of service template to use
        host_name                       homeserver.domain.de
        service_description             Total Processes
        check_command                   check_nrpe!check_procs!250!400
        }

# Definiert ein Service zum ueberpruefen der Server load. 
define service{
        use                             generic-service         ; Name of service template to use
        host_name                       homeserver.domain.de
        service_description             Current Load
        check_command                   check_nrpe!check_load!5.0!4.0!3.0!10.0!6.0!4.0
        }

Nun koennen wir auch alle Server/Clients mit ihren jeweiligen host_name in die /etc/icinga/objects/hostgroups_icinga.cfg in hostgroups unter member eintragen. z.B.:

# A list of your ssh-accessible servers
define hostgroup {
        hostgroup_name  ssh-servers
		alias           SSH servers
		members         localhost, homeserver.domain.de
        }

Genauso koennen wir hier auch neue hostgroups hinzufuegen, als Beispiel Mysql:

# A list of your mysql-accessible local servers
define hostgroup {
        hostgroup_name  mysql-servers-local
		alias           MYSQL servers Local
		members         localhost
        }

# A list of your mysql-accessible extern servers
define hostgroup {
        hostgroup_name  mysql-servers-extern
		alias           MYSQL servers Extern
		members         homeserver.domain.de
        }

Hierfuer muss natuerlich der passende service in /etc/icinga/objects/services_icinga.cfg definiert werden:

# check that mysql local services are running
define service {
        hostgroup_name                  mysql-servers-local
        service_description             MYSQL Local
        check_command                   check_mysql_cmdlinecred!icinga!p@ssw0rd
        use                             generic-service
        notification_interval           0 ; set > 0 if you want to be renotified
}

# check that mysql extern services are running
define service {
        hostgroup_name                  mysql-servers-extern
        service_description             MYSQL Extern
        check_command                   check_nrpe!check_mysql_cmdlinecred!icinga!p@ssw0rd
        use                             generic-service
        notification_interval           0 ; set > 0 if you want to be renotified
}

Man kann hier natuerlich noch zig weitere Services definieren, darauf gehen wir aber jetzt nicht genauer ein, man sollte sich dafuer mal in /usr/lib/nagios/plugins umgucken, was es alles fuer check_command gibt.

ido2db einrichten: Zuerst kopieren wir die /usr/share/doc/icinga-idoutils/examples/idoutils.cfg-sample nach /etc/icinga/modules/idoutils.cfg

cp /usr/share/doc/icinga-idoutils/examples/idoutils.cfg-sample /etc/icinga/modules/idoutils.cfg

Nun aendern wir darin folgendes:

path            /usr/sbin/idomod.o

in

path            /usr/lib/icinga/idomod.so

In /etc/icinga/objects/ido2db_check_proc.cfg muessen wir evtl. wieder den host_name anpassen, z.B.:

host_name                       localhost, homeserver.domain.de

In /etc/default/icinga noch folgendes aendern:

IDO2DB=no

in

IDO2DB=yes

Des weiteren schalten wir die check_external_commands in /etc/icinga/icinga.cfg auf 1. Fuegen den User www-data der Gruppe nagios hinzu:

usermod -G nagios www-data

Setzen die Rechte fuer /var/lib/icinga/rw/ richtig:

chmod g+x /var/lib/icinga/rw/

Und restarten den Apache Webserver neu:

/etc/init.d/apache2 restart

Jetzt zuerst ido2db starten:

/etc/init.d/ido2db start

Dann Icinga starten:

/etc/init.d/icinga start

SERVER UND CLIENT PART

check_mysql_cmdlinecred will natuerlich ein Benutzer (hier icinga) und Passwort (hier p@ssw0rd), welchen/s wir an jedem Server/Client erstellen muessen, der auch in der members der Mysql hostgroup eingetragen ist (in unserem Beispiel localhost und homeserver.domain.de):

mysql -u root -p
GRANT USAGE ON *.* TO icinga@localhost IDENTIFIED BY 'p@ssw0rd';
FLUSH PRIVILEGES;
quit;

Damit kann der Benutzer icinga zu Mysql verbinden, hat aber keine Rechte (aendern oder auch lesen).

CLIENT PART aptitude install nagios-nrpe-server Jetzt aendern oder fuegen wir in /etc/nagios/nrpe.cfg die folgenden Zeilen hinzu und erlauben damit icinga.domain.de (192.168.1.12) den Zugriff:

allowed_hosts=127.0.0.1,192.168.1.12
dont_blame_nrpe=1
command[check_users]=/usr/lib/nagios/plugins/check_users -w 20 -c 50
command[check_procs]=/usr/lib/nagios/plugins/check_procs -w 250 -c 400
command[check_all_disks]=/usr/lib/nagios/plugins/check_disk -w '20%' -c '10%' -e
command[check_mysql_cmdlinecred]=/usr/lib/nagios/plugins/check_mysql -H localhost -u 'icinga' -p 'p@ssw0rd'

/etc/init.d/nagios-nrpe-server restart