Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in WhatsUp Gold via SNMP – inklusive MIB-Import, Active Monitor, Performance Monitor, SNMP Traps und Alarmierung.

• Software: Progress WhatsUp Gold (2021 / 2022 / 2023 / 2024)
• Protokoll: SNMP v1 / v2c / v3
• Geräte: Didactum Monitoring System 100T / 300T / 500T / 550T
• Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch

WhatsUp Gold Server

• WhatsUp Gold installiert auf Windows Server 2016/2019/2022
• Webinterface erreichbar unter <Server-IP>
• UDP-Port 161 (SNMP Polling) ausgehend geöffnet
• UDP-Port 162 (SNMP Traps) eingehend geöffnet
• Netzwerkzugang zum Didactum-Gerät

Didactum-Gerät

• Monitoring System 100T, 300T / 500T oder 550T
• SNMP aktiviert (v1/v2c oder v3)
• MIB-Datei im Web-Interface verfügbar zum Download
• Netzwerkzugang zum WhatsUp Gold Server

Architektur

[WhatsUp Gold Server]          [Didactum Monitoring System]
  IP: 192.168.1.10    <------    IP: 192.168.1.50
  Port 9642 (WebUI)
                      SNMP Polling (UDP 161)  -->
                      <-- SNMP Traps  (UDP 162)

Drei Monitor-Typen in WhatsUp Gold für Didactum:

• Active Monitor: Prüft einen einzelnen OID-Wert – Gerät gilt als Up oder Down
• Performance Monitor: Sammelt Messwerte für Graphen und Verlaufsberichte
• Passive Monitor (SNMP Trap): Empfängt Alarme, die das Didactum-Gerät eigenständig sendet

Schritt 1 – Web-Interface öffnen

Im Browser aufrufen: 192.168.1.50 (IP des Didactum-Geräts anpassen)

Schritt 2 – SNMP-Einstellungen aufrufen

Systemeinstellungen → SNMP

Schritt 3 – Folgende Werte eintragen

SNMPv3-Einstellungen (optional, erhöhte Sicherheit)

Einstellungen speichern. Das Gerät ist nun bereit für SNMP-Abfragen.

Navigation

Settings → Credentials Library → New

SNMPv2c-Credential anlegen

Auf Save klicken.

SNMPv3-Credential anlegen (falls verwendet)

Variante A – Automatischer Discovery-Scan

Discover → New Scan

1. Im Feld „IP range or subnet" die IP des Didactum-Geräts eintragen: 192.168.1.50
2. Unter Credentials das zuvor angelegte Credential Didactum SNMPv2 auswählen
3. Auf Scan Now klicken
4. Nach Abschluss erscheint das Gerät in der Ergebnisliste
5. Gerät auswählen und auf Monitor klicken, um es in „My Network" aufzunehmen

Variante B – Gerät manuell hinzufügen

My Network → Add Device (+ Symbol oben rechts)

Auf Save klicken. Das Gerät erscheint nun unter „My Network".

Schritt 3 – SNMP-Credential dem Gerät zuweisen (falls nicht automatisch)

My Network → Gerät rechtsklick → Edit Device → Credentials
→ SNMP v2 auswählen → "Didactum SNMPv2" → Save

Der MIB-Import ermöglicht es WhatsUp Gold, OID-Bezeichnungen im Klartext anzuzeigen und erleichtert die Konfiguration von Monitoren erheblich.

Schritt 1 – MIB-Datei vom Didactum laden

Didactum Web-Interface → Systemeinstellungen → SNMP → "MIB-Datei herunterladen"
→ Datei speichern als: didactum.mib

Schritt 2 – MIB-Datei in WhatsUp Gold importieren

Analyze → Tools → SNMP MIB Manager

1. Im MIB Manager auf Import klicken
2. Datei didactum.mib auswählen und öffnen
3. WhatsUp Gold verarbeitet die Datei und zeigt sie in der MIB-Liste an
4. Nach dem Import: WhatsUp Gold Engine Service neu starten (wichtig!)

Schritt 3 – Engine Service neu starten

Windows Server → Dienste (services.msc)
→ "WhatsUp Gold" Dienst → Neu starten

Alternativ per Kommandozeile (als Administrator):
net stop "WhatsUp" && net start "WhatsUp"

Wichtig: 

Ohne Neustart des Engine Service werden neu importierte MIBs beim SNMP-Polling nicht berücksichtigt.

Schritt 4 – MIB im MIB Walker prüfen

Analyze → Tools → SNMP MIB Walker
→ IP-Adresse: 192.168.1.50
→ Community: didactum_wug
→ Start OID: .1.3.6.1.4.1.46501
→ Walk klicken

Erscheinen Einträge mit Sensor-Werten, ist die MIB korrekt importiert und SNMP funktioniert.

Ein Active Monitor prüft, ob ein bestimmter OID-Wert einem Sollwert entspricht. Das Gerät wird dadurch als „Up" oder „Down" markiert – ideal für Leckage- und Statussensoren.

Navigation

Settings → Monitor Library → Active Monitors → New → SNMP Monitor

Active Monitor: Leckagesensor

Bedeutung: Wert 0 = trocken = Up. Sobald der Sensor Wert 1 (Wasser erkannt) meldet, gilt der Monitor als Down und löst einen Alarm aus.

Active Monitor: Temperatursensor-Status

Bedeutung: Status 0 = OK = Up. Bei Status 1 (Alarm) oder 2 (Keine Verbindung) gilt der Monitor als Down.

Active Monitor: Temperatur-Schwellwert (Range)

Wichtig: Didactum liefert Temperaturwerte als Rohwert × 10. 25,5 °C entspricht dem OID-Wert 255. Die Schwellwerte im Monitor müssen daher ebenfalls × 10 eingegeben werden.

Monitor dem Gerät zuweisen

My Network → Didactum Monitoring System 01 → rechtsklick → Edit Device
→ Active Monitors → Add
→ Monitor aus Liste auswählen → OK → Save

Performance Monitore sammeln Messwerte kontinuierlich und stellen sie als Zeitverlaufs-Graph dar – ideal für Temperatur und Luftfeuchtigkeit.

Navigation

Settings → Monitor Library → Performance Monitors → New → SNMP Performance Monitor

Performance Monitor: Temperatur

Auf OK klicken, dann den Monitor dem Gerät zuweisen:

My Network → Didactum Monitoring System 01 → rechtsklick → Edit Device
→ Performance Monitors → Add → "Didactum Temperatur Sensor 01" → OK → Save

Performance Monitor: Luftfeuchtigkeit

Graphen anzeigen

My Network → Didactum Monitoring System 01 → Device Status
→ Reiter "Performance" → Sensor auswählen → Zeitraum wählen

Der „Extended SNMP Monitor" erlaubt es, mehrere OIDs gleichzeitig mit individuellen Schwellwerten zu überwachen – per XML-Datei, die einmalig erstellt und dann importiert wird.

Schritt 1 – XML-Datei erstellen

Folgende XML-Datei erstellen und speichern als didactum_sensors.xml:

<?xml version="1.0" encoding="UTF-8"?>
<SNMPParameters>

  <SNMPParameter Name="TemperaturSensor01">
    <ShortDescription>Temperatur Sensor 01 (Rohwert x0.1 = Grad C)</ShortDescription>
    <LongDescription>Digitaler Temperatursensor, Sensor-ID 101001</LongDescription>
    <Type>Integer</Type>
    <IndexOID>0</IndexOID>
    <OID>.1.3.6.1.4.1.46501.5.1.1.7.101001</OID>
    <DisplayOID>.1.3.6.1.4.1.46501.5.1.1.7.101001</DisplayOID>
    <Units>0.1 Grad C</Units>
  </SNMPParameter>

  <SNMPParameter Name="TemperaturStatus01">
    <ShortDescription>Temp Sensor 01 Status (0=OK, 1=Alarm, 2=Kein Signal)</ShortDescription>
    <LongDescription>Statuswert des digitalen Temperatursensors</LongDescription>
    <Type>Integer</Type>
    <IndexOID>0</IndexOID>
    <OID>.1.3.6.1.4.1.46501.5.1.1.6.101001</OID>
    <DisplayOID>.1.3.6.1.4.1.46501.5.1.1.6.101001</DisplayOID>
    <Units>Status</Units>
  </SNMPParameter>

  <SNMPParameter Name="Leckagesensor01">
    <ShortDescription>Wassersensor 01 (0=trocken, 1=Wasser erkannt)</ShortDescription>
    <LongDescription>Leckagesensor, Sensor-ID 107001</LongDescription>
    <Type>Integer</Type>
    <IndexOID>0</IndexOID>
    <OID>.1.3.6.1.4.1.46501.5.1.1.7.107001</OID>
    <DisplayOID>.1.3.6.1.4.1.46501.5.1.1.7.107001</DisplayOID>
    <Units>0=OK 1=ALARM</Units>
  </SNMPParameter>

  <SNMPParameter Name="Luftfeuchtigkeit01">
    <ShortDescription>Luftfeuchtigkeit Sensor 01 (Wert in %)</ShortDescription>
    <LongDescription>Luftfeuchtigkeitssensor, Sensor-ID 102001</LongDescription>
    <Type>Integer</Type>
    <IndexOID>0</IndexOID>
    <OID>.1.3.6.1.4.1.46501.5.1.1.7.102001</OID>
    <DisplayOID>.1.3.6.1.4.1.46501.5.1.1.7.102001</DisplayOID>
    <Units>%</Units>
  </SNMPParameter>

  <SNMPParameter Name="Tuerkonakt01">
    <ShortDescription>Tuerkonakt 01 (0=geschlossen, 1=geoeffnet)</ShortDescription>
    <LongDescription>Tuerkonaktsensor, Sensor-ID 104001</LongDescription>
    <Type>Integer</Type>
    <IndexOID>0</IndexOID>
    <OID>.1.3.6.1.4.1.46501.5.1.1.7.104001</OID>
    <DisplayOID>.1.3.6.1.4.1.46501.5.1.1.7.104001</DisplayOID>
    <Units>0=zu 1=offen</Units>
  </SNMPParameter>

</SNMPParameters>

Schritt 2 – XML-Datei in WhatsUp Gold-Verzeichnis kopieren

Zieldverzeichnis auf dem WhatsUp Gold Server:
C:\Program Files (x86)\Ipswitch\WhatsUp\Data\SNMPExtended\

Datei dort ablegen:
didactum_sensors.xml

Schritt 3 – Extended SNMP Monitor anlegen

Settings → Monitor Library → Active Monitors → New → SNMP Extended Monitor

1. Name: Didactum Alle Sensoren eintragen
2. Auf Import klicken
3. Datei didactum_sensors.xml aus dem Verzeichnis auswählen → OK
4. Alle importierten Parameter erscheinen in der Schwellwert-Tabelle
5. Für jeden Parameter auf Configure klicken und Schwellwert setzen:

WhatsUp Gold kann SNMP-Traps empfangen, die das Didactum-Gerät bei einem Alarm eigenständig sendet – ohne Polling-Verzögerung.

Schritt 1 – Trap-Empfang in WhatsUp Gold prüfen

WhatsUp Gold empfängt SNMP-Traps standardmäßig auf UDP-Port 162. Prüfen, ob der Dienst lauscht:

Windows Server → Firewall → Eingehende Regel prüfen:
UDP Port 162 muss für WhatsUp Gold freigegeben sein

Schritt 2 – SNMP-Trap-Monitor anlegen

Settings → Monitor Library → Passive Monitors → New → SNMP Trap Monitor

Alternativ: OID-Feld leer lassen, um alle eingehenden Traps zu empfangen (für erste Tests empfohlen).

Schritt 3 – Trap-Monitor dem Gerät zuweisen

My Network → Didactum Monitoring System 01 → rechtsklick → Edit Device
→ Passive Monitors → Add → "Didactum SNMP Trap – Alarm" → OK → Save

Schritt 4 – Traps in der Event-Log-Ansicht prüfen

Reports → Event Log
→ Filter: Source = 192.168.1.50
→ Eingehende Traps werden hier angezeigt

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

Sensortypen mit OIDs

Sensor-ID herausfinden: 

Im Didactum Web-Interface unter Systembaum → Sensor auswählen → Details. Diese ID wird ans Ende der OID angehängt.

MIB-Prefix je Modell: 

Ältere Geräte verwenden .1.3.6.1.4.1.46501, neuere Modelle eventuell .1.3.6.1.4.1.39052. Die genauen OIDs entnehmen Sie der MIB-Datei Ihres Geräts.

Temperatur-Rohwert in WhatsUp Gold: 

Da WhatsUp Gold keine eingebaute Skalierungsfunktion für OID-Werte hat, müssen Schwellwerte immer als Rohwert × 10 eingegeben werden. 28 °C = Schwellwert 280.

Schritt 1 – Alert Center öffnen

Alerts → Alert Center

Schritt 2 – Neue Alert-Richtlinie anlegen

Alerts → Alert Center → New Policy

Schritt 3 – E-Mail-Benachrichtigung hinzufügen

In der Alert Policy → Actions → Add Action → Send Email

Schritt 4 – E-Mail-Server konfigurieren

Settings → Email & SMS Settings → SMTP Settings
→ SMTP Server, Port, Absenderadresse eintragen → Test Email senden

Schritt 5 – Eskalation einrichten (optional)

In der Alert Policy → Escalation
→ "If not acknowledged within 15 minutes → send to: Zweite E-Mail-Adresse"

SNMP-Verbindung per MIB Walker testen

Analyze → Tools → SNMP MIB Walker
→ IP: 192.168.1.50
→ Community: didactum_wug
→ OID: .1.3.6.1.4.1.46501
→ Walk ausführen

Erscheinen Werte, ist die SNMP-Verbindung funktionsfähig.

Einzelnen OID-Wert abfragen

Analyze → Tools → SNMP MIB Walker
→ Start OID: .1.3.6.1.4.1.46501.5.1.1.7.101001
→ Get (statt Walk)
→ Angezeigter Wert z.B. 235 = 23,5 °C

Fehlermeldungen und Lösungen

WhatsUp Gold Protokoll einsehen

Reports → Event Log
→ Filter nach Gerät oder Zeitraum

Windows Eventlog:
Ereignisanzeige → Anwendungen → WhatsUp

Didactum-Gerät

• SNMP aktiviert (v2c oder v3)
• Community String gesetzt (nicht „public")
• Trap-Empfänger-IP auf WhatsUp Gold Server gesetzt
• Trap-Port 162 eingetragen
• MIB-Datei heruntergeladen

WhatsUp Gold – Grundkonfiguration

• SNMP-Credential „Didactum SNMPv2" in der Credentials Library angelegt
• Firewall: UDP 161 ausgehend, UDP 162 eingehend geöffnet
• MIB-Datei didactum.mib importiert (MIB Manager)
• Engine Service nach MIB-Import neu gestartet
• MIB Walker-Test erfolgreich (Sensor-Werte sichtbar)
• Didactum-Gerät per Discovery oder manuell hinzugefügt
• SNMP-Credential dem Gerät zugewiesen

Monitore

• Active Monitor für Leckagesensor angelegt und zugewiesen
• Active Monitor für Temperatursensor-Status angelegt
• Performance Monitor für Temperaturverlauf angelegt
• Performance Monitor für Luftfeuchtigkeitsverlauf angelegt
• Extended SNMP Monitor mit XML-Datei importiert (optional)
• SNMP-Trap-Monitor (Passive Monitor) angelegt und zugewiesen

Alarmierung

• SMTP-Einstellungen konfiguriert und Test-Mail versendet
• Alert Policy „Didactum Sensor Alarm" angelegt
• E-Mail-Aktion in der Policy hinterlegt
• Test-Alarm ausgelöst und E-Mail empfangen
• Eskalation konfiguriert (optional)