Didactum Monitoring & NeuralStar Integration
Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in NeuralStar NMS via SNMP – inklusive Device-Discovery, MIB-Import, Schwellwert-Konfiguration, vollständiger OID-Referenz für alle Sensortypen (Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch) sowie Alarm- und Benachrichtigungs-Konfiguration.
Architektur-Hinweis: NeuralStar kommuniziert direkt per SNMP mit dem Didactum-Gerät. Der NeuralStar-Server sendet SNMP-GET/WALK-Anfragen an UDP-Port 161 des Didactum-Geräts. SNMP-Traps werden vom Didactum-Gerät aktiv an den NeuralStar-Server gesendet (UDP-Port 162).
- Software: NeuralStar NMS (aktuelle Version)
- Protokoll: SNMP v1 / v2c / v3
- Geräte: Didactum Monitoring System 100T / 300T / 500T / 550T
- Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch
1. Voraussetzungen & Systemüberblick
NeuralStar-Server
| Anforderung | Details |
|---|---|
| Betriebssystem | Windows Server 2016/2019/2022 oder Linux (Ubuntu 20.04 / 22.04) |
| NeuralStar Version | Aktuelle Release empfohlen (MIB-Browser integriert) |
| Netzwerk | UDP-Port 161 ausgehend (SNMP Polling), UDP-Port 162 eingehend (SNMP Traps) |
| Netzwerkzugang | IP-Erreichbarkeit zum Didactum-Gerät erforderlich |
Didactum-Gerät
| Anforderung | Details |
|---|---|
| Modell | Monitoring System 100T, 300T, 500T oder 550T |
| SNMP | SNMP aktiviert (v2c empfohlen) |
| Erreichbarkeit | Gerät per Netzwerk vom NeuralStar-Server erreichbar |
| MIB-Datei | Im Web-Interface unter Systemeinstellungen → SNMP verfügbar |
Enterprise OIDs je Firmware-Generation
| Gerät / Firmware | Enterprise OID (Basis) |
|---|---|
| Ältere Modelle / ältere Firmware | .1.3.6.1.4.1.46501 |
| Neuere Modelle / aktuelle Firmware | .1.3.6.1.4.1.39052 |
Hinweis: Welche Enterprise OID Ihr Gerät verwendet, entnehmen Sie der MIB-Datei aus dem Web-Interface oder ermitteln Sie sie per:
snmpwalk -v 2c -c public 192.168.1.50 .1.3.6.1.2.1.1.2.0
2. SNMP auf dem Didactum-Gerät aktivieren
Schritt 1 – Web-Interface öffnen
Im Browser die IP-Adresse des Didactum-Geräts aufrufen:
192.168.1.50 (IP des Didactum-Geräts anpassen)
Schritt 2 – SNMP-Einstellungen aufrufen
Systemeinstellungen → SNMP
Schritt 3 – Folgende Werte eintragen
| Feld im Didactum Web-Interface | Empfohlener Wert |
|---|---|
| SNMP aktivieren | Aktiviert |
| SNMP-Version | v2c (empfohlen) |
| Community String (Read) | didactum_neuralstar (nicht „public" verwenden!) |
| SNMP-Port | 161 |
| Trap-Ziel (Trap Destination) | IP-Adresse des NeuralStar-Servers |
| Trap-Community | didactum_trap |
| Trap-Port | 162 |
Schritt 4 – MIB-Datei herunterladen
Systemeinstellungen → SNMP → "MIB-Datei herunterladen" Datei wird als didactum.mib heruntergeladen. Diese Datei wird in Schritt 3 in NeuralStar importiert.
Einstellungen speichern und das Gerät ggf. neu starten.
3. MIB-Datei in NeuralStar importieren
Schritt 1 – MIB-Manager öffnen
NeuralStar → Administration → MIB Manager Alternativ: Tools → MIB Browser → Import MIB
Schritt 2 – MIB-Datei importieren
→ "Import MIB" / "MIB hochladen" klicken → Heruntergeladene Datei didactum.mib auswählen → Import bestätigen
Schritt 3 – Import-Ergebnis prüfen
Nach erfolgreichem Import erscheint DIDACTUM-MIB (bzw. DIDACTUM-MIB2 bei neueren Geräten) in der MIB-Baum-Ansicht unter iso → org → dod → internet → private → enterprises. Die OID .1.3.6.1.4.1.46501 bzw. .1.3.6.1.4.1.39052 sollte jetzt mit symbolischen Namen aufgelöst werden.
Hinweis: Sollte NeuralStar beim MIB-Import abhängige MIBs (z. B. RFC1213-MIB, SNMPv2-SMI) anfordern, können diese über den integrierten MIB-Manager oder von circitor.fr bezogen und zuerst importiert werden.
Fertige MIB-Importkonfiguration (DIDACTUM-MIB.txt)
Falls keine MIB-Datei aus dem Gerät verfügbar ist, kann die folgende minimale MIB-Struktur manuell als Textdatei DIDACTUM-MIB.txt gespeichert und importiert werden:
-- ================================================================
-- DIDACTUM-MIB – Minimale MIB für NeuralStar-Import
-- Datei: DIDACTUM-MIB.txt
-- Für ältere Geräte: enterprises.46501
-- Für neuere Geräte: enterprises.39052 (OID anpassen)
-- ================================================================
DIDACTUM-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, Integer32, enterprises
FROM SNMPv2-SMI
NOTIFICATION-TYPE
FROM SNMPv2-SMI;
didactum MODULE-IDENTITY
LAST-UPDATED "202401010000Z"
ORGANIZATION "Didactum Security GmbH"
CONTACT-INFO "support@didactum-security.com"
DESCRIPTION "Didactum Monitoring System MIB"
::= { enterprises 46501 }
-- Sensor-Tabelle (sensorTable)
sensorTable OBJECT-TYPE
SYNTAX SEQUENCE OF SensorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Tabelle aller angeschlossenen Sensoren"
::= { didactum 5 1 1 }
sensorEntry OBJECT-TYPE
SYNTAX SensorEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION "Einzelner Sensor-Eintrag"
INDEX { sensorIndex }
::= { sensorTable 1 }
SensorEntry ::= SEQUENCE {
sensorIndex Integer32,
sensorID Integer32,
sensorType Integer32,
sensorName OCTET STRING,
sensorStatus Integer32,
sensorValue Integer32
}
sensorIndex OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Index" ::= { sensorEntry 1 }
sensorID OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Sensor ID" ::= { sensorEntry 2 }
sensorType OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Sensor-Typ" ::= { sensorEntry 3 }
sensorName OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-only STATUS current
DESCRIPTION "Sensor-Name" ::= { sensorEntry 5 }
sensorStatus OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "0=OK 1=Alarm 2=Kein Signal" ::= { sensorEntry 6 }
sensorValue OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current
DESCRIPTION "Messwert (Temperatur: x10)" ::= { sensorEntry 7 }
-- SNMP Traps
didactumAlarmTrap NOTIFICATION-TYPE
OBJECTS { sensorName, sensorStatus, sensorValue }
STATUS current
DESCRIPTION "Alarm-Trap bei Sensor-Statusänderung"
::= { didactum 1 1 }
END
4. Didactum-Gerät in NeuralStar anlegen
Variante A – Automatische Discovery
Schritt 1 – Discovery starten
NeuralStar → Discovery → New Discovery Job IP Range: 192.168.1.50 – 192.168.1.50 SNMP Version: SNMPv2c Community String: didactum_neuralstar Port: 161 Timeout: 5 Sekunden Retries: 3
Schritt 2 – Discovery-Ergebnis prüfen
Nach erfolgreichem Discovery erscheint das Gerät in der Device-Liste mit Bezeichnung Didactum Monitoring System (sysDescr aus der MIB). Sollte kein Name aufgelöst werden, den sysName manuell setzen.
Variante B – Manuelles Anlegen
NeuralStar → Devices → Add Device Device Name: Didactum-Monitor-01 IP Address: 192.168.1.50 Device Type: Generic SNMP Device (oder "Environmental Monitor") SNMP Version: v2c Community: didactum_neuralstar Port: 161 Description: Didactum Monitoring System 300T – Serverraum
Schritt 3 – Gerät einer Gruppe zuweisen (optional)
NeuralStar → Devices → Didactum-Monitor-01 → Groups → "Environmental" oder eigene Gruppe "Serverraum-Monitoring" auswählen
5. SNMP-Monitoring für Didactum-Sensoren konfigurieren
Wichtig – Temperaturschwellwerte: Das Didactum-Gerät liefert Temperaturwerte als Rohwert × 10. 25,5 °C = OID-Wert 255. Schwellwerte in NeuralStar müssen daher ebenfalls × 10 angegeben werden!
Monitoring-Objekte (SNMP Data Points) anlegen
NeuralStar → Devices → Didactum-Monitor-01 → Monitoring → Add Monitor
Monitor 1 – Temperatursensor (digital, Sensor-ID 101001)
Monitor Name: Temperatur Sensor 01 Monitor Type: SNMP Get OID: .1.3.6.1.4.1.46501.5.1.1.7.101001 SNMP Version: v2c Community: didactum_neuralstar Interval: 60 Sekunden Data Type: Integer Unit: (x0.1 °C) Warning High: 280 (= 28,0 °C) Critical High: 350 (= 35,0 °C) Description: Rohwert geteilt durch 10 ergibt Grad Celsius
Monitor 2 – Temperatur-Status (0=OK / 1=Alarm / 2=Kein Signal)
Monitor Name: Temp-Sensor Status OID: .1.3.6.1.4.1.46501.5.1.1.6.101001 Data Type: Integer Warning High: 1 Critical High: 2
Monitor 3 – Wassersensor / Leckage (Sensor-ID 107001)
Monitor Name: Leckage Sensor 01 OID: .1.3.6.1.4.1.46501.5.1.1.7.107001 Data Type: Integer Critical High: 1 (0 = trocken / OK, 1 = Wasser erkannt / CRITICAL)
Monitor 4 – Luftfeuchtigkeit (Sensor-ID 102001)
Monitor Name: Luftfeuchtigkeit Sensor 01 OID: .1.3.6.1.4.1.46501.5.1.1.7.102001 Data Type: Integer Unit: % Warning High: 80 Critical High: 90
Monitor 5 – Türkontakt (Sensor-ID 104001)
Monitor Name: Türkontakt 01 OID: .1.3.6.1.4.1.46501.5.1.1.7.104001 Data Type: Integer Warning High: 1 (0 = geschlossen / OK, 1 = geöffnet / Warning)
Monitor 6 – Rauchmelder (Sensor-ID 106001)
Monitor Name: Rauchmelder 01 OID: .1.3.6.1.4.1.46501.5.1.1.7.106001 Data Type: Integer Critical High: 1 (0 = kein Rauch / OK, 1 = Alarm / CRITICAL)
6. SNMP-Trap-Empfang konfigurieren
Das Didactum-Gerät kann bei Alarm-Ereignissen aktiv SNMP-Traps an NeuralStar senden. Dadurch wird NeuralStar sofort über einen Alarm informiert – ohne Polling-Intervall.
Schritt 1 – Trap-Receiver in NeuralStar aktivieren
NeuralStar → Administration → SNMP Trap Receiver Trap-Port: 162 Trap-Community: didactum_trap MIB für Trap-Decode: DIDACTUM-MIB (zuvor importiert) → "Enable Trap Receiver" aktivieren → Speichern
Schritt 2 – Trap-Quelle dem Gerät zuweisen
NeuralStar → Devices → Didactum-Monitor-01 → SNMP Traps → "Accept Traps from this Device" aktivieren → Trap-Community: didactum_trap → Speichern
Schritt 3 – Trap-Weiterleitung im Didactum Web-Interface
Didactum Web-Interface → Systemeinstellungen → SNMP → Trap-Ziele Trap Destination 1: 192.168.1.100 (IP des NeuralStar-Servers) Trap Community: didactum_trap Trap-Version: v2c Trap-Port: 162 → Speichern
Empfehlung: Sowohl SNMP-Polling (regelmäßige Abfragen) als auch SNMP-Traps (sofortige Alarme) gleichzeitig aktivieren. Polling dient der Trend-Überwachung und Graphen-Erstellung, Traps für die sofortige Alarmierung.
7. Alarme und Benachrichtigungen konfigurieren
Alert-Policy anlegen
NeuralStar → Alerts → Alert Policies → New Policy
Policy Name: Didactum-Sensor-Alarme
Applies to: Device Group "Environmental" oder einzelnes Gerät
Trigger: Monitor-Schwellwert überschritten ODER SNMP-Trap empfangen
-- Benachrichtigung per E-Mail --
Action: Send Email
Recipients: admin@ihredomain.de
Subject: [NeuralStar] Didactum Alarm: ${device.name} – ${monitor.name}
Body:
Zeitpunkt: ${alert.timestamp}
Gerät: ${device.name} (${device.ip})
Monitor: ${monitor.name}
Status: ${alert.severity}
Wert: ${monitor.value} ${monitor.unit}
Schwellwert: ${monitor.threshold}
Beschreibung: ${monitor.description}Eskalations-Stufen konfigurieren
NeuralStar → Alerts → Alert Policies → Didactum-Sensor-Alarme → Escalation Stufe 1 (Warning): E-Mail an admin@ihredomain.de nach 0 Minuten Stufe 2 (Critical): E-Mail an it-leitung@ihredomain.de nach 5 Minuten Stufe 3 (Critical): SMS / Anruf (falls konfiguriert) nach 15 Minuten
8. Dashboard und Graphen in NeuralStar einrichten
Schritt 1 – Neues Dashboard anlegen
NeuralStar → Dashboards → New Dashboard Dashboard Name: Serverraum-Monitoring Layout: Grid (2 × 3 Widgets empfohlen)
Schritt 2 – Widgets für Didactum-Sensoren hinzufügen
Widget 1: Temperatur-Trend (Line Chart) Widget Type: Line Chart / Time Series Device: Didactum-Monitor-01 Monitor: Temperatur Sensor 01 Time Range: Letzte 24 Stunden Y-Axis Label: Rohwert (÷10 = °C) Threshold-Linie: Warning 280 / Critical 350 Widget 2: Leckage-Status (Status-Indicator) Widget Type: Status Indicator / LED Monitor: Leckage Sensor 01 OK-Farbe: Grün (Wert = 0) Critical-Farbe: Rot (Wert ≥ 1) Widget 3: Luftfeuchtigkeit (Gauge) Widget Type: Gauge Monitor: Luftfeuchtigkeit Sensor 01 Min: 0 / Max: 100 Warning Zone: 80–90 % Critical Zone: >90 % Widget 4: Türkontakt-Status Widget Type: Status Indicator Monitor: Türkontakt 01 Widget 5: Rauchmelder-Status Widget Type: Status Indicator Monitor: Rauchmelder 01 Widget 6: Gesamtstatus-Tabelle Widget Type: Device Status Table Device: Didactum-Monitor-01 Zeigt: Alle konfigurierten Monitore mit aktuellem Status
9. SNMP OID-Referenz für Didactum-Sensoren
Alle Didactum-OIDs beginnen mit .1.3.6.1.4.1.46501 (ältere Firmware) bzw. .1.3.6.1.4.1.39052 (neuere Modelle). Die Sensor-ID wird am Ende angehängt.
OID-Felder je Sensor
| Feld | OID-Suffix | Bedeutung | Beispiel (Sensor 101001) |
|---|---|---|---|
| Sensor-Index | .5.1.1.1.SENSOR_ID | Interner Index | .1.3.6.1.4.1.46501.5.1.1.1.101001 |
| Sensor-ID | .5.1.1.2.SENSOR_ID | Numerische Sensor-ID | .1.3.6.1.4.1.46501.5.1.1.2.101001 |
| Sensor-Typ | .5.1.1.3.SENSOR_ID | Typ-Kennziffer | .1.3.6.1.4.1.46501.5.1.1.3.101001 |
| Sensor-Name | .5.1.1.5.SENSOR_ID | Bezeichnung (String) | .1.3.6.1.4.1.46501.5.1.1.5.101001 |
| Sensor-Status | .5.1.1.6.SENSOR_ID | 0=OK, 1=Alarm, 2=Kein Signal | .1.3.6.1.4.1.46501.5.1.1.6.101001 |
| Sensor-Messwert | .5.1.1.7.SENSOR_ID | Aktueller Messwert | .1.3.6.1.4.1.46501.5.1.1.7.101001 |
Sensortypen mit vollständigen OIDs und NeuralStar-Schwellwerten
| Sensortyp | Sensor-ID | OID Messwert | OID Status | NeuralStar Schwellwert |
|---|---|---|---|---|
| Temperatursensor (digital) | 101001 | .1.3.6.1.4.1.46501.5.1.1.7.101001 | .1.3.6.1.4.1.46501.5.1.1.6.101001 | Warning 280 / Critical 350 (Rohwert × 10) |
| Temperatursensor (analog) | 201001 | .1.3.6.1.4.1.39052.5.2.1.7.201001 | .1.3.6.1.4.1.39052.5.2.1.6.201001 | Warning 280 / Critical 350 (× 10) |
| Wassersensor / Leckage | 107001 | .1.3.6.1.4.1.46501.5.1.1.7.107001 | .1.3.6.1.4.1.46501.5.1.1.6.107001 | Critical ≥ 1 (0 = trocken) |
| Luftfeuchtigkeit | 102001 | .1.3.6.1.4.1.46501.5.1.1.7.102001 | .1.3.6.1.4.1.46501.5.1.1.6.102001 | Warning 80 / Critical 90 (direkt %) |
| Potentialfreier Kontakt | 101003 | .1.3.6.1.4.1.39052.5.1.1.7.101003 | .1.3.6.1.4.1.39052.5.1.1.6.101003 | Warning ≥ 1 (0 = offen / inaktiv) |
| Türkontakt | 104001 | .1.3.6.1.4.1.46501.5.1.1.7.104001 | .1.3.6.1.4.1.46501.5.1.1.6.104001 | Warning ≥ 1 (0 = geschlossen) |
| Rauchmelder | 106001 | .1.3.6.1.4.1.46501.5.1.1.7.106001 | .1.3.6.1.4.1.46501.5.1.1.6.106001 | Critical ≥ 1 (0 = kein Rauch) |
Sensor-ID ermitteln: Im Didactum Web-Interface unter Systembaum → Sensor auswählen → Details. Die angezeigte Sensor-ID wird als letztes Element an die OID angehängt. Bei mehreren gleichartigen Sensoren erhöht sich die letzte Stelle (101001, 101002, 101003 …).
Temperaturschwellwerte in NeuralStar: Das Didactum-Gerät liefert Temperaturwerte als Rohwert × 10. 28,0 °C = OID-Wert 280. NeuralStar-Schwellwerte (Warning/Critical) müssen daher ebenfalls × 10 angegeben werden.
10. SNMP-Verbindung testen
Test per Kommandozeile (Linux / Windows mit Net-SNMP)
# snmpwalk – alle Sensor-Werte auflisten
snmpwalk -v 2c -c didactum_neuralstar 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1
# snmpget – einzelnen Temperaturwert abfragen (Rohwert ÷ 10 = °C)
snmpget -v 2c -c didactum_neuralstar 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1.7.101001
# Erwartete Ausgabe: INTEGER: 235 (= 23,5 °C)
# snmpget – Leckage-Status abfragen
snmpget -v 2c -c didactum_neuralstar 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1.7.107001
# Erwartete Ausgabe (trocken): INTEGER: 0
# snmpget – Sensor-Status abfragen
snmpget -v 2c -c didactum_neuralstar 192.168.1.50 \
.1.3.6.1.4.1.46501.5.1.1.6.101001
# Erwartete Ausgabe (OK): INTEGER: 0
# Test mit MIB-Namen (nach MIB-Import)
snmpwalk -v 2c -c didactum_neuralstar -m ALL 192.168.1.50 \
DIDACTUM-MIB::sensorValue
Test über NeuralStar MIB-Browser
NeuralStar → Tools → MIB Browser Host: 192.168.1.50 Community: didactum_neuralstar Version: v2c OID: .1.3.6.1.4.1.46501.5.1.1.7.101001 → "Get" klicken → Wert sollte erscheinen (z. B. 235)
11. Fehlersuche und Lösungen
| Problem | Ursache & Lösung |
|---|---|
| NeuralStar findet Gerät per Discovery nicht | SNMP auf dem Didactum-Gerät nicht aktiviert; Community String falsch; UDP-Port 161 durch Firewall blockiert → Firewall-Regel prüfen und SNMP-Einstellungen im Web-Interface verifizieren |
| MIB-Import schlägt fehl | Abhängige MIBs fehlen (RFC1213-MIB, SNMPv2-SMI) → Basis-MIBs zuerst importieren oder die DIDACTUM-MIB.txt aus Abschnitt 3 verwenden |
| OID liefert „No Such Object" | Falsche Enterprise OID (46501 vs. 39052) → Mit snmpwalk -v 2c -c COMMUNITY IP .1.3.6.1.2.1.1.2.0 sysObjectID prüfen |
| Temperaturwert erscheint 10× zu hoch | Kein Fehler – Didactum liefert Rohwert × 10. Schwellwerte entsprechend × 10 setzen (28 °C = Schwellwert 280) |
| SNMP-Traps kommen nicht an | Trap-Ziel-IP im Didactum Web-Interface nicht konfiguriert; UDP-Port 162 durch Firewall blockiert; Trap-Community stimmt nicht überein |
| Sensor-Wert bleibt immer 0 (Leckage / Türkontakt) | Normal bei unkritischem Zustand (0 = OK). Sensor durch kurzes Auslösen testen; OID per snmpget verifizieren |
| Keine E-Mail bei Alarm | SMTP-Einstellungen in NeuralStar prüfen; Alert-Policy dem Gerät zugewiesen?; Spam-Ordner prüfen |
| Graph zeigt keine Daten | Monitor-Intervall abwarten (erster Datenpunkt nach erstem Polling-Zyklus); SNMP-Verbindung per MIB-Browser testen |
12. Abschluss-Checkliste
Didactum-Gerät
- SNMP aktiviert (v2c)
- Community String gesetzt (nicht „public"): didactum_neuralstar
- Trap-Ziel auf IP des NeuralStar-Servers gesetzt
- Trap-Community gesetzt: didactum_trap
- MIB-Datei heruntergeladen (didactum.mib)
- snmpwalk vom NeuralStar-Server erfolgreich
NeuralStar-Server
- DIDACTUM-MIB erfolgreich importiert
- Didactum-Gerät per Discovery gefunden oder manuell angelegt
- SNMP Community im Device-Profil konfiguriert
- Alle Monitoring-Objekte (OIDs) für Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch angelegt
- Temperaturschwellen als Rohwert × 10 gesetzt (Warning 280 / Critical 350)
- Leckage- und Rauchmelder-Critical-Schwelle auf 1 gesetzt
- SNMP-Trap-Receiver aktiviert (Port 162)
- Alert-Policy „Didactum-Sensor-Alarme" angelegt und dem Gerät zugewiesen
- E-Mail-Benachrichtigung konfiguriert und Test-Mail empfangen
Dashboard & Tests
- Dashboard „Serverraum-Monitoring" mit Sensor-Widgets erstellt
- Temperatur-Graph zeigt Messwerte (nach erstem Polling-Intervall)
- SNMP-Trap-Test: Sensor manuell auslösen → Alarm in NeuralStar erscheint
- E-Mail bei Test-Alarm empfangen
- Alle Sensor-Status im Dashboard grün (Normalbetrieb)