Complete step-by-step guide for integrating Didactum monitoring devices and sensors into WhatsUp Gold via SNMP – including MIB import, Active Monitor, Performance Monitor, SNMP traps and alerting.

• Software: Progress WhatsUp Gold (2021 / 2022 / 2023 / 2024)
• Protocol: SNMP v1 / v2c / v3
• Devices: Didactum Monitoring System 100T / 300T / 500T / 550T
• Sensors: Temperature, leakage, humidity, door contact, smoke

WhatsUp Gold Server

• WhatsUp Gold installed on Windows Server 2016/2019/2022
• Web interface accessible at <Server-IP>
• UDP port 161 (SNMP polling) open outbound
• UDP port 162 (SNMP traps) open inbound
• Network access to the Didactum device

Didactum Device

• Monitoring System 100T, 300T / 500T or 550T
• SNMP enabled (v1/v2c or v3)
• MIB file available for download in the web interface
• Network access to the WhatsUp Gold server

Architecture

[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)

Three monitor types in WhatsUp Gold for Didactum:

• Active Monitor: Checks a single OID value – device is considered up or down
• Performance Monitor: Collects measurement values for graphs and historical reports
• Passive Monitor (SNMP Trap): Receives alarms that the Didactum device sends independently

Step 1 – Open web interface

Open in the browser: 192.168.1.50 (adjust the IP of the Didactum device)

Step 2 – Open SNMP settings

System settings → SNMP

Step 3 – Enter the following values

SNMPv3 settings (optional, increased security)

Save the settings. The device is now ready for SNMP queries.

Navigation

Settings → Credentials Library → New

Create SNMPv2c credential

Click Save.

Create SNMPv3 credential (if used)

Option A – Automatic discovery scan

Discover → New Scan

1. Enter the IP of the Didactum device in the field “IP range or subnet": 192.168.1.50
2. Under Credentials, select the previously created credential Didactum SNMPv2
3. Click Scan Now
4. After completion, the device appears in the results list
5. Select the device and click Monitor to add it to “My Network"

Option B – Add device manually

My Network → Add Device (+ symbol top right)

Click Save. The device now appears under “My Network".

Step 3 – Assign SNMP credential to the device (if not automatic)

My Network → Right-click device → Edit Device → Credentials
→ Select SNMP v2 → "Didactum SNMPv2" → Save

The MIB import allows WhatsUp Gold to display OID labels in plain text and significantly simplifies the configuration of monitors.

Step 1 – Download MIB file from Didactum

Didactum web interface → System settings → SNMP → "Download MIB file"
→ Save file as: didactum.mib

Step 2 – Import MIB file into WhatsUp Gold

Analyze → Tools → SNMP MIB Manager

1. In the MIB Manager, click Import
2. Select and open the file didactum.mib
3. WhatsUp Gold processes the file and displays it in the MIB list
4. After import: restart WhatsUp Gold Engine Service (important!)

Step 3 – Restart Engine Service

Windows Server → Services (services.msc)
→ "WhatsUp Gold" service → Restart

Alternatively via command line (as administrator):
net stop "WhatsUp" && net start "WhatsUp"

Important: 

Without restarting the Engine Service, newly imported MIBs are not considered during SNMP polling.

Step 4 – Verify MIB in MIB Walker

Analyze → Tools → SNMP MIB Walker
→ IP address: 192.168.1.50
→ Community: didactum_wug
→ Start OID: .1.3.6.1.4.1.46501
→ Click Walk

If entries with sensor values appear, the MIB is correctly imported and SNMP is working.

An Active Monitor checks whether a specific OID value matches a target value. The device is thereby marked as “Up” or “Down” – ideal for leakage and status sensors.

Navigation

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

Active Monitor: Leakage sensor

Meaning: Value 0 = dry = Up. As soon as the sensor reports value 1 (water detected), the monitor is considered Down and triggers an alarm.

Active Monitor: Temperature sensor status

Meaning: Status 0 = OK = Up. For status 1 (alarm) or 2 (no connection), the monitor is considered Down.

Active Monitor: Temperature threshold (range)

Important: Didactum provides temperature values as raw value × 10. 25.5 °C corresponds to the OID value 255. The thresholds in the monitor must therefore also be entered × 10.

Assign monitor to the device

My Network → Didactum Monitoring System 01 → right-click → Edit Device
→ Active Monitors → Add
→ Select monitor from list → OK → Save

Performance monitors continuously collect measurement values and display them as time-based graphs – ideal for temperature and humidity.

Navigation

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

Performance Monitor: Temperature

Click OK, then assign the monitor to the device:

My Network → Didactum Monitoring System 01 → right-click → Edit Device
→ Performance Monitors → Add → "Didactum Temperature Sensor 01" → OK → Save

Performance Monitor: Humidity

Display graphs

My Network → Didactum Monitoring System 01 → Device Status
→ Tab "Performance" → select sensor → choose time range

The “Extended SNMP Monitor” allows monitoring multiple OIDs simultaneously with individual thresholds – via an XML file that is created once and then imported.

Step 1 – Create XML file

Create the following XML file and save it as didactum_sensors.xml:

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

  <SNMPParameter Name="TemperaturSensor01">
    <ShortDescription>Temperature Sensor 01 (raw value x0.1 = degrees C)</ShortDescription>
    <LongDescription>Digital temperature sensor, 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 degrees C</Units>
  </SNMPParameter>

  <SNMPParameter Name="TemperaturStatus01">
    <ShortDescription>Temp Sensor 01 status (0=OK, 1=Alarm, 2=No signal)</ShortDescription>
    <LongDescription>Status value of the digital temperature sensor</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>Water sensor 01 (0=dry, 1=water detected)</ShortDescription>
    <LongDescription>Leakage sensor, 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>Humidity sensor 01 (value in %)</ShortDescription>
    <LongDescription>Humidity sensor, 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>Door contact 01 (0=closed, 1=open)</ShortDescription>
    <LongDescription>Door contact sensor, 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=closed 1=open</Units>
  </SNMPParameter>

</SNMPParameters>

Step 2 – Copy XML file to WhatsUp Gold directory

Target directory on the WhatsUp Gold server:
C:\\Program Files (x86)\\Ipswitch\\WhatsUp\\Data\\SNMPExtended\\

Place the file there:
didactum_sensors.xml

Step 3 – Create Extended SNMP Monitor

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

1. Enter name: Didactum All Sensors
2. Click Import
3. Select file didactum_sensors.xml from the directory → OK
4. All imported parameters appear in the threshold table
5. Click Configure for each parameter and set thresholds:

WhatsUp Gold can receive SNMP traps that the Didactum device sends automatically in case of an alarm – without polling delay.

Step 1 – Check trap reception in WhatsUp Gold

WhatsUp Gold receives SNMP traps by default on UDP port 162. Check whether the service is listening:

Windows Server → Firewall → Check inbound rule:
UDP port 162 must be open for WhatsUp Gold

Step 2 – Create SNMP trap monitor

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

Alternatively: leave the OID field empty to receive all incoming traps (recommended for initial testing).

Step 3 – Assign trap monitor to the device

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

Step 4 – Check traps in the event log view

Reports → Event Log
→ Filter: Source = 192.168.1.50
→ Incoming traps are displayed here

All Didactum OIDs start with .1.3.6.1.4.1.46501 (older firmware) or .1.3.6.1.4.1.39052 (newer models). The sensor ID is appended at the end.

OID fields per sensor

Sensor types with OIDs

Find sensor ID: 

In the Didactum web interface under System tree → select sensor → Details. This ID is appended to the end of the OID.

MIB prefix per model: 

Older devices use .1.3.6.1.4.1.46501, newer models may use .1.3.6.1.4.1.39052. The exact OIDs can be found in the MIB file of your device.

Temperature raw value in WhatsUp Gold: 

Since WhatsUp Gold has no built-in scaling function for OID values, thresholds must always be entered as raw value × 10. 28 °C = threshold 280.

Step 1 – Open Alert Center

Alerts → Alert Center

Step 2 – Create new alert policy

Alerts → Alert Center → New Policy

Step 3 – Add email notification

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

Step 4 – Configure email server

Settings → Email & SMS Settings → SMTP Settings
→ Enter SMTP server, port, sender address → send test email

Step 5 – Set up escalation (optional)

In the Alert Policy → Escalation
→ "If not acknowledged within 15 minutes → send to: second email address"

Test SNMP connection with MIB Walker

Analyze → Tools → SNMP MIB Walker
→ IP: 192.168.1.50
→ Community: didactum_wug
→ OID: .1.3.6.1.4.1.46501
→ Execute Walk

If values appear, the SNMP connection is working.

Query a single OID value

Analyze → Tools → SNMP MIB Walker
→ Start OID: .1.3.6.1.4.1.46501.5.1.1.7.101001
→ Get (instead of Walk)
→ Displayed value e.g. 235 = 23.5 °C

Error messages and solutions

View WhatsUp Gold logs

Reports → Event Log
→ Filter by device or time range

Windows Event Log:
Event Viewer → Applications → WhatsUp

Didactum device

• SNMP enabled (v2c or v3)
• Community string set (not “public”)
• Trap receiver IP set to WhatsUp Gold server
• Trap port 162 configured
• MIB file downloaded

WhatsUp Gold – basic configuration

• SNMP credential “Didactum SNMPv2” created in the Credentials Library
• Firewall: UDP 161 outbound, UDP 162 inbound open
• MIB file didactum.mib imported (MIB Manager)
• Engine Service restarted after MIB import
• MIB Walker test successful (sensor values visible)
• Didactum device added via discovery or manually
• SNMP credential assigned to the device

Monitors

• Active Monitor for leakage sensor created and assigned
• Active Monitor for temperature sensor status created
• Performance Monitor for temperature trend created
• Performance Monitor for humidity trend created
• Extended SNMP Monitor with XML file imported (optional)
• SNMP trap monitor (Passive Monitor) created and assigned

Alerting

• SMTP settings configured and test email sent
• Alert policy “Didactum Sensor Alarm” created
• Email action configured in the policy
• Test alarm triggered and email received
• Escalation configured (optional)