Java¶

OpenNMS basiert auf Java. Empfohlen wird die Installation einer Entwicklungsumgebung (JDK, Version 7). OpenNMS funktioniert sowohl mit OpenJDK als auch mit Java/Oracle Java.

PostgreSQL¶

Dann muss PostgreSQL installiert ^[1] werden:

• postgresql

Befehl zum Installieren der Pakete:

sudo apt-get install postgresql 

Oder mit apturl installieren, Link: apt://postgresql

Danach müssen die Zugriffsberechtigungen der Datenbank geändert werden. Die Datei /etc/postgresql/VERSION/main/pg_hba.conf muss mit einem Editor ^[2] und Root-Rechten ^[3] bearbeitet werden. Am Ende der Datei gibt es die Einträge:

local   all         all                               ident sameuser
host    all         all         127.0.0.1/32          ident sameuser
host    all         all         ::1/128               ident sameuser

Diese bitte abändern:

local   all         all                               trust
host    all         all         127.0.0.1/32          trust
host    all         all         ::1/128               trust

Danach die Server-Komponente von PostgreSQL neu starten:

sudo service postgresql restart 

Fremdquelle¶

Um aus der Fremdquelle zu installieren, muss man unabhängig von der Ubuntu-Version die folgende Paketquelle freischalten:

deb http://debian.opennms.org stable main

Um die Fremdquelle zu authentifizieren, muss man den Signierungsschlüssel herunterladen ⮷ und in der Paketverwaltung hinzufügen. Alternativ dazu kann man auch im Terminal den folgenden Befehl ausführen:

wget -q -O "-" http://debian.opennms.org/OPENNMS-GPG-KEY | sudo apt-key add - 

Nach dem Aktualisieren der Paketquellen kann das Paket opennms installiert werden:

sudo apt-get update
sudo apt-get install opennms -y 

Konfiguration¶

Danach muss OpenNMS gesagt werden, wo es Java findet bzw. welches es nutzen soll:

sudo /usr/share/opennms/bin/runjava -S /PFAD/ZU/JAVA/bin/java 

Nun noch schnell die OpenNMS-Datenbank erstellen. Dazu gibt es ein Installationsprogramm von OpenNMS. Dieses muss auch nach Updates erneut ausgeführt werden.

sudo /usr/share/opennms/bin/install -dis 

su - postgres
psql

ALTER USER opennms with password 'geheim';
ALTER USER postgres with password 'geheim';
\q

#vorlage Befehl
exit

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

  <jdbc-data-source name="opennms"
                    database-name="opennms"
                    class-name="org.postgresql.Driver"
                    url="jdbc:postgresql://localhost:5432/opennms"
                    user-name="opennms"
                    password="geheim" />

  <jdbc-data-source name="opennms-admin"
                    database-name="template1"
                    class-name="org.postgresql.Driver"
                    url="jdbc:postgresql://localhost:5432/template1"
                    user-name="postgres"
                    password="geheim" />

local   all         all                               md5
host    all         all         127.0.0.1/32          md5
host    all         all         ::1/128               md5

sudo service postgresql restart 

sudo service opennms start 

Benutzeroberfläche¶

Der Zugriff erfolgt über den Browser: http://OPENNMS-IP-ADRESSE:8980/opennms/

• Benutzername: admin

• Passwort: admin

Discovery¶

Um großflächig Nodes in die OpenNMS-Datenbank zu bekommen, sollte man den Discovery Daemon konfigurieren. Dies lässt sich leicht über die grafische Oberfläche einstellen.

Administrations-Weboberfläche

Discovery-Konfiguration

Einfach eine gewünschte IP, IP-Bereich oder URL eingeben und auf "Save and Restart Discovery" klicken. In der "Node List" werden dann alle Geräte erscheinen, die per ICMP im Netzwerk erreichbar sind. Diese werden auch fortan auch auf ICMP und div. andere Dienste, die dort erkannt werden (wie. z.B. HTTP, SSH usw.), überwacht.

Notifications¶

OpenNMS bietet viele Möglichkeiten, um Nachrichten zu versenden. Meist werden Emails oder Instant Messages verwendet. Aber auch SMS, Anrufe oder Mikrobloggingdienste könnten genutzt werden. Der Versand von Nachrichten ist grundlegend bei einer Neuinstallation ausgeschaltet. Das heißt aber nicht, dass OpenNMS nichts meldet! Denn die Nachrichten sind im Menü "Notifications" ersichtlich. Sie werden nur nicht per Mail etc. versendet.

In der Datei /etc/opennms/javamail.configuration.properties muss der gewünschte Emailserver hinterlegt sein. Eine funktionierende Konfiguration könnte z.B. so aussehen (wenn der SMTP-Server keine Authentifizierung benötigt):

org.opennms.core.utils.fromAddress=EMAILADRESSE-DES-NMS-SERVER
org.opennms.core.utils.mailHost=IP-DES-MAIL-SERVER
org.opennms.core.utils.mailer=smtpsend
org.opennms.core.utils.transport=smtp
org.opennms.core.utils.smtpport=25
org.opennms.core.utils.useJMTA=false
org.opennms.core.utils.messageContentType=text/html
org.opennms.core.utils.encoding=8-bit
org.opennms.core.utils.charset=utf8
org.opennms.core.utils.contentTransferEncoding=8-bit

Diese Konfiguration benötigt einen Neustart von OpenNMS.

service restart opennms 

Der Versand von Nachrichten kann im Bereich "Admin" eingeschaltet werden:

Notifications einschalten

Im Adminbereich unter "Home → Admin → Configure Notifications → Event Notifications" können einzelne Nachrichten ein- oder ausgeschaltet werden. In der Grundinstallation sind folgende Benachrichtigungen enthalten:

• High/Low Threshold - wird ausgelöst, wenn ein überwachter Wert über/unterschritten wird

• InterfaceDeleted - wird ausgelöst, wenn ein Interface eines überwachten Gerätes gelöscht wird

• InterfaceDown - wird ausgelöst, wenn ein Interface eines überwachten Gerätes nicht mehr erreichbar ist.

• NodeAdded - wird ausgelöst, wenn ein zu überwachendes Gerät in OpenNMS hinzugefügt wird

• NodeDown - wenn ein komplettes überwachtes Gerät nicht mehr erreichbar ist

• NodeLostService - wenn ein Dienst eines überwachten Gerätes nicht mehr erreichbar ist. Z.B. HTTP oder SSH

Event notifications

Um nun auch diese Nachrichten per Email zu erhalten, muss man sich einen Benutzeraccount anlegen und diesen in die Gruppe admin hinzufügen.

Der Benutzer benötigt nur einen Benutzernamen, Passwort und eine Emailadresse. Er kann im Adminbereich "Home → Admin → Users and Groups → User List" erstellt und in "Home → Admin → Users and Groups → Group List" der Gruppe admin hinzugefügt werden.

Menü für Usererstellung

Gruppenmitglieder definieren

Datenbank¶

In der PostgreSQL Datenbank stehen z.B. alle Events, Notifications, Alarme etc. Mit dem Programm pg_dump, welches Teil des postgres-Paketes ist, kann eine Sicherung erstellt werden.

pg_dump -U opennms -Fc -f /backups/opennms-pgsql.gz opennms 

Der Restore dazu sieht so aus:

createdb -U opennms opennms
pg_restore -U opennms -Fc -d opennms /backups/opennms-pgsql.gz 

RRD-Archive¶

Sie enthalten die gespeicherten Leistungsdaten aller überwachten Geräte. Die RRD-Archive sind in dem Ordner /usr/share/opennms/share/rrd zu finden. Zur Sicherung genügt eine Kopie des Ordners.

tar -cvzf /backups/opennms-rrd.tar.gz /usr/share/opennms/share/rrd 

Konfiguration¶

Die Konfigurationen liegen unter /etc/opennms/. Auch dieser Ordner muss nur kopiert bzw. archiviert werden.

tar -cvzf /backups/opennms-etc.tar.gz /etc/opennms 

Webinterface¶

Die Konfigurationen für das Webfrontend findet man im Ordner /usr/share/opennms/jetty-webapps. Falls man das Webfrontend modifiziert hat, sollte man auch diesen Ordner sichern.

tar -cvzf /backups/opennms-jetty.tar.gz /usr/share/opennms/jetty-webapps 

Logs¶

Die Protokolldateien (Logs) werden unter /var/log/opennms/daemon/ gespeichert. In der Datei /etc/opennms/log4j2.xml kann das Loglevel angepasst werden. Die meisten Daemons sind standardmäßig auf WARN eingestellt. Es kann, gerade bei der Fehlersuche in der Konfiguration, hilfreich sein, mehr Meldungen zu erhalten. Das Loglevel sollte dann auf INFO oder DEBUG gestellt werden.

1
2

# Pollers
log4j.category.OpenNMS.Poller=WARN, POLLERS

Diese Änderung wird sofort gültig und die Logs werden mit Debug Informationen gefüllt.