Die Open Monitoring Distribution OMD 0.44 ist da.
OMD ist Paket, welches auf Nagios basiert und die wichtigtsten zusätzlichen Module gleich mit enthält.
Als Test hier eine Installation auf dem SuSE Enterprise Server 11 (SLES11) SP1 / 64 Bit.

Basisinstallation von SLES11

Als Basisinstallation diente eine ‘nackte’ Grundinstallation von SLES11 (Servicepack 1) auf 64 Bit.
Bei der Installation wurden nur die Standardoptionen ausgewählt.

Download von OMD

# wget http://omdistro.org/attachments/download/47/omd-0.44-sles11sp1-19.x86_64.rpm

Benötigte Pakete

Unter SLES11 SP1 (64 Bit) werden die folgenden Pakete benötigt.

# rpm -q –requires -p omd-0.44-sles11sp1-19.x86_64.rpm |sort -u
/bin/sh
apache2
apache2-mod_fcgid
apache2-mod_php5
apache2-mod_python
bind-utils
curl
dialog
fping
graphviz
libpng12-0
libreadline5
mysql
net-snmp
pango
patch
perl-Net-SNMP
perl-SNMP
php5-gd
php5-mbstring
php5-mcrypt
php5-pear
php5-sockets
php5-sqlite
rpmlib(CompressedFileNames) <= 3.0.4-1
rpmlib(PayloadFilesHavePrefix) <= 4.0-1
rpmlib(PayloadIsLzma) <= 4.4.2-1
rsync
samba-client
unzip
xinetd
xorg-x11-fonts

Auf der Installations DVD fehlende Module

Ein erster naiver Veruch der Installation schlägt sofort fehl:

# zypper install omd-0.44-sles11sp1-19.x86_64.rpm
Loading repository data…
Reading installed packages…
Resolving package dependencies…

Problem: nothing provides apache2-mod_fcgid needed by omd-0.44-sles11sp1-19.x86_64
Solution 1: do not ask to install a solvable providing omd-0.44 = 0:sles11sp1-19
Solution 2: break omd-0.44 by ignoring some of its dependencies

Choose from above solutions by number or cancel [1/2/c] (c):c

Hier sollte man unbedingt abbrechen (cancel).

Auf der Installations-DVD fehlen einige Module, die aber trotzdem benötigt werden:

apache2-mod_fcgid

apache2-mod_fcgid ist ein High-Performance Modul für den Apache. Weitere Informationen dazu auf dem Apache-Seiten.

php5-sqlite

php5-sqlite ist eine embedded Datenbank für php. Eine Einführug in sqllite gibt es z.B. hier.

Novell Development Kit (SDK)

Diese Pakete sind im Novell Development Kit (SDK) für SLES11 enthalten.
Achtet darauf, daß das SDK zu Eurem SLES passt! Wer SLES 11 SP1 installiert, muß auch das SP1 des SDK verwenden!
Wir verwenden: SLE-11-SP1-SDK-DVD-x86_64-GM-Media1.iso.
Die DVD muß mit Yast unter Software / Installierte Add-on-Produkte / Hinzufügen eingebunden werden.

Installation

Nachdem das SDK eingebunden ist, sind die benötigten Pakete vorhanden:

# zypper search apache2-mod_fcgid
Loading repository data…
Reading installed packages…

S | Name              | Summary                                | Type
–+——————-+—————————————-+———–
| apache2-mod_fcgid | Alternative FastCGI module for Apache2 | package
| apache2-mod_fcgid | Alternative FastCGI module for Apache2 | srcpackage

Jetzt kann OMD installiert werden:

# zypper install omd-0.44-sles11sp1-19.x86_64.rpm

Loading repository data…
Reading installed packages…
Resolving package dependencies…

The following NEW packages are going to be installed:
apache2-mod_fcgid apache2-mod_python libmcrypt libmysqlclient15 mysql mysql-client net-snmp omd-0.44 perl-Crypt-DES perl-Net-SNMP perl-SNMP php5-gd php5-mbstring php5-mcrypt php5-pear php5-sockets php5-zlib

The following packages need additional customer contract to get support:
libmysqlclient15 mysql mysql-client

The following packages are not supported by their vendor:
apache2-mod_fcgid omd-0.44 php5-sockets

17 new packages to install.
Overall download size: 31.4 MiB. After the operation, additional 112.6 MiB will be used.
Continue? [y/n/?] (y):

OMD ist nun installiert. Schau’n wir mal, was OMD so alles kann:

# omd
Usage (called as root):

omd help                        Show general help
omd setup                       Prepare operating system for OMD (installs packages)
omd uninstall                   Remove OMD and all sites!
omd version                     Show version of OMD
omd versions                    List installed OMD versions
omd sites                       Show list of sites
omd create     SITE             Create a new site
omd rm         SITE             Remove a site (and its data)
omd mv         SITE NEWNAME     Rename a site
omd cp         SITE NEWNAME     Make a copy of a site
omd update     SITE             Update site to other version of OMD
omd start      [SITE] [SERVICE] Start services of one or all sites
omd stop       [SITE] [SERVICE] Stop services of site(s)
omd restart    [SITE] [SERVICE] Restart services of site(s)
omd reload     [SITE] [SERVICE] Reload services of site(s)
omd status     [SITE] [SERVICE] Show status of services of site(s)
omd config     SITE ...         Show and set site configuration parameters

General Options:
-V <version>                    set specific version, usefull in combination with update/create

OMD setup

Jetzt sollte zunächst OMD setup aufgerufen werden.

# omd setup

We will install missing packages from your operating system and setup the
system apache daemon (add configuration files and modules needed by omd)
(yes/NO): yes

Die erste OMD-site anlegen

Mit dem Kommando omd create wird eine komplette Nagioskonfiguration angelegt. Das Besondere an OMD ist, dass es mehrere Installationen auf einem Rechner geben kann. Dazu wird ebenfalls ein Unix-Benutzer für jede site angelegt. (In dem Beispiel unten heisst der Benutzer mysite).

# omd create mysite
Adding /omd/sites/mysite/tmp to /etc/fstab.
Created new site mysite with version 0.44.
Restarting Apache…httpd2-prefork: apr_sockaddr_info_get() failed for berta
httpd2-prefork: Could not reliably determine the server’s fully qualified domain name, using 127.0.0.1 for ServerName
Syntax OK
OK
Creating temporary filesystem…OK
Successfully created site mysite.

The site can be started with omd start mysite.
The default web UI is available at http://berta/mysite/
The admin user for the web applications is omdadmin with password omd.
Please do a su – mysite for administration of this site.

omd config mysite

Mit dem Kommando

# omd config mysite

wird die OMD-Instanz konfiguriert.
In der Default-Einstellung hat jede Site ihren eigenen Webserver. Das ist besonders praktisch, wenn man etwas testen muß und den produktiven apache nicht auch gleich mit stoppen kann / will / darf.

OMD[mysite]:$ omd config show
APACHE_TCP_PORT: 5000
AUTOSTART: on
CORE: nagios
DOKUWIKI_AUTH: off
LIVESTATUS_TCP: off
LIVESTATUS_TCP_PORT: 6557
MYSQL: off
NSCA: off
NSCA_TCP_PORT: 5667
PNP4NAGIOS: on
WEB: welcome
WEBSERVER: own

Verzeichnisstruktur

# su – mysite
OMD[mysite]:~$ pwd
/omd/sites/mysite
OMD[mysite]:~$ ls -l
insgesamt 12
lrwxrwxrwx  1 mysite mysite   11  6. Dez 23:01 bin -> version/bin/
drwxr-xr-x 16 mysite mysite 4096  6. Dez 23:01 etc/
lrwxrwxrwx  1 mysite mysite   15  6. Dez 23:01 include -> version/include/
lrwxrwxrwx  1 mysite mysite   11  6. Dez 23:01 lib -> version/lib/
drwxr-xr-x  5 mysite mysite 4096  6. Dez 23:01 local/
lrwxrwxrwx  1 mysite mysite   13  6. Dez 23:01 share -> version/share/
drwxr-xr-x 14 mysite mysite  280  6. Dez 23:02 tmp/
drwxr-xr-x 11 mysite mysite 4096  6. Dez 23:01 var/
lrwxrwxrwx  1 mysite mysite   19  6. Dez 23:01 version -> ../../versions/0.44/

Die Nagios-Konfigurationsdateien (hosts.cfg, services.cfg,..) müssen übrigens in das Verzeichnis ~/etc/nagios/conf.d.

Ein erster Bick auf OMD

Nach dem Start von OMD steht nagios mit einigen Extras bereit.

OMD[mysite]:# omd start

Mit http://localhost/mysite/omd/ kann man sich die Seite im Webbrowser bereits anschauen. (User: omdadmin, Passwort omd).

Ändern des Passwortes

Das Standardpasswort muß schleunigst geändert werden. Dazu wechselt man in das Verzeichnis ~/etc und startet htpasswd2.
Die Passworte für den Apache sind in der Datei ~/etc/htpasswd gespeichert.

OMD[mysite]:~/etc$ ls
apache/    dokuwiki/    htpasswd jmx4perl/       nagios/  nsca/  pnp4nagios/  rrdcached.conf  xinetd.conf
check_mk/  environment  init.d/   mk-livestatus/  nagvis/  omd/   rc.d/        thruk/          xinetd.d/
OMD[mysite]:~/etc$ htpasswd2 htpasswd omdadmin
New password:
Re-type new password:
Updating password for user omdadmin

Die neuen Oberflächen

Seit V0.44 gibt es bei OMD die Qual der Wahl. Es stehen gleich mehrere Nagios-Oberflächen im Webbrowser zur Verfügung.

Zur Auswahl stehen

• das klassische Nagios-GUI
• das check_mk GUI
• das Truk Monitoring Interface
• das Addon NagVis

Mit den schönen Grafiken von von Matthias Kettners check_mk kann ich nun endlich meine Seite überwachen

check_snmp

Update (13.01.2011)

Leider fehlt check_snmp in OMD 0.44 für SLES11.

Links

• omdistro.org die Homepage von OMD
• OMD bei Mattias Kettner (einer der Autoren)
• Das Update-Konzept von OMD.
  (Wer 2 Versionen von OMD installiert hat, sollte ggf. update-alternatives überprüfen)
• OMD 0.44 erschienen

Update (20.02.2011): OMD 0.46

Mittlerweile ist die neue stabile Version OMD 0.46 da.