Diese Anleitung beschreibt die vollständige Integration von Didactum Monitoring-Geräten in AggreGate Network Manager. Ziel ist die zentrale Überwachung aller angeschlossenen Sensoren – Temperatur, Luftfeuchtigkeit, Leckage, Spannung, Türkontakte und weitere – über SNMP-Polling und SNMP-Traps, inklusive automatischer Geräteerkennung, kontextbasierter Alarmierung, Trendgrafiken und Dashboards.

AggreGate Network Manager ist eine universelle Monitoring- und Management-Plattform der Tibbo Technology. Sie basiert auf einem kontextorientierten Datenmodell: Jedes überwachte Gerät wird als Kontext (Context) dargestellt, dem beliebige Variablen, Ereignisse und Funktionen zugeordnet werden können. SNMP-fähige Geräte wie die Didactum Monitoring-Einheiten werden über den integrierten SNMP-Driver als Gerätekontexte eingebunden.

AggreGate-Kernkonzepte

Verarbeitungsablauf für Didactum-Sensoren

1. Gerät anlegen: Das Didactum-Gerät wird als SNMP-Device-Context angelegt.
2. SNMP-Walk: AggreGate führt einen SNMP-Walk durch und erkennt verfügbare OIDs.
3. Variable-Mapping: OIDs werden als Variablen im Device-Context konfiguriert.
4. Polling: AggreGate fragt in konfigurierten Intervallen die Variablen ab.
5. Alert-Prüfung: Variablenwerte werden gegen Alert-Bedingungen geprüft.
6. Event-Verarbeitung: Bei Bedingungserfüllung werden Events und Benachrichtigungen ausgelöst.

Wichtige Verzeichnisse

• AggreGate Network Manager 6.x oder neuer (aktuelle stabile Version)
• AggreGate-Server auf Linux (Debian/Ubuntu, RHEL/CentOS) oder Windows Server
• Java Runtime Environment 11 oder neuer (wird mit AggreGate mitgeliefert)
• AggreGate Client (Java-Anwendung) oder Web-Interface für die Konfiguration
• SNMP-Tools (snmpwalk, snmpget) zur Vorbereitung
• Didactum Monitoring-Gerät im Netzwerk erreichbar, SNMP aktiviert
• UDP Port 161 vom AggreGate-Server zum Didactum-Gerät freigegeben
• UDP Port 162 auf dem AggreGate-Server für SNMP-Traps freigegeben
• TCP Port 8080 (Web-Interface) und TCP Port 6060 (Client-Verbindung) auf dem Server
• SNMP-Community-String bekannt (Standard: public)

Beispiel-Netzwerkkonfiguration

3.1 SNMP aktivieren

1. Didactum Web-Interface aufrufen: 192.168.1.100, Login mit Admin-Konto.
2. Navigation: Einstellungen → Netzwerk → SNMP (oder: Settings → Network → SNMP).
3. Folgende Parameter setzen:
   • SNMP aktiviert: Ja
   • SNMP-Version: v2c (empfohlen) oder v3
   • Community-String: public (in Produktion ändern)
   • SNMP-Port: 161
   • Allowed Managers: IP des AggreGate-Servers (192.168.1.90) eintragen
   • SNMP Trap Receiver: IP des AggreGate-Servers, Port 162
4. Einstellungen speichern.

Achtung: Den Standard-Community-String public in Produktivumgebungen ändern. Den gleichen String in der AggreGate-SNMP-Konfiguration verwenden.

3.2 Erreichbarkeit vom AggreGate-Server testen

# SNMP Walk – alle Didactum-OIDs auflisten:
snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854
 
# Temperatur Sensor 1 direkt abfragen:
snmpget -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1
 
# System-Beschreibung (Grundtest):
snmpget -v2c -c public 192.168.1.100 1.3.6.1.2.1.1.1.0

Hinweis: 

Didactum gibt Temperatur- und Spannungswerte mit Faktor 10 zurück (235 = 23,5°C). Dies wird in AggreGate über eine Formel in der Variablenkonfiguration berücksichtigt.

4.1 AggreGate-Server starten und prüfen

# Linux – AggreGate-Dienst starten:
sudo systemctl start aggregate-server
sudo systemctl enable aggregate-server
sudo systemctl status aggregate-server
 
# Logs prüfen:
sudo tail -f /opt/aggregate/server/logs/server.log
 
# Web-Interface aufrufen:
# 192.168.1.90/aggregate

4.2 Didactum MIB-Datei importieren

1. AggreGate Client starten oder Web-Interface aufrufen.
2. Navigation: Administration → SNMP → MIB Repository → Import MIB.
3. Didactum-MIB-Datei (DIDACTUM-RACKMONI2-MIB.mib) hochladen.
4. Abhängige MIBs sicherstellen: SNMPv2-SMI, SNMPv2-TC, RFC1213-MIB müssen bereits vorhanden sein.
5. Nach erfolgreichem Import: OID-Namen aus der MIB werden im SNMP-Browser angezeigt.

Alternativ MIB manuell in das Server-Verzeichnis kopieren:

sudo cp DIDACTUM-RACKMONI2-MIB.mib /opt/aggregate/server/mibs/
sudo systemctl restart aggregate-server

4.3 SNMP-Community in AggreGate hinterlegen

1. Navigation: Administration → SNMP → Community Strings → Add.
2. Einstellungen:
   • Name: Didactum-Community
   • Community String: public
   • Version: v2c
   • IP Range: 192.168.1.100 (auf Didactum-Gerät beschränken)
3. Speichern.

4.4 SNMP-Trap-Receiver aktivieren

1. Navigation: Administration → SNMP → Trap Receiver.
2. Status: Enabled
3. Port: 162
4. Allowed sources: 192.168.1.100
5. Speichern und AggreGate-Server neu starten.

5.1 Gerät über den AggreGate Client anlegen

1. AggreGate Client öffnen: Datei → Verbinden → 192.168.1.90:6060.
2. Im Context-Browser: Rechtsklick auf den gewünschten Ordner → Neu → Gerät → SNMP-Gerät.
3. Folgende Felder ausfüllen:
   • Name: didactum-rack01
   • Beschreibung: Didactum Rack Monitoring Unit – Serverraum A
   • IP-Adresse: 192.168.1.100
   • SNMP-Version: v2c
   • Community: public
   • Port: 161
   • Timeout: 2000 ms
   • Retries: 3
4. Klick auf SNMP-Walk ausführen – AggreGate erkennt alle verfügbaren OIDs.
5. OK klicken. Das Gerät erscheint als Context im Browser.

5.2 Gerät über das Web-Interface anlegen

1. Web-Interface aufrufen: 192.168.1.90/aggregate.
2. Navigation: Geräte → Neues Gerät → SNMP-Gerät.
3. Gleiche Parameter wie oben eintragen.
4. Klick auf Erkennen – AggreGate führt Discovery durch.

5.3 Gerät per Discovery automatisch erkennen

1. Navigation: Administration → Network Discovery → Neuer Scan.
2. IP-Bereich: 192.168.1.100 – 192.168.1.110
3. Protokoll: SNMP, Community: public
4. Klick auf Scan starten.
5. Gefundene Geräte aus der Ergebnisliste importieren.

5.4 Gerätegruppe anlegen

1. Im Context-Browser: Rechtsklick → Neu → Gruppe.
2. Name: Didactum-Monitoring-Geraete
3. Alle Didactum-Geräte per Drag & Drop in die Gruppe verschieben.
4. Gruppenbeschreibung: Alle Didactum Rack Monitoring Units

5.5 Gerätestatus nach Discovery prüfen

1. Im Context-Browser: Doppelklick auf didactum-rack01.
2. Registerkarte Status – SNMP-Erreichbarkeit sollte Online zeigen.
3. Registerkarte Variablen – erkannte OIDs werden aufgelistet.
4. Registerkarte Ereignisse – SNMP-Events werden hier angezeigt.

6.1 SNMP-Browser für Didactum-OIDs verwenden

1. Navigation: Werkzeuge → SNMP-Browser.
2. IP-Adresse: 192.168.1.100, Community: public.
3. Klick auf Walk – alle verfügbaren Didactum-OIDs werden angezeigt.
4. OIDs können direkt aus dem Browser in die Variablenkonfiguration übernommen werden.

6.2 SNMP-Version und Sicherheit konfigurieren

Für SNMP v3 im Gerät-Properties:

1. Rechtsklick auf den Didactum-Context → Eigenschaften → SNMP.
2. SNMP-Version: v3
3. Zusätzliche Felder:
   • Security Name: SNMP-v3-Benutzername
   • Auth Protocol: SHA
   • Auth Password: Authentifizierungspasswort
   • Privacy Protocol: AES128
   • Privacy Password: Verschlüsselungspasswort
4. Speichern.

6.3 Polling-Konfiguration

1. Rechtsklick auf den Didactum-Context → Eigenschaften → Polling.
2. Einstellungen:
   • Polling aktiviert: Ja
   • Standard-Polling-Intervall: 300 Sekunden (5 Minuten)
   • Timeout: 2000 ms
   • Retries: 3
3. Für zeitkritische Sensoren (Leckage, Türkontakt) ein kürzeres Intervall direkt an der Variablen setzen: 60 Sekunden.

7.1 Variablen für Sensoren anlegen

Jede zu überwachende OID wird als Variable im Didactum-Device-Context konfiguriert:

1. Rechtsklick auf den Didactum-Context → Neu → Variable.
2. Variable für Temperatur Sensor 1:
   • Name: temperatur_s1
   • Beschreibung: Temperatur Sensor 1 – Rack-Front
   • Typ: SNMP Variable
   • OID: .1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1
   • Datentyp: Float
   • Formel: value / 10.0 (Rohwert ÷ 10 für °C)
   • Einheit: °C
   • Polling-Intervall: 300 Sekunden
   • Historisierung: Aktiviert, Aufbewahrung: 90 Tage
3. OK klicken.

7.2 Formel-Transformation für Messwerte

AggreGate unterstützt Formeln in der Variablenkonfiguration, die den Rohwert transformieren:

7.3 Alle Variablen für Didactum im Überblick

7.4 Device-Template anlegen (für mehrere Didactum-Geräte)

Statt die Variablen für jedes Gerät einzeln anzulegen, empfiehlt sich ein Device-Template:

1. Navigation: Administration → Templates → Neues Template.
2. Name: Didactum-Rack-Monitoring-Template
3. Alle Variablen aus Abschnitt 7.3 im Template anlegen.
4. Template auf neue Didactum-Geräte anwenden: Rechtsklick auf Device-Context → Template anwenden → Didactum-Rack-Monitoring-Template.
5. Variablen werden automatisch übernommen und dem Gerät zugeordnet.

7.5 Historisierung und Datenspeicherung

1. Für jede Variable: Registerkarte Historisierung.
2. Empfohlene Einstellungen:
   • Historisierung aktiviert: Ja
   • Aufbewahrungszeit: 90 Tage (Rohdaten), 365 Tage (aggregierte Daten)
   • Aggregation: Stündlich (Avg, Min, Max), Täglich (Avg, Min, Max)
   • Komprimierung: Aktiviert (spart Speicherplatz)

Alle OIDs basieren auf der Didactum Enterprise OID-Basis 1.3.6.1.4.1.3854. Der Platzhalter {n} steht für den Sensorindex (1 = erster Sensor usw.).

8.1 Temperatursensoren

8.2 Leckagesensoren

8.3 Luftfeuchtigkeitssensoren

8.4 Weitere Sensoren

9.1 Alert für Temperatur anlegen

1. Rechtsklick auf den Didactum-Context → Neu → Alert.
2. Einstellungen für Temperatur-Warnung:
   • Name: Temperatur-Warnung-S1
   • Beschreibung: Temperatur Sensor 1 über 30 °C
   • Variable: temperatur_s1
   • Bedingung: Wert größer als 30
   • Schweregrad: WARNING
   • Nachricht: Temperatur Sensor 1 auf {deviceName}: {value} °C – Grenzwert 30 °C überschritten
   • Wiederholung: 600 Sekunden (alle 10 Minuten, solange aktiv)
3. Kritischen Alert hinzufügen:
   • Name: Temperatur-Kritisch-S1
   • Bedingung: Wert größer als 35
   • Schweregrad: CRITICAL
4. Aktion verknüpfen: E-Mail-Benachrichtigung (siehe 9.4).

9.2 Alert für Leckage (Sofortalarm)

1. Neuer Alert am Didactum-Context.
2. Einstellungen:
   • Name: Leckage-KRITISCH-S1
   • Variable: leckage_status_s1
   • Bedingung: Wert größer oder gleich 1
   • Schweregrad: CRITICAL
   • Nachricht: LECKAGE ERKANNT auf {deviceName}! Sofortiger Handlungsbedarf!
   • Wiederholung: 300 Sekunden (alle 5 Minuten)
   • Sofort benachrichtigen: Ja (kein Delay)

9.3 Kombinierter Alert (Mehrere Bedingungen)

AggreGate unterstützt Formeln als Alert-Bedingungen, mit denen mehrere Variablen kombiniert werden können:

1. Neuer Alert: Kritische-Kombination
2. Bedingungsformel:

/* Alert wenn Leckage UND Temperatur gleichzeitig kritisch */
({leckage_status_s1} >= 1) AND ({temperatur_s1} > 35)

1. Schweregrad: CRITICAL
2. Nachricht: KRITISCH: Gleichzeitige Leckage UND Temperatur-Alarm auf {deviceName}!

9.4 E-Mail-Benachrichtigung konfigurieren

1. Navigation: Administration → E-Mail → SMTP-Server.
2. SMTP-Server-Einstellungen eintragen (Host, Port, Absender, Authentifizierung).
3. Test-E-Mail senden.
4. Benachrichtigungsregel anlegen: Administration → Benachrichtigungen → Neue Regel.
   • Trigger: Alert-Schweregrad CRITICAL oder WARNING
   • Gerät / Gruppe: Didactum-Monitoring-Geraete
   • Methode: E-Mail
   • Empfänger: admin@example.com
   • Betreff: [AggreGate] {severity}: {alertName} auf {deviceName}

9.5 Empfohlene Alert-Schwellwerte

AggreGate empfängt SNMP-Traps nativ auf UDP Port 162. Eingehende Traps werden automatisch dem sendenden Gerät zugeordnet und als Events im Context gespeichert.

10.1 SNMP-Trap-Empfang prüfen

# Firewall-Port auf dem AggreGate-Server prüfen:
sudo ufw status | grep 162
# oder:
sudo iptables -L -n | grep 162
 
# Port freigeben:
sudo ufw allow 162/udp
 
# AggreGate-Trap-Receiver läuft? Log prüfen:
sudo tail -f /opt/aggregate/server/logs/server.log | grep -i trap

10.2 Trap-Event-Handler konfigurieren

1. Navigation: Administration → SNMP → Trap-Handler → Neuer Handler.
2. Handler für Leckage-Trap:
   • Trap-OID: .1.3.6.1.4.1.3854.1.7.2
   • Event-Name: Didactum-Leckage-Trap
   • Schweregrad: CRITICAL
   • Nachricht: LECKAGE erkannt auf {sourceIP} via SNMP Trap!
   • Variable aktualisieren: leckage_status_s1 = 1
3. Handler für Temperatur-Alarm-Trap:
   • Trap-OID: .1.3.6.1.4.1.3854.1.7.1
   • Event-Name: Didactum-Temperatur-Trap
   • Schweregrad: HIGH
4. Analog für alle weiteren Trap-OIDs.

10.3 Trap-Test durchführen

# Test-Trap für Leckage senden:
snmptrap -v2c -c public 192.168.1.90 '' \
  .1.3.6.1.4.1.3854.1.7.2 \
  .1.3.6.1.4.1.3854.1.2.2.1.18.1.4.1 i 1
 
# Empfang in AggreGate prüfen:
# Context didactum-rack01 → Ereignisse → Trap erscheint hier

10.4 Wichtige Didactum Trap-OIDs

11.1 Dashboard für Didactum-Sensoren anlegen

1. Navigation: Dashboards → Neues Dashboard.
2. Name: Didactum Rack Monitoring
3. Dashboard-Widgets hinzufügen:

11.2 Empfohlene Dashboard-Widgets

11.3 Grundrissplan mit Sensor-Überlagerung

1. Navigation: Dashboards → Neues Dashboard → Typ: Grundriss.
2. Hintergrundbild: Serverraum-Grundriss hochladen (PNG oder SVG).
3. Didactum-Gerät als Icon auf dem Grundriss platzieren.
4. Icon-Farbe: Automatisch basierend auf dem höchsten Alert-Schweregrad des Geräts.
5. Tooltip: Aktuelle Temperatur und Leckage-Status anzeigen.
6. Klick auf Icon: Öffnet Detail-Dashboard mit allen Sensoren.

11.4 Historische Auswertung

1. Rechtsklick auf eine Variable (z. B. temperatur_s1) → Verlauf anzeigen.
2. Zeitraum wählen: 7 Tage, 30 Tage, 90 Tage.
3. Statistiken anzeigen: Minimum, Maximum, Durchschnitt, Standardabweichung.
4. Export als CSV oder PDF für Reports.

11.5 Automatische Berichte

1. Navigation: Administration → Berichte → Neuer Bericht.
2. Bericht: Didactum Monatsbericht
3. Inhalt: Temperatur Min/Max/Avg, Luftfeuchtigkeit Min/Max/Avg, Anzahl Alarme nach Typ
4. Zeitraum: Letzter Monat
5. Format: PDF
6. Versand: Automatisch am 1. jeden Monats per E-Mail

# AggreGate-Server Status:
sudo systemctl status aggregate-server
 
# AggreGate-Server neu starten:
sudo systemctl restart aggregate-server
 
# Server-Log in Echtzeit verfolgen:
sudo tail -f /opt/aggregate/server/logs/server.log
 
# Nur Fehler anzeigen:
sudo grep -i "error\|warn\|snmp" /opt/aggregate/server/logs/server.log | tail -50
 
# SNMP-Erreichbarkeit testen:
snmpwalk -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854
 
# Einzelne OID abfragen:
snmpget -v2c -c public 192.168.1.100 1.3.6.1.4.1.3854.1.2.2.1.16.1.3.1
 
# Test-Trap senden:
snmptrap -v2c -c public 192.168.1.90 '' \
  .1.3.6.1.4.1.3854.1.7.2 \
  .1.3.6.1.4.1.3854.1.2.2.1.18.1.4.1 i 1
 
# Firewall-Ports prüfen (ufw):
sudo ufw status verbose
 
# Ports 161 und 162 freigeben:
sudo ufw allow 161/udp
sudo ufw allow 162/udp
 
# Port 6060 (Client) und 8080 (Web) freigeben:
sudo ufw allow 6060/tcp
sudo ufw allow 8080/tcp

Für firmware-spezifische OIDs und unterstützte Sensortypen immer die aktuelle Didactum-Gerätedokumentation konsultieren. AggreGate-versionsspezifische Unterschiede sind in der Tibbo-Technology-Dokumentation nachzuschlagen.