Das von der Firma NETWAYS GmbH entwickelte Webfrontend NagiosPortal ist ein Addon für Nagios basierend auf Typo3. In der Basis-Ausführung enthält es zwar nicht alle Funktionen die vom cgi-basierenden Nagios-Webfrontend bekannt sind. Im Gegenzug werden jedoch zusätzliche Funktionen angeboten und es ist mit entsprechenden Typo3- und PHP-Kenntnissen flexibel erweiterbar.

Weitere Informationen sind über die NETWAYS Produktseite zugänglich und man kann sich das Portal in einem Demosystem ansehen.

Das NagiosPortal steht als Open Source Produkt unter der GPL V2. Dem Sitepackage beiliegende DOCUMENTATION.txt ist in englischer Sprache verfasst und enthält interessante Zusatzinformationen und sollte daher ergänzend zu Rate gezogen werden. Die folgenden Anleitung bezieht sich auf die Einrichtung des NagiosPortal in der Version 2.1.3 unter CentOS5 und der Verwendung des Apache Httpd Server 2.2.3 Für andere Distributionen und Webserver könnte es notwendig sein Pfade, Dateinamen und/oder Shell-Befehle entsprechend anzupassen.

• Nagios inklusive NDO-DB
• Ein Webserver mit PHP5- und curl-Unterstützung
• MySQL Datenbankserver (für die NDO-DB)

Optional:

• EventDB http://www.nagiosexchange.org/Misc.36.0.html?&tx_netnagext_pi1%5Bp_view%5D=1129
• Fruity DB http://fruity.sourceforge.net/
• Wiki-Software (DokuWiki, Mediawiki, etc.)

Typo3:

Download von http://prdownloads.sourceforge.net/typo3/typo3_src-4.1.5.zip?download

NagiosPortal:

Download des Sitepackage, zum Beispiel von https://www.nagiosforge.org/gf/project/netwaysportal/frs/.

Auch unter http://www.nagiosexchange.org/cgi-bin/pages/Detailed/1440.html ist ein Sitepackage verfügbar.

Es wird jedoch empfohlen die aktuellste Version von nagiosforge.org zu verwenden.

Sitepackage entpacken und in ein Verzeichnis kopieren das sich für WebApplikationen eignet. (zum Beispiel: /usr/local/nagios/share oder /var/www, etc.)

zuweisen der Benutzerrechte:

# chown -R apache:apache /var/www/typo3_src-4.1.5
# chown -R apache:apache /var/www/NagiosPortal-2.1.3
# chmod -R 775 /var/www/typo3_src-4.1.5/typo3/ext/

/etc/httpd/conf.d/nagiosportal.cfg:

<Directory "/var/www/NagiosPortal-2.1.3">
  AllowOverride Authconfig
  Options +Indexes +FollowSymlinks
  Order Deny,Allow
  Allow from 127.0.0.1
</Directory>

Alias /nagios-portal /var/www/NagiosPortal-2.1.3

Neustart des Webserver:

# service httpd restart

Das site package ist dahingehend vorkonfiguriert, daß der Name der Typo3-DB, des DB-Users und dessen Passwort „nagiosportal“ lautet. Sofern also eine neue Datenbank erstellt wird kann dieser User- und Datenbank-Name verwendet werden. Es besteht jedoch die Möglichkeit andere Namen zu wählen und das hier beschriebene Vorgehen mit entsprechenden Werten anzupassen.

mysql> CREATE DATABASE <DATABASE_NAME>;
mysql> GRANT ALL PRIVILEGES ON <DATABASE_NAME>.* TO '<DATABASE_USER>'@'localhost' IDENTIFIED BY '<DATABASE_PASSWORD>';
mysql> FLUSH PRIVILEGES;
mysql> exit

Import der Tabellen und Basisdaten:

# mysql -u <DATABASE_USER> -p<DATABASE_PASSWORD> <DATABASE_NAME>  < /var/www/NagiosPortal-2.1.3/typo3conf/database.sql

Bei Bedarf anpassen der /var/www/Nagiosportal/typo3conf/localconf.php entsprechend der Verbindungsdaten zur vorhandenen Typo3-DB:

$typo_db_username = '<DATABASE_USER>';
$typo_db_password = '<DATABASE_PASSWORD>';
$typo_db_host = '<DATABASE_HOST>';
$typo_db = '<DATABASE_NAME>';

Aufruf des Typo3-Backend: http://localhost/nagios-portal/typo3

Der Login erfolgt unter Verwendung des Usernamen „admin“ und dem Passwort „netways“

Im Typo3-Menü (links) klick auf „Page“. In der Baumstruktur rechts daneben klick auf „NagiosPortal“ (Der Schriftzug auf der 2. Ebene mit dem Papier-Icon! Nicht die oberste Ebene mit der Weltkugel! Nicht auf das Icon sondern auf den Schriftzug klicken!).

Im rechten Bearbeitungsbereich (Workspace) klick auf den Button „Edit page properties“.

Der Bearbeitungsbereich rechts baut sich neu auf. Hier scrollt man runter bis zum Eingabe-Feld von „TSconfig:“.

Dieses Eingabefeld enthält unter anderem das Typo3 Script für die Konfiguration der Verbindungsdaten zur NDO-DB:

tx_netdbdata.template.db {

	ndo-db {
		host = localhost
		name = nagios
		user = nagios
		pass = nagios
		type = pdo_mysql
		persistent = 1
	}
}

Die Werte müssen gegebenenfalls mit den entsprechenden Werten für den Zugriff auf die NDO-DB angepasst werden.

http://localhost/nagios-portal

Der Login erfolgt mit dem Usernamen „admin“ und dem Passwort „password“

Zum Zeitpunkt der Erstellung dieser Anleitung befindet sich das NagiosPortal bzw. das entsprechende site package in einer recht frühen Entwicklungsphase. Nach der ersten Installation war fest zu stellen, dass lediglich die Seiten hinter den Menüpunkten „Overview“, „Hostgroups“ und „Downtimes“ korrekt dargestellt werden. Für die Darstellung von „Hosts“ und „Services“ könnte eine Anpassung der PHP-konfiguration notwendig sein (siehe weiter unten).

Das Dashboard setzt eine entsprechende Konfiguration voraus (siehe eingangs erwähnte DOCUMENTATION.txt).

Beim klick auf „Hosts“ und „Services“ wird die index.php nach einer Weile zum download angeboten statt, daß diese ausgeführt wird. Sollte der Aufruf der Menüpunkte „Hosts“ und „Services“ zu einer leeren Seite im rechten Frame führen könnte eine Ursache sein, daß die Zuweisung des Arbeitsspeichers für PHP zu niedrig konfiguriert wurde. Der optimale Wert wurde nicht im Detail geprüft. Bisher gab es keine Probleme wenn in der php.ini der Wert von memory_limit auf 32M gesetzt wird. Wahrscheinlich ist ein niedrigerer Wert aber auch ausreichend.

Den Menüpunkt „Events“ habe ich nicht verifiziert da ich in meiner Testumgebung derzeit keine EventDB eingerichtet habe.