Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in CA Spectrum (jetzt: Broadcom DX NetOps Spectrum) via SNMP – inklusive Gerät-Discovery, MIB-Import mit MIB Tools, OID-Mapping auf Modell-Attribute, Device Self-Certification, SNMP-Trap-Konfiguration (AlertMap/EventDisp) und Alarmierung.

Produkthinweis: 

CA Spectrum wurde von Broadcom übernommen und heißt nun offiziell DX NetOps Spectrum. Die Funktionalität ist identisch geblieben. Alle hier beschriebenen Schritte gelten für CA Spectrum 10.x sowie DX NetOps Spectrum 23.x/24.x.

• Software: CA Spectrum / DX NetOps Spectrum (Broadcom)
• Komponenten: SpectroSERVER, OneClick Web Console, MIB Tools, Device Certification Manager
• Protokoll: SNMP v1 / v2c / v3
• Geräte: Didactum Monitoring System 100 / 500T / 500 II
• Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch

CA Spectrum Server

• SpectroSERVER installiert und gestartet
• OneClick Web Console erreichbar (Standard: <Server>/oneclick)
• UDP-Port 161 ausgehend für SNMP Polling geöffnet
• UDP-Port 162 eingehend für SNMP Trap-Empfang geöffnet
• Administrator-Zugang zur OneClick Console
• Netzwerkzugang zum Didactum-Gerät

Didactum-Gerät

• Monitoring System 100T, 300T, 500T oder 550T
• SNMP aktiviert (v2c empfohlen)
• Gerät per ICMP (Ping) vom SpectroSERVER erreichbar
• MIB-Datei im Web-Interface verfügbar

Wichtige Spectrum-Pfade (Windows Server)

%SPECROOT%\                             <-- Spectrum Installationsverzeichnis
%SPECROOT%\custom\Events\              <-- Custom Events (AlertMap, EventDisp, EvFormat)
%SPECROOT%\custom\Events\AlertMap      <-- Globale AlertMap-Datei (alle GnSNMPDev)
%SPECROOT%\custom\Events\EventDisp     <-- Globale EventDisp-Datei
%SPECROOT%\MIBTools\                   <-- MIB Tools Verzeichnis
%SPECROOT%\SG-Support\CsClib\          <-- MIB-Datenbank

Typischer SPECROOT-Pfad (Windows): C:\win32app\spectrum\
Typischer SPECROOT-Pfad (Linux): /opt/SPECTRUM/

Spectrum-Architektur für Didactum

[OneClick Web Console]         [Administrator-Browser]
       |                               |
       v                               v
[SpectroSERVER]  -----SNMP Polling UDP 161----->  [Didactum 192.168.1.50]
       ^                                                    |
       |                                                    |
       +-----SNMP Traps UDP 162 <--------------------------+

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)

Spectrum muss den Community String kennen, bevor es ein Gerät per Discovery ansprechen kann.

Navigation in OneClick

OneClick → Administration → SNMP Communities

Neue Community hinzufügen

Auf OK klicken und speichern.

SNMPv3-Profil anlegen (falls verwendet)

OneClick → Administration → SNMP v3 Profiles → New

Variante A – Manuelles Modell anlegen (Create by IP)

OneClick → My Landscape → [Rechtsklick auf Landscape] → Create Model
→ Model Type: "Network Device by IP" oder "Create By Host Name"

Auf OK klicken. Spectrum nimmt Kontakt auf und erstellt ein Modell. Das Gerät erscheint zunächst als Typ GnSNMPDev (Generic SNMP Device), da Spectrum Didactum nicht direkt kennt. Die Zertifizierung erfolgt in Abschnitt 7.

Variante B – Automatischer Discovery-Scan

OneClick → Discovery → New Discovery

Auf Run klicken. Das Didactum-Gerät erscheint nach Abschluss in der Ergebnisliste. Auf Model klicken, um es in den Landscape zu übernehmen.

Schritt 3 – Gerät in OneClick finden

OneClick → Locater → IP Address: 192.168.1.50 → Search

Das Didactum-Gerät erscheint als Modell mit dem Typ GnSNMPDev. Im nächsten Schritt wird die MIB importiert, damit Spectrum das Gerät besser versteht.

MIB Tools ermöglichen das Kompilieren, Importieren und Browsen von Management Information Bases in DX NetOps Spectrum sowie das Anpassen des Mappings von MIB-Objekten und Traps.

Schritt 1 – MIB aus dem Didactum Web-Interface laden

Systemeinstellungen → SNMP → "MIB-Datei herunterladen" → didactum.mib

Schritt 2 – MIB Tools in OneClick öffnen

OneClick → Gerät (didactum-monitor-01) auswählen
→ Tools → Utilities → MIB Tools

Alternativ direkt:

OneClick → Administration → MIB Tools

Schritt 3 – MIB kompilieren und importieren

1. Im Navigation-Panel auf Add MIB klicken
2. Im Dialog auf Browse klicken und die Datei didactum.mib auswählen
3. Auf Compile klicken
4. Im „Compiler"-Bereich des Dialogs erscheinen Meldungen – auf Compilation successful prüfen
5. Auf Add & Close klicken

Die MIB erscheint nun im Navigation-Panel unter dem Hersteller-Pfad enterprises → 46501 (ältere Geräte) oder enterprises → 39052 (neuere Geräte).

Schritt 4 – MIB-Inhalt prüfen

1. Im Navigation-Panel die importierte Didactum-MIB auswählen
2. Reiter Contents öffnen – alle OIDs der MIB werden angezeigt
3. Reiter Trap Support öffnen – alle Trap-Definitionen der MIB werden angezeigt

Schritt 5 – Trap Support aktivieren

Auf „Trap Support" klicken, einen Trap auswählen und auf „Map Traps" klicken. Im Dialog „MIB Tools: Assign Trap Alarms" den Alarm-Schweregrad setzen und auf OK klicken.

MIB Tools → Navigation: Didactum-MIB auswählen
→ Contents → Trap Support
→ Trap auswählen → Map Traps
→ Alarm Severity: Critical setzen → OK

Mit MIB Tools können MIB-OIDs auf Spectrum-Modell-Attribute gemappt werden. Im Navigation-Panel das Gerät auswählen, dann Tools → Utilities → MIB Tools öffnen. Im Navigation-Bereich der MIB die gewünschte OID suchen, Reiter Map öffnen und auf „Create attribute" klicken.

Schritt 1 – Didactum-Gerät in OneClick öffnen

OneClick → Locater → IP: 192.168.1.50 → Gerät öffnen
→ Tools → Utilities → MIB Tools

Schritt 2 – MIB im Navigation-Panel navigieren

MIB Tools Navigation Panel:
→ enterprises
  → 46501 (Didactum)
    → 5 (Sensor-Tabelle)
      → 1
        → 1
          → 7 (sensorValue)
            → 101001 (Sensor-ID Temperatursensor 01)

Schritt 3 – Neues Attribut für Temperatursensor anlegen

1. OID .1.3.6.1.4.1.46501.5.1.1.7.101001 im Navigation-Panel auswählen
2. Reiter Map öffnen
3. Auf Create Attribute klicken (Blatt-Symbol mit +)
4. Spectrum erstellt ein neues Attribut und weist eine Attribut-ID zu
5. Die neue Attribut-ID notieren (z.B. 0x00210001)

Schritt 4 – Weitere OID-Attribute anlegen

Den Vorgang für alle relevanten Didactum-OIDs wiederholen:

Schritt 5 – Attribut am Gerät prüfen

OneClick → Gerät didactum-monitor-01 öffnen
→ Reiter "Attributes" oder "General" → angelegte Attribute suchen
→ Aktuelle Sensorwerte werden hier angezeigt

Da Spectrum Didactum-Geräte nicht nativ kennt, erscheinen sie zunächst als generisches Modell GnSNMPDev. Mit der Device Self-Certification wird das Gerät eindeutig identifiziert und erhält einen eigenen Modelltyp.

Schritt 1 – Device Certification Manager öffnen

OneClick → Gerät didactum-monitor-01 auswählen
→ Tools → Utilities → Device Certification Manager

Schritt 2 – Gerät identifizieren

Im Device Certification Manager:

Schritt 3 – MIBs dem Gerät zuweisen

Im Device Certification Manager:
→ "Add MIB" Button → DIDACTUM-MIB auswählen → Add

Schritt 4 – Zertifizierung speichern

Auf Save klicken. Das Modell wird vom generischen Typ GnSNMPDev in den neuen Typ Didactum Monitoring System umgewandelt. Ein neues Icon kann optional zugewiesen werden.

Schritt 5 – Landscape aktualisieren

OneClick → Administration → Event Configuration → Reload Event Configuration

Nach dem Reload werden alle Didactum-Geräte mit dem neuen Modelltyp angezeigt.

Watches überwachen Attributwerte kontinuierlich und generieren Alarme bei Schwellwertüberschreitung. Sie sind das Äquivalent zu Service-Checks in anderen Monitoring-Systemen.

Schritt 1 – Watch für Temperatursensor anlegen

OneClick → Gerät didactum-monitor-01 öffnen
→ Reiter "Attributes"
→ Attribut "DidactumTemp01" suchen und auswählen
→ Rechtsklick → Create Watch

Auf OK klicken. Zweite Watch für kritische Temperatur anlegen:

Schritt 2 – Watch für Leckagesensor anlegen

Attribut "DidactumLeak01" → Rechtsklick → Create Watch

Schritt 3 – Watch für Luftfeuchtigkeit anlegen

Hinweis zu Temperatur-Rohwerten in Spectrum Watches

Das Didactum-Gerät überträgt Temperaturen als Rohwert × 10. 25,5 °C = OID-Wert 255. Alle Schwellwerte in Spectrum Watches müssen daher ebenfalls × 10 angegeben werden:

Für den Empfang von SNMP-Traps vom Didactum-Gerät müssen in Spectrum drei Konfigurationsdateien angelegt werden: AlertMap (Trap → Event Mapping), EventDisp (Event-Verarbeitung) und EvFormat (Anzeige-Format).

Variante A – Traps über MIB Tools automatisch mappen (empfohlen)

Falls die MIB Trap-Definitionen enthält, kann der Import in Abschnitt 5 (Schritt 5) die AlertMap-Einträge automatisch generieren. Nach dem MIB-Import und Trap-Mapping wird die Konfiguration gespeichert unter:

%SPECROOT%\custom\Events\AlertMap
%SPECROOT%\custom\Events\EventDisp

Variante B – Manuelle AlertMap für Didactum

Schritt 1 – Ordner für Didactum anlegen

%SPECROOT%\custom\Events\Didactum\

Darin zwei Dateien ohne Dateiendung anlegen: AlertMap und EventDisp.

Schritt 2 – AlertMap-Datei erstellen

%SPECROOT%\custom\Events\Didactum\AlertMap

Folgenden Inhalt eintragen:

# ================================================================
# Didactum Monitoring System – AlertMap
# Mappt SNMP Traps auf Spectrum Events
# ================================================================

# Enterprise OID der Didactum-Traps
# Ältere Geräte: .1.3.6.1.4.1.46501
# Neuere Geräte: .1.3.6.1.4.1.39052

# Leckage-Trap: Wasser erkannt (OID .107001)
{ .1.3.6.1.4.1.46501.5.1.1.7.107001 }
{
    { 0x00000001 }   EventID = 0x00f10001;
    VARBIND_FORMAT
    {
        (101, 1) \   # Trap OID
        (102, 2) \   # Sensor-ID
        (103, 3) \   # Sensor-Name
        (104, 4) \   # Sensorwert (0=trocken, 1=Wasser)
    }
}

# Temperatur-Alarm-Trap (OID .101001 Status)
{ .1.3.6.1.4.1.46501.5.1.1.6.101001 }
{
    { 0x00000001 }   EventID = 0x00f10002;
    VARBIND_FORMAT
    {
        (101, 1) \
        (102, 2) \
        (103, 3) \
        (104, 4) \
    }
}

# Rauchmelder-Alarm-Trap (OID .106001)
{ .1.3.6.1.4.1.46501.5.1.1.7.106001 }
{
    { 0x00000001 }   EventID = 0x00f10003;
    VARBIND_FORMAT
    {
        (101, 1) \
        (102, 2) \
        (103, 3) \
        (104, 4) \
    }
}

# Tür-Alarm-Trap (OID .104001)
{ .1.3.6.1.4.1.46501.5.1.1.7.104001 }
{
    { 0x00000001 }   EventID = 0x00f10004;
    VARBIND_FORMAT
    {
        (101, 1) \
        (102, 2) \
        (103, 3) \
        (104, 4) \
    }
}

Schritt 3 – EventDisp-Datei erstellen

%SPECROOT%\custom\Events\Didactum\EventDisp

# ================================================================
# Didactum Monitoring System – EventDisp
# Definiert wie Spectrum Events verarbeitet werden
# A 3 = Alarm, Severity Critical
# A 2 = Alarm, Severity Major
# A 1 = Alarm, Severity Minor
# ================================================================

# Leckage-Event → Critical Alarm
EVENT 0x00f10001 A 3 ,0xfff0006e

# Temperatur-Status-Event → Critical Alarm
EVENT 0x00f10002 A 3 ,0xfff0006e

# Rauchmelder-Event → Critical Alarm
EVENT 0x00f10003 A 3 ,0xfff0006e

# Türkontakt-Event → Major Alarm
EVENT 0x00f10004 A 2 ,0xfff0006e

Schritt 4 – EvFormat-Dateien erstellen (Anzeige-Text)

%SPECROOT%\custom\Events\EvFormat\

Für jedes Event eine eigene Datei anlegen (Name = EventID + „_en_US", keine Dateiendung):

Datei: 00f10001_en_US
Inhalt:
DIDACTUM LECKAGE ALARM: Wasser erkannt an Sensor {101} – Sensorname: {103} – Wert: {104}

Datei: 00f10002_en_US
Inhalt:
DIDACTUM TEMPERATUR ALARM: Sensor {103} meldet Status {104} (1=Alarm, 2=Kein Signal)

Datei: 00f10003_en_US
Inhalt:
DIDACTUM RAUCHMELDER ALARM: Rauch erkannt an Sensor {103}

Datei: 00f10004_en_US
Inhalt:
DIDACTUM TUER ALARM: Tuer geoeffnet – Sensor {103}

Schritt 5 – Event-Konfiguration neu laden

OneClick → Administration → Event Configuration → Reload Event Configuration

Danach erscheinen eingehende Didactum-Traps als korrekt gemappte Alarme in OneClick.

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 und Spectrum Watch-Schwellwerten

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.

Schritt 1 – Alarm in OneClick prüfen

OneClick → Alarms → Alarm Manager
→ Filter: Source = didactum-monitor-01
→ Alarme werden hier nach Watch-Verletzung oder Trap-Empfang angezeigt

Schritt 2 – E-Mail-Benachrichtigung konfigurieren

OneClick → Administration → Alarm Notification Manager → New

Schritt 3 – SMTP-Einstellungen konfigurieren

OneClick → Administration → System Settings → Email Settings
  SMTP Server:    mail.ihredomain.de
  SMTP Port:      587
  From Address:   spectrum@ihredomain.de
  Auth:           Ja (STARTTLS)
  Username:       spectrum@ihredomain.de
  Password:       IhrMailPasswort

Schritt 4 – Benachrichtigung testen

Alarm Notification Manager → Test → Test-Mail wird gesendet

SNMP-Verbindung testen (Kommandozeile)

# Verbindungstest
snmpget -v 2c -c didactum_spectrum 192.168.1.50 sysDescr.0

# Temperaturwert abfragen (Rohwert ÷ 10 = Grad Celsius)
snmpget -v 2c -c didactum_spectrum 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

# Alle Sensoren auflisten
snmpwalk -v 2c -c didactum_spectrum 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1

SNMP-Test über MIB Tools in OneClick

OneClick → Gerät auswählen → Tools → Utilities → MIB Tools
→ OID eingeben: .1.3.6.1.4.1.46501.5.1.1.7.101001
→ Host: 192.168.1.50
→ "Get" oder "Walk" ausführen
→ Ergebnis im rechten Panel

Fehlermeldungen und Lösungen

Spectrum Logs einsehen

# SpectroSERVER Log (Windows)
%SPECROOT%\logs\SpectroSERVER.log

# OneClick Log
%SPECROOT%\logs\OneClick.log

# SNMP-Trap-Log
%SPECROOT%\logs\SpectroSERVER-TRAP.log

# Event-Konfiguration neu laden nach Änderungen an AlertMap/EventDisp:
OneClick → Administration → Event Configuration → Reload Event Configuration

Didactum-Gerät

• SNMP aktiviert (v2c oder v3)
• Community String gesetzt (nicht „public"): didactum_spectrum
• Gerät per Ping vom SpectroSERVER erreichbar
• Trap-Empfänger-IP auf SpectroSERVER gesetzt
• MIB-Datei heruntergeladen

CA Spectrum – Grundkonfiguration

• SNMP Community didactum_spectrum in Spectrum eingetragen
• UDP 161 ausgehend, UDP 162 eingehend geöffnet
• Didactum-Gerät per Discovery oder manuell als Modell angelegt
• MIB-Datei mit MIB Tools erfolgreich kompiliert und importiert
• Trap Support in MIB Tools aktiviert und Severity gesetzt

OID-Mapping & Zertifizierung

• OID-Attribute für alle Sensortypen in MIB Tools angelegt
• Attribut-IDs notiert und am Gerät in OneClick sichtbar
• Device Self-Certification: GnSNMPDev → Didactum Monitoring System
• Event-Konfiguration neu geladen

Watches & Alarme

• Watch für Temperatur (Warn: 280, Krit: 350) angelegt
• Watch für Leckage (>= 1 = Critical) angelegt
• Watch für Luftfeuchtigkeit angelegt
• AlertMap für Didactum-Traps erstellt
• EventDisp und EvFormat-Dateien erstellt
• Event-Konfiguration nach AlertMap-Änderung neu geladen

Benachrichtigung & Test

• SMTP-Einstellungen in Spectrum konfiguriert
• Alarm Notification Manager-Regel angelegt
• Test-Alarm ausgelöst und E-Mail empfangen
• Eingehende Traps im OneClick Alarm Manager sichtbar