Didactum Monitoring & OSI NetExpert Integration

Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in OSI NetExpert via SNMP – inklusive Gerätedefinition im NetExpert Object Model, MIB-Import in den NetExpert MIB-Browser, Rule-Engine-Konfiguration für Schwellwert- und Trap-basierte Alarme, vollständiger OID-Referenz für alle Sensortypen (Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch) sowie Benachrichtigungs- und Dashboard-Konfiguration.

Architektur-Hinweis: OSI NetExpert arbeitet mit einem regelbasiertem Ansatz (Rule Engine). Das Didactum-Gerät wird als verwaltetes Objekt (Managed Object) im NetExpert Object Model definiert. NetExpert pollt das Didactum-Gerät per SNMP-GET (UDP-Port 161) und empfängt SNMP-Traps vom Didactum-Gerät (UDP-Port 162). Die Rule Engine wertet eingehende SNMP-Daten und Traps aus, erzeugt Alarme und löst automatische Aktionen aus.

• Software: OSI NetExpert (aktuelle Version)
• Komponenten: NetExpert Server, Rule Engine, MIB-Browser, Object Model Editor
• 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

OSI NetExpert Server

Komponente	Anforderung / Details
OSI NetExpert Version	Aktuelle Version empfohlen; Rule Engine und MIB-Browser müssen aktiviert sein
NetExpert Server	Erreichbar per Netzwerk vom Didactum-Gerät (für Trap-Versand)
SNMP-Poller	Integriert in NetExpert; UDP-Port 161 ausgehend zum Didactum-Gerät geöffnet
SNMP-Trap-Receiver	UDP-Port 162 eingehend am NetExpert-Server geöffnet
Object Model Editor	Für die Definition des Didactum-Geräts als Managed Object
Rule Engine	Für Schwellwert-Regeln und Trap-basierte Alarmierung
MIB-Browser	Für den Import der Didactum-MIB und OID-Auflösung

Didactum-Gerät

Anforderung	Details
Modell	Monitoring System 100T, 300T, 500T oder 550T
SNMP	SNMP aktiviert (v2c empfohlen)
Community String	Individueller Community String (nicht „public" verwenden)
Trap-Ziel	IP-Adresse des OSI-NetExpert-Servers
MIB-Datei	Unter Systemeinstellungen → SNMP herunterladbar

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, ermitteln 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

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_netexpert (nicht „public" verwenden!)
SNMP-Port	161
Trap-Ziel (Trap Destination)	IP-Adresse des OSI-NetExpert-Servers
Trap-Community	didactum_trap
Trap-Port	162

Schritt 4 – MIB-Datei herunterladen

Systemeinstellungen → SNMP → "MIB-Datei herunterladen"
Datei wird als didactum.mib gespeichert.
Diese Datei wird in Schritt 3 in NetExpert importiert.

Einstellungen speichern. Das Gerät sendet Traps ab sofort an den NetExpert-Server.

3. MIB-Datei in OSI NetExpert importieren

Der NetExpert MIB-Browser wird verwendet, um die Didactum-MIB zu importieren und OID-Nummern in lesbare symbolische Namen aufzulösen. Dies ist Voraussetzung für die spätere Konfiguration von SNMP-Polling-Regeln und Trap-Definitionen in der Rule Engine.

Schritt 1 – MIB-Verzeichnis ermitteln

Standard-Pfad auf Windows:
  C:\Program Files\OSI\NetExpert\mibs\

Standard-Pfad auf Linux:
  /opt/osi/netexpert/mibs/

(Exakter Pfad je nach Installation; ggf. in der NetExpert-Installationsdokumentation nachschlagen)

Schritt 2 – MIB-Datei in das NetExpert-MIB-Verzeichnis kopieren

didactum.mib in das NetExpert-MIB-Verzeichnis kopieren:
  → <netexpert-install-pfad>\mibs\didactum.mib

Schritt 3 – MIB über den NetExpert MIB-Browser laden

OSI NetExpert → Tools → MIB Browser → Load MIB
  → Datei didactum.mib auswählen
  → Import bestätigen
  → Im MIB-Baum erscheint: iso → org → dod → internet → private → enterprises → didactum
  → Enterprise OID .1.3.6.1.4.1.46501 wird mit symbolischen Namen aufgelöst

Schritt 4 – MIB-Import verifizieren

OSI NetExpert MIB Browser → OID-Suche: DIDACTUM-MIB::sensorValue
  → Ergebnis: .1.3.6.1.4.1.46501.5.1.1.7 (korrekte Auflösung bestätigt)

MIB Browser → OID-Suche: .1.3.6.1.4.1.46501.5.1.1.7.101001
  → Ergebnis: DIDACTUM-MIB::sensorValue.101001 (symbolischer Name erscheint)

Fertige MIB-Importkonfiguration (DIDACTUM-MIB.txt)

Falls keine MIB-Datei aus dem Gerät verfügbar ist, folgende minimale MIB-Struktur als DIDACTUM-MIB.txt speichern, in das NetExpert-MIB-Verzeichnis kopieren und wie oben beschrieben importieren:

-- ================================================================
-- DIDACTUM-MIB – Minimale MIB für OSI NetExpert 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 }

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 }

didactumAlarmTrap NOTIFICATION-TYPE
    OBJECTS { sensorName, sensorStatus, sensorValue }
    STATUS  current
    DESCRIPTION "Alarm-Trap bei Sensor-Statusänderung"
    ::= { didactum 1 1 }

END

4. Didactum-Gerät im NetExpert Object Model anlegen

OSI NetExpert verwaltet alle überwachten Geräte im Object Model. Das Didactum-Gerät wird dort als Managed Object angelegt und erhält eine Geräteklassen-Definition, die alle SNMP-Attribute (OIDs) sowie deren Polling-Intervalle und Schwellwerte beschreibt.

Schritt 1 – Object Model Editor öffnen

OSI NetExpert → Administration → Object Model Editor
  → Alternativ: NetExpert Console → Tools → Object Model

Schritt 2 – Neue Geräteklasse anlegen

Object Model Editor → Device Classes → New Class

  Class Name:      DidactumMonitoringSystem
  Description:     Didactum Environmental Monitoring Device
  SNMP Version:    v2c
  Base OID:        .1.3.6.1.4.1.46501
  MIB:             DIDACTUM-MIB
  Icon:            Environmental Monitor (aus NetExpert-Icon-Bibliothek wählen)

Schritt 3 – SNMP-Attribute zur Geräteklasse hinzufügen

Object Model Editor → DidactumMonitoringSystem → Attributes → Add Attribute

  -- Attribut 1: Temperatursensor Messwert --
  Attribute Name:  temperature_value_01
  OID:             .1.3.6.1.4.1.46501.5.1.1.7.101001
  Data Type:       Integer
  Description:     Temperatur Sensor 01 – Rohwert x10 (235 = 23,5 Grad C)
  Poll Interval:   60

  -- Attribut 2: Temperatursensor Status --
  Attribute Name:  temperature_status_01
  OID:             .1.3.6.1.4.1.46501.5.1.1.6.101001
  Data Type:       Integer
  Description:     0=OK, 1=Alarm, 2=Kein Signal
  Poll Interval:   60

  -- Attribut 3: Leckage Messwert --
  Attribute Name:  leakage_value_01
  OID:             .1.3.6.1.4.1.46501.5.1.1.7.107001
  Data Type:       Integer
  Description:     0=trocken/OK, 1=Wasser erkannt/CRITICAL
  Poll Interval:   30

  -- Attribut 4: Luftfeuchtigkeit Messwert --
  Attribute Name:  humidity_value_01
  OID:             .1.3.6.1.4.1.46501.5.1.1.7.102001
  Data Type:       Integer
  Description:     Luftfeuchtigkeit in %
  Poll Interval:   60

  -- Attribut 5: Türkontakt Messwert --
  Attribute Name:  door_contact_01
  OID:             .1.3.6.1.4.1.46501.5.1.1.7.104001
  Data Type:       Integer
  Description:     0=geschlossen/OK, 1=geöffnet/Warning
  Poll Interval:   30

  -- Attribut 6: Rauchmelder Messwert --
  Attribute Name:  smoke_detector_01
  OID:             .1.3.6.1.4.1.46501.5.1.1.7.106001
  Data Type:       Integer
  Description:     0=kein Rauch/OK, 1=Alarm/CRITICAL
  Poll Interval:   30

Schritt 4 – Geräteklasse speichern und publizieren

Object Model Editor → DidactumMonitoringSystem → File → Save
  → "Publish to NetExpert Server" klicken
  → Geräteklasse steht nun für die Geräteinstanz-Anlage bereit

Schritt 5 – Geräteinstanz anlegen

OSI NetExpert → Network Map → Add Device  (oder: Topology → New Managed Object)

  Device Name:       Didactum-Monitor-01
  IP Address:        192.168.1.50
  Device Class:      DidactumMonitoringSystem
  SNMP Community:    didactum_netexpert
  SNMP Version:      v2c
  SNMP Port:         161
  Location:          Serverraum
  Description:       Didactum Monitoring System 300T – Serverraum
  → Speichern → Gerät erscheint in der Network Map

5. Rule Engine – Schwellwert-Regeln konfigurieren

Die NetExpert Rule Engine ist das Herzstück der Alarmverarbeitung. Für jeden Didactum-Sensor wird eine Regel definiert, die bei Schwellwertüberschreitung einen Alarm erzeugt und Aktionen (E-Mail, SNMP-Trap-Forward, Skript) auslöst.

Wichtig – Temperaturschwellwerte: Das Didactum-Gerät liefert Temperaturwerte als Rohwert × 10. 25,5 °C = OID-Wert 255. Alle Temperaturschwellen in der Rule Engine müssen ebenfalls × 10 angegeben werden.

Rule Engine öffnen

OSI NetExpert → Administration → Rule Engine Editor
  → Alternativ: NetExpert Console → Tools → Rules

Regel 1 – Temperatur Warning

Rule Engine Editor → New Rule

  Rule Name:      Didactum_Temperatur_Warning
  Trigger:        SNMP Poll Result
  Device Class:   DidactumMonitoringSystem
  Attribute:      temperature_value_01
  Condition:      value >= 280 AND value < 350
                  (Rohwert: 280 = 28,0 Grad C / 350 = 35,0 Grad C)
  Severity:       Warning
  Alarm Message:  Didactum Temperatur Warning: Rohwert ${value} entspricht ${value/10} Grad C
  Action:         Create Alarm + Send Email
  Auto-Clear:     Ja (Alarm wird gelöscht wenn value < 270)
  → Speichern

Regel 2 – Temperatur Critical

  Rule Name:      Didactum_Temperatur_Critical
  Trigger:        SNMP Poll Result
  Attribute:      temperature_value_01
  Condition:      value >= 350
  Severity:       Critical
  Alarm Message:  KRITISCH: Didactum Temperatur-Alarm: Rohwert ${value} entspricht ${value/10} Grad C
  Action:         Create Alarm + Send Email + Execute Script
  Auto-Clear:     Ja (Alarm wird gelöscht wenn value < 340)
  → Speichern

Regel 3 – Temperatur-Sensor kein Signal

  Rule Name:      Didactum_Temperatur_NoSignal
  Trigger:        SNMP Poll Result
  Attribute:      temperature_status_01
  Condition:      value == 2
  Severity:       Warning
  Alarm Message:  Didactum: Temperatursensor 01 liefert kein Signal (Status = 2)
  → Speichern

Regel 4 – Leckage / Wassersensor Critical

  Rule Name:      Didactum_Leckage_Critical
  Trigger:        SNMP Poll Result
  Attribute:      leakage_value_01
  Condition:      value >= 1
  Severity:       Critical
  Alarm Message:  KRITISCH: Didactum Leckage-Alarm – Wasser erkannt! Gerät: ${device.name}
  Action:         Create Alarm + Send Email (sofort, keine Verzögerung)
  Auto-Clear:     Ja (Alarm wird gelöscht wenn value == 0)
  → Speichern

Regel 5 – Luftfeuchtigkeit Warning

  Rule Name:      Didactum_Humidity_Warning
  Attribute:      humidity_value_01
  Condition:      value >= 80 AND value < 90
  Severity:       Warning
  Alarm Message:  Didactum Luftfeuchtigkeit Warning: ${value} %
  Auto-Clear:     Ja (value < 75)
  → Speichern

Regel 6 – Luftfeuchtigkeit Critical

  Rule Name:      Didactum_Humidity_Critical
  Attribute:      humidity_value_01
  Condition:      value >= 90
  Severity:       Critical
  Alarm Message:  KRITISCH: Didactum Luftfeuchtigkeit-Alarm: ${value} %
  Auto-Clear:     Ja (value < 85)
  → Speichern

Regel 7 – Türkontakt geöffnet

  Rule Name:      Didactum_DoorContact_Warning
  Attribute:      door_contact_01
  Condition:      value == 1
  Severity:       Warning
  Alarm Message:  Didactum Türkontakt: Tür geöffnet – Gerät: ${device.name}
  Auto-Clear:     Ja (value == 0)
  → Speichern

Regel 8 – Rauchmelder Critical

  Rule Name:      Didactum_Smoke_Critical
  Attribute:      smoke_detector_01
  Condition:      value == 1
  Severity:       Critical
  Alarm Message:  KRITISCH: Didactum Rauchmelder-Alarm! Gerät: ${device.name}
  Action:         Create Alarm + Send Email + Execute Script
  Auto-Clear:     Ja (value == 0)
  → Speichern

Alle Regeln aktivieren

Rule Engine Editor → File → Save All Rules
  → "Deploy Rules to NetExpert Server" klicken
  → Rule Engine neu starten falls erforderlich:
     Administration → Services → Rule Engine → Restart

6. SNMP-Trap-Empfang und Trap-Regeln konfigurieren

Zusätzlich zum SNMP-Polling empfängt OSI NetExpert SNMP-Traps vom Didactum-Gerät. Für jede Trap-OID wird in der Rule Engine eine eigene Trap-Regel definiert.

Schritt 1 – SNMP-Trap-Receiver aktivieren

OSI NetExpert → Administration → SNMP Settings → Trap Receiver

  Listen Port:      162
  Community:        didactum_trap
  SNMP Version:     v2c
  MIB:              DIDACTUM-MIB (zuvor importiert)
  → "Enable Trap Receiver" aktivieren
  → Speichern

Schritt 2 – Trap-Quelle autorisieren

OSI NetExpert → Administration → SNMP Settings → Allowed Trap Sources
  → "Add Source"
  → IP-Adresse: 192.168.1.50
  → Community:  didactum_trap
  → Speichern

Schritt 3 – Trap-Regeln in der Rule Engine anlegen

Rule Engine Editor → New Rule → Trigger: SNMP Trap

  -- Trap-Regel 1: Allgemeiner Didactum-Alarm-Trap --
  Rule Name:      Didactum_Trap_Alarm
  Trigger:        SNMP Trap
  Trap OID:       .1.3.6.1.4.1.46501.1.1   (didactumAlarmTrap)
  Source IP:      192.168.1.50
  Community:      didactum_trap
  Severity:       Critical
  Alarm Message:  Didactum Trap-Alarm: ${trapVarBind[sensorName]} –
                  Status ${trapVarBind[sensorStatus]} –
                  Wert ${trapVarBind[sensorValue]}
  Action:         Create Alarm + Send Email
  → Speichern

  -- Trap-Regel 2: Entwarnung (optional) --
  Rule Name:      Didactum_Trap_Clear
  Trigger:        SNMP Trap
  Trap OID:       .1.3.6.1.4.1.46501.1.2
  Severity:       Clear / Informational
  Alarm Message:  Didactum: ${trapVarBind[sensorName]} – Zustand wieder normal
  Action:         Clear Alarm + Send Email
  → Speichern

Schritt 4 – Trap-Weiterleitung im Didactum Web-Interface prüfen

Didactum Web-Interface → Systemeinstellungen → SNMP → Trap-Ziele

  Trap Destination: 192.168.1.100   (IP des OSI-NetExpert-Servers)
  Trap Community:   didactum_trap
  Trap Version:     v2c
  Trap Port:        162
  → Speichern

7. Benachrichtigungen (Notifications) konfigurieren

E-Mail-Aktion in der Rule Engine konfigurieren

OSI NetExpert → Administration → Notification Manager → New Email Action

  Action Name:     Didactum_Email_Admin
  SMTP Server:     mail.ihredomain.de
  From:            netexpert@ihredomain.de
  To:              admin@ihredomain.de
  Subject:         [NetExpert] Didactum Alarm: ${alarm.device} – ${alarm.severity}
  Body:
    Zeitpunkt:   ${alarm.timestamp}
    Gerät:       ${alarm.device} (${alarm.ip})
    Regelname:   ${alarm.rule}
    Schwere:     ${alarm.severity}
    Attribut:    ${alarm.attribute}
    Wert:        ${alarm.value}
    Meldung:     ${alarm.message}
    Standort:    ${alarm.location}
  → Speichern

Eskalations-Policy konfigurieren

OSI NetExpert → Administration → Escalation Policies → New Policy

  Policy Name:     Didactum_Eskalation
  Applies to:      Device Class DidactumMonitoringSystem

  Stufe 1 – Sofort (0 Minuten):
    Aktion:        E-Mail an admin@ihredomain.de
    Bedingung:     Severity Warning ODER Critical

  Stufe 2 – Nach 5 Minuten (Alarm noch aktiv):
    Aktion:        E-Mail an it-leitung@ihredomain.de
    Bedingung:     Severity Critical

  Stufe 3 – Nach 15 Minuten (Alarm noch aktiv):
    Aktion:        SNMP-Trap-Forward an SIEM oder weiteres NMS
    Bedingung:     Severity Critical
  → Speichern

8. Network Map und Dashboard konfigurieren

Schritt 1 – Didactum-Gerät in der Network Map positionieren

OSI NetExpert → Network Map → Serverraum-Topologie

  → Didactum-Monitor-01 in die Karte ziehen
  → Icon: Environmental Monitor
  → Farb-Kodierung: Grün (OK), Gelb (Warning), Rot (Critical)
  → Tooltip: Zeigt aktuellen Status aller konfigurierten Attribute

Schritt 2 – Dashboard-Ansicht anlegen

OSI NetExpert → Dashboards → New Dashboard

  Dashboard Name: Serverraum-Monitoring Didactum

  Widget 1: Performance Chart – Temperatur-Trend
    Device:    Didactum-Monitor-01
    Attribut:  temperature_value_01
    Zeitraum:  Letzte 24 Stunden
    Y-Achse:   Rohwert (÷10 = Grad C)
    Linien:    Warning bei 280 / Critical bei 350

  Widget 2: Status-Indikator – Leckage
    Device:    Didactum-Monitor-01
    Attribut:  leakage_value_01
    OK:        Grün (0)
    Critical:  Rot (1)

  Widget 3: Gauge – Luftfeuchtigkeit
    Device:    Didactum-Monitor-01
    Attribut:  humidity_value_01
    Min / Max: 0 / 100 %
    Warning:   80 %
    Critical:  90 %

  Widget 4: Status-Indikator – Türkontakt
    Attribut:  door_contact_01

  Widget 5: Status-Indikator – Rauchmelder
    Attribut:  smoke_detector_01

  Widget 6: Active Alarms List
    Filter:    Device Class = DidactumMonitoringSystem
    Zeigt alle aktiven Alarme und Trap-Ereignisse in Echtzeit

Schritt 3 – Alarm-Konsole konfigurieren

OSI NetExpert → Alarm Console → Filter → New Filter

  Filter Name:  Didactum-Alarme
  Device Class: DidactumMonitoringSystem
  Severity:     Warning, Critical
  → Als Standard-Tab in der Alarm-Konsole speichern

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 NetExpert Rule-Engine-Schwellwerten

Sensortyp	Sensor-ID	OID Messwert	OID Status	Rule-Engine-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 / OK)
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 / OK)
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 / OK)

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 usw.

Temperaturschwellwerte in der Rule Engine: 

Didactum liefert Temperatur als Rohwert × 10. 28,0 °C = OID-Wert 280. Rule-Engine-Bedingungen (value >= X) ebenfalls als × 10-Wert formulieren. In Alarm-Messages auf „${value/10} Grad C" hinweisen.

10. SNMP-Verbindung testen

Test per Kommandozeile (vom NetExpert-Server aus)

# snmpwalk – alle Sensor-Werte auflisten
snmpwalk -v 2c -c didactum_netexpert 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1

# snmpget – Temperaturwert abfragen (Rohwert ÷ 10 = °C)
snmpget -v 2c -c didactum_netexpert 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_netexpert 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_netexpert 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_netexpert -m ALL 192.168.1.50 \
    DIDACTUM-MIB::sensorValue

Test über NetExpert MIB-Browser

OSI NetExpert → Tools → MIB Browser

  Host:      192.168.1.50
  Community: didactum_netexpert
  Version:   v2c
  OID:       .1.3.6.1.4.1.46501.5.1.1.7.101001
  → "Get" klicken → Wert erscheint (z. B. 235 = 23,5 °C)

MIB Browser → Walk → OID: .1.3.6.1.4.1.46501.5.1.1
  → Alle Sensor-OIDs und Rohwerte werden aufgelistet

Polling-Ergebnis im Object Model prüfen

OSI NetExpert → Managed Objects → Didactum-Monitor-01
  → Attribute View → temperature_value_01
  → Letzter Polling-Zeitstempel und Rohwert erscheinen
  → Status: OK / Warning / Critical gemäß konfigurierter Rule

Trap-Empfang testen

Im Didactum Web-Interface einen Test-Trap auslösen:
  Systemeinstellungen → SNMP → "Test Trap senden"

In OSI NetExpert prüfen:
  → Alarm Console → Filter: Didactum-Alarme
  → Neuer Alarm mit Source 192.168.1.50 erscheint
  → Severity: Critical
  → Message: Didactum Trap-Alarm: …

11. Fehlersuche und Lösungen

Problem	Ursache & Lösung
MIB-Browser zeigt OID nicht aufgelöst	DIDACTUM-MIB nicht oder fehlerhaft importiert; abhängige MIBs (SNMPv2-SMI, RFC1213-MIB) fehlen → Basis-MIBs zuerst importieren; alternativ DIDACTUM-MIB.txt aus Abschnitt 3 verwenden
SNMP-Verbindungstest schlägt fehl	SNMP auf dem Didactum-Gerät nicht aktiviert; Community String falsch; UDP-Port 161 durch Firewall zwischen NetExpert-Server und Gerät blockiert → snmpwalk direkt vom Server aus testen
OID liefert „No Such Object"	Falsche Enterprise OID (46501 vs. 39052) → sysObjectID per snmpwalk prüfen: snmpwalk -v 2c -c COMMUNITY IP .1.3.6.1.2.1.1.2.0
Temperaturwert erscheint 10× zu hoch	Kein Fehler – Didactum liefert Rohwert × 10. Rule-Engine-Bedingungen als × 10-Wert formulieren (28 °C = value >= 280). In Alarm-Message auf ÷10 hinweisen.
Rule wird nicht ausgelöst	Rule nicht deployed (nur gespeichert, nicht publiziert) → Rule Engine Editor → Deploy Rules; Rule Engine-Dienst neu starten; Geräteklasse im Managed Object korrekt zugewiesen?
SNMP-Traps kommen nicht an	Trap-Ziel-IP im Didactum Web-Interface falsch; UDP-Port 162 am NetExpert-Server durch Firewall blockiert; Trap-Community stimmt nicht überein → NetExpert Trap-Receiver-Log prüfen
Trap-Regel erzeugt keinen Alarm	Trap-OID in der Regel stimmt nicht exakt überein; Didactum-IP nicht in Allowed Trap Sources; Trap-Community falsch → Trap-OID per MIB-Browser verifizieren
Keine E-Mail bei Alarm	SMTP-Konfiguration in NetExpert fehlt oder ist falsch; E-Mail-Aktion nicht in der Regel referenziert; Eskalations-Policy nicht aktiviert → Administration → Notification Manager prüfen
Sensor-Wert bleibt immer 0 (Leckage / Türkontakt)	Normal bei unkritischem Zustand (0 = OK). Sensor durch kurzes Auslösen testen; OID per snmpget direkt vom NetExpert-Server verifizieren.
Polling-Attribut erscheint nicht im Object Model	Geräteklasse nicht gespeichert und deployed; Attribut-OID falsch eingegeben → Object Model Editor → DidactumMonitoringSystem → Attribute prüfen; Klasse erneut publishen

12. Abschluss-Checkliste

Didactum-Gerät

• SNMP aktiviert (v2c)
• Community String gesetzt (nicht „public"): didactum_netexpert
• Trap-Ziel auf IP des OSI-NetExpert-Servers gesetzt
• Trap-Community gesetzt: didactum_trap
• MIB-Datei heruntergeladen (didactum.mib)
• snmpwalk vom NetExpert-Server erfolgreich

OSI NetExpert Server

• DIDACTUM-MIB in MIB-Verzeichnis kopiert und über MIB-Browser importiert
• MIB-Auflösung im MIB-Browser verifiziert (sensorValue = .5.1.1.7)
• Geräteklasse DidactumMonitoringSystem im Object Model angelegt
• Alle 6 SNMP-Attribute in der Geräteklasse definiert (temperature, leakage, humidity, door, smoke)
• Geräteklasse deployed (publiziert)
• Geräteinstanz Didactum-Monitor-01 angelegt (IP, Community, Geräteklasse)
• Alle 8 Rule-Engine-Regeln angelegt und deployed
• Temperaturschwellen als Rohwert × 10 formuliert (Warning >= 280 / Critical >= 350)
• SNMP-Trap-Receiver aktiviert (Port 162)
• Didactum-IP in Allowed Trap Sources eingetragen
• Trap-Regeln für Didactum-Alarm-Traps in der Rule Engine angelegt
• E-Mail-Aktion und Eskalations-Policy konfiguriert

Tests & Verifizierung

• MIB-Browser-Get auf .1.3.6.1.4.1.46501.5.1.1.7.101001 liefert Rohwert
• Attribute View im Managed Object zeigt Polling-Ergebnisse nach erstem Intervall
• Network Map: Didactum-Monitor-01 erscheint grün (Normalbetrieb)
• Dashboard „Serverraum-Monitoring Didactum" mit allen Widgets konfiguriert
• Test-Trap über Didactum Web-Interface ausgelöst → Alarm in Alarm Console erscheint
• E-Mail bei Test-Alarm empfangen
• Rule-Engine-Test: Schwellwert manuell unterschreiten/überschreiten → Alarm erzeugt und aufgehoben