Leitfaden für die Installation und Einrichtung von Jffnms

1.  Jffnms Grundlagen

Einführung

Jffnms ist ein Verwaltungs- und Überwachungssystem für das Netzwerk. Es erlaubt Ihnen Informationen von vielen verschiedenen Hosts und Protokollen einzuholen. Mit diesem Leitfaden wollen wir Ihnen zeigen, wie Sie Jffnms vernünftig installieren und ihre Systeme mit diesem erstaunlichen Tool überwachen.

2.  Erste Einrichtung

Wählen Ihrer USE-Flags

Das Jffnms-Ebuild verfügt über folgende USE-Flags:

USE-Flags für PHP

Da Jffnms in PHP geschrieben ist, ist es sehr stark von den PHP USE-Flags abhängig. Um Jffnms erfolgreich zu installieren, müssen Sie Ihr PHP-Paket mit (mindestens) folgenden USE-Flags installiert haben:

Installation

Wie jedes andere Paket in Portage kann Jffnms mit Hilfe von emerge installiert werden:

# emerge jffnms

Jffnms sollte in /opt/jffnms/ installiert werden.

Konfiguration von Apache 2

Manchmal möchten Sie Jffnms auf Ihrem lokalen Rechner anstatt auf einem entfernten Server ausführen. Falls das der Fall ist, ist es sehr wahrscheinlich, dass Sie keinen Apache-Server laufen haben. Sie müssen sich aber keine Gedanken um die Installation von Apache machen, das hat Portage bereits für Sie erledigt. Trotzdem müssen Sie Apache noch konfigurieren und testen, was allerdings (glücklicherweise) ziemlich unkompliziert ist. Beginnen Sie, indem Sie Apache zu Ihrem Standard-Runlevel hinzufügen:

# rc-update add apache2 default

Wenn Sie es noch nicht gemacht haben, ist es nun an der Zeit Apache 2 zu starten:

# /etc/init.d/apache2 start

Wenn Sie nun mit Ihrem Browser http://localhost/ aufrufen, sollten Sie mit einer Homepage über Ihren neu installierten Apache 2 begrüßt werden. Jetzt, wo wir wissen, dass Apache läuft, können wir mit der Konfiguration von mod_php fortfahren. Starten Sie Ihren bevorzugten Texteditor, öffnen Sie /etc/conf.d/apache2 und fügen Sie -D PHP5 zu der Variable APACHE2_OPTS hinzu.

# nano -w /etc/conf.d/apache2
APACHE2_OPTS="-D DEFAULT_VHOST -D PHP5"

Anschließend sollten Sie einen symbolischen Link auf das Installationsverzeichnis von Jffnms in Ihrem Dokument-Root-Verzeichnis von Apache erstellen. In Gentoo benutzt Apache standardmäßig /var/www/localhost/htdocs als sein Dokument-Root-Verzeichnis. Daher sollten Sie das folgende durchführen:

# cd /var/www/localhost/htdocs && ln -s /opt/jffnms/

Konfiguration von PHP

Jetzt, wo Apache läuft, ist es an der Zeit PHP zu konfigurieren. Damit Jffnms lauffähig ist, müssen Sie einige Variablen in der Datei php.ini setzen. Die Datei php.ini finden Sie normalerweise unter /etc/php/apache2-php5/php.ini. Sie müssen die Variablen wie folgt setzen:

# nano -w /etc/php/apache2-php5/php.ini
register_globals = On
register_argc_argv = On
error_reporting  =  E_ALL & ~E_NOTICE
allow_url_fopen = On
include_path = ".:/usr/share/php5:/usr/share/php:/usr/share/php/PEAR"
short_open_tag = On

Einrichten der Datenbank

Jffnms erlaubt Ihnen entweder PostgreSQL oder MySQL als Datenbank zu nutzen. Hier zeigen wir Ihnen, wie Sie die Datenbank und die notwendigen Tabellen, in denen Jffnms seine Daten speichern wird, erstellen. Es ist wichtig zu wissen, dass Sie keine Datenbank lokal laufen haben müssen, um Jffnms auszuführen. Mit Ausnahme, dass Sie die Befehle auf einem entfernten Rechner ausführen, ist der Ablauf identisch.

Einrichten von PostgreSQL

Sie sollten PostgreSQL zu Ihrem Standard-Runlevel hinzufügen, so dass es bei jedem Bootvorgang des Rechners automatisch startet.

# rc-update add postgresql default

Jetzt müssen Sie die PostgreSQL-Datenbank einrichten.

# emerge --config postgresql

Starten Sie jetzt PostgreSQL:

# /etc/init.d/postgresql start

PostgreSQL als Datenbank benutzen

Sobald Sie PostgreSQL eingerichtet und gestartet haben, müssen Sie einen Benutzer und eine Datenbank für Jffnms erstellen, um die Hostdaten zu speichern.

# psql template1 postgres
template1=# create user jffnms password 'jfnms' createdb;
template1=# \connect template1 jffnms
template1=# create database jffnms;
template1=# \q

Abschließend müssen Sie alle Tabellen, in denen Daten gespeichert werden, erstellen:

# psql jffnms jffnms < /opt/jffnms/docs/jffnms-0.8.3.pgsql

Nachdem Sie diese Schritte durchgeführt haben, sollte die Konfiguration der PostgreSQL-Datenbank für Jffnms erfolgreich sein.

MySQL als Datenbank benutzen

Falls Sie Jffnms mit MySQL benutzen wollen, müssen Sie zuerst eine Datenbank und einen MySQL-Benutzer erstellen. Anschliessend erstellen Sie Ihre MySQL-Tabelle.

# mysql -u jffnms -pjffnms jffnms < /opt/jffnms/docs/jffnms-0.8.3.mysql

UDP-Portüberwachung und -entdeckung

Wenn Sie UDP-Portüberwachung und -entdeckung benötigen, müssen Sie nmap und fping als SUID-Programme aufsetzen. Falls eines dieser Programme einen Bug enthält, erzeugen Sie dadurch eine Sicherheitslücke. Um sie als SUID aufzusetzen, können Sie die folgenden Befehle ausführen:

# chmod +s /usr/bin/nmap ; chmod a+x /usr/bin/nmap
# chmod +s /usr/sbin/fping ; chmod a+x /usr/sbin/fping

3.  Konfiguration von Jffnms

Konfiguration des Poller-Prozesses

Der Poller-Prozess ist verantwortlich für das Sammeln der Daten von den Hosts. Um diese Daten in regelmäßigen Abständen zu sammeln, muss er zur crontab hinzugefügt werden.

# crontab -u jffnms /opt/jffnms/docs/unix/crontab
# crontab -e -u jffnms

Abschließende Einrichtung

Zu diesem Zeitpunkt sollte Jffnms auf Ihrem System installiert sein und funktionieren. Sie müssen Jffnms allerdings immer noch konfigurieren. Glücklicherweise stellt Jffnms ein einfach zu benutzendes Webinterface bereit, in dem es möglich ist, sowohl den Datenbank- und Benutzerzugriff zu konfigurieren als auch zu überprüfen ob die Rechnerkonfiguration Jffnms Anforderungen genügt. Sie können dieses Webinterface über folgende URL erreichen: http://localhost/jffnms/admin/setup.php. Sie können sich auf Ihrer neuen Installation mit dem Benutzernamen und Passwort admin anmelden. Sie sollten die Homepage von Jffnms besuchen, um weitere Informationen zu der Konfiguration zu bekommen.

4.  Support

Auch wenn Jffnms eine tolle Applikation ist, ist es nicht ganz einfach, sie zum Laufen zu bekommen. Wenn Sie auf Probleme mit Jffnms stoßen, gibt es einige Orte, an denen Sie nach Hilfe suchen können:

• Jffnms Installationshandbuch
• Jffnms Handbuch
• Gentoo Foren
• PostgreSQL 8 Dokumentation
• MySQL Dokumentation

Die Inhalte dieses Dokuments sind, sofern nicht explizit anders genannt, unter der Creative Commons - Namensnennung / Weitergabe Lizenz lizenziert. Die Gentoo Name and Logo Usage Guidelines treffen zu.