Didactum Monitoring System 50T biedt schaalbare IT- en gebouwbewaking met realtime meldingen, SNMP en webinterface.
Didactum Monitoring-Systemen
SNMP-Configuratie & MIB-Referentie
Volledige handleiding voor het bewaken en besturen van uw Didactum-apparaat via SNMP: Agent activeren, sensoren uitlezen, logica & traps instellen, relais schakelen.
Inhoudsopgave
- Inleiding: Wat is SNMP?
- Overzicht: Architectuur & MIB-structuur
- SNMP-Agent activeren & MIB-bestand
- Systeemelementen in vogelvlucht
- Logica (automatische besturing)
- Discrete sensoren
- Werking (Agent & Sub-Agent)
- Analoge sensoren
- Instellingen opslaan (Flash)
- Trap-meldingen
- Relais & uitgangen (SNMP)
- SNMP-instellingsvoorbeelden
Inleiding: Wat is SNMP?
▼SNMP (Simple Network Management Protocol) is een protocol op de toepassingslaag voor het beheren van apparaten in TCP/IP-netwerken. Het draait gewoonlijk over UDP op de transportlaag en wordt al jaren sectoroverstijgend gebruikt voor centrale bewaking van infrastructuur.
Elke Didactum-bewakingseenheid beschikt over een geïntegreerde SNMP-agent en kan daardoor worden bestuurd en uitgelezen door een overkoepelende netwerkmanagement-station (de zogenaamde “Manager”).
De SNMP-agent in de Didactum-apparaten is compatibel met het beheerde objectmodel MIB-II (RFC 1213). De Management Information Base (MIB) – het model van het object dat in het netwerkbeheer wordt beheerd – is volgens de ASN.1-standaard gedefinieerd.
Didactum-apparaten ondersteunen bovendien Trap Protocol Data Units (PDU). Een Trap-PDU is een melding die het apparaat naar de netwerkmanagement-station stuurt zodra zich tijdens het bedrijf relevante toestanden wijzigen. Nadat de station de Trap heeft ontvangen, kan deze een terugvraag naar het apparaat sturen om de precieze oorzaak van de melding vast te stellen.
Opbouw van dit handboek
De volgende hoofdstukken leiden u stap voor stap door de activering van SNMP, de structuur van de MIB-database en de evaluatie en besturing van sensoren, relais, logicaschakelingen en traps op uw Didactum-eenheid.
Overzicht: Architectuur & MIB-structuur
▼Versies
| Component | Versie |
|---|---|
| SNMP-Agent | Net-SNMP vanaf versie 5.7.1 |
| Didactum-Sub-Agent | Software vanaf versie 2.0.2 |
Compatibiliteit
Actuele Didactum-apparaten ondersteunen SNMP in de versies 1, 2c en 3.
De MIB-database
Alle details van het bewakingssysteem bevinden zich in de MIB-tak .iso.org.dod.internet.private.enterprises.didactum met de OID .1.3.6.1.4.1.39052.
Didactum. Dit is normaal en heeft geen invloed op functie of support.Het MIB-bestand kan via de webinterface van elke Didactum-eenheid worden gedownload: Webinterface → Instellingen → SNMP → “MIB-bestand downloaden”.
Beschikbare tabellen in de MIB-boom
| MIB-tak | Inhoudende tabellen |
|---|---|
| ctlUnit Systeem-eenheid | ctlUnitModulesTable – Systeemmodules · ctlUnitGroupsTable – Groepen · ctlUnitElementsTable – alle elementen · ctlUnitLogicsTable – Logicaschakelingen · ctlUnitTrapNotification – Trap-melding · ctlUnitSaveToFlash – Opslaan in Flash-geheugen |
| ctlNotifiers Meldingen | ctlNotifiersMailersTable – E-mail · ctlNotifiersTrapsTable – SNMP-Traps · ctlNotifiersSMSsTable – SMS |
| ctlVirtualDevices Virtuele apparaten | ctlVirtualDevicesTimersTable – Timer · ctlVirtualDevicesPingsTable – Ping-sensoren · ctlVirtualDevicesTriggersTable – Trigger · ctlVirtualDevicesSnmpgetsTable – virtuele SNMP-Get-sensoren |
| ctlHardwareDevices Hardware-apparaten | ctlHardwareDevicesCamerasTable – USB- en IP-camera’s |
| ctlInternalSensors interne sensoren | ctlInternalSensorsDiscretsTable – discrete sensoren · ctlInternalSensorsAnalogsTable – analoge sensoren · ctlInternalSensorsOutletsTable – Relais/Uitgangen |
| ctlCANSensors CAN-Bus-sensoren | ctlCANSensorsDiscretsTable · ctlCANSensorsAnalogsTable · ctlCANSensorsOutletsTable |
| ctlRsSensors Sensoren aan de seriële interface | ctlRsSensorsDiscretsTable · ctlRsSensorsAnalogsTable · ctlRsSensorsOutletsTable |
SNMP-Agent activeren & MIB-bestand
▼Communities instellen
De SNMP-Community-instellingen vindt u in de webinterface onder Instellingen → SNMP, in de velden „Community voor SNMP (alleen lezen)" en „Community voor SNMP (schrijven)".
MIB-bestand downloaden
Het MIB-bestand is eveneens beschikbaar onder Instellingen → SNMP via de link „MIB-bestand downloaden".
🔍 Vergrößern
Overzicht van de velden „Community voor lezen/schrijven", de link voor het downloaden van het MIB-bestand en de checkbox voor het activeren van SNMP – alles centraal onder Instellingen → SNMP.
SNMP-Agent activeren (Versies & Beveiliging)
Actuele Didactum-apparaten ondersteunen SNMP-versie 1, 2c en 3. Voor SNMP-versie 3 zijn extra, uitgebreide beveiligingsinstellingen beschikbaar.
~!@#$%^&()_=*-+{}[]:;<>"|/| Versie | Optie | Waarde / Opmerking |
|---|---|---|
| v1 / v2c | Community voor lezen | public (standaard) |
| Community voor schrijven | private (standaard) | |
| v3 | USM-gebruiker | vrij te kiezen |
| Beveiligingsniveau | „Geen Auth, geen Priv" / „Auth, geen Priv" / „Auth, Priv" | |
| Authenticatie-algoritme | MD5 of SHA (alleen bij „Auth") | |
| Authenticatie-wachtwoord | min. 8 tekens | |
| Versleutelingsalgoritme | DES of AES (alleen bij „Priv") | |
| Versleutelings-wachtwoord | min. 8 tekens |
SNMP op het apparaat activeren
- Open de webinterface van uw Didactum-eenheid.
- Navigeer naar het hoofdmenu Instellingen → SNMP.
- Zet een vinkje bij de optie „SNMP activeren".
- Kies de gewenste SNMP-versie (v1/v2c of v3) en vul de bijbehorende toegangsgegevens in.
- Klik op „Opslaan".
🔍 Vergrößern
Na het zetten van het vinkje bij „SNMP activeren" en de keuze van de juiste versie zijn alle SNMP-functies van het apparaat direct na het opslaan beschikbaar.
Verbinding met de MIB-bestandsmanager controleren
Voorbeeld: Zo controleert u of het MIB-bestand correct is ingebouwd:
Systeemelementen in vogelvlucht
▼Het bewakingssysteem van een Didactum-eenheid kan de volgende elementtypen bevatten:
- Analoge sensoren
- Discrete sensoren
- Virtuele sensoren (elementen)
- Meldingen
- Systeem-eenheden
Alle beschikbare elementen van het systeem zijn samengevat in de tabel ctlAllElementsTable.
Voorbeeld: Beschikbare systeemelementen uitlezen
Voorbeeld: Meetwaarde van een element ophalen (ID = 201002)
7 in de OID staat voor de tabelkolom waaraan de sensorwaarde is gekoppeld; 201002 is de unieke sensor-ID.Voorbeeld: Naam van een element wijzigen (ID = 102003)
Logica (automatische besturing)
▼Logica is het mechanisme voor de automatische besturing van uw Didactum-eenheid: Het koppelt sensorstatussen aan acties zoals het schakelen van een relais of het activeren van een trap.
Syntax van de logicabeschrijving
Een logica wordt beschreven met de volgende tekenreeks:
| Parameter | Betekenis |
|---|---|
SENSORID | Unieke ID van de triggerende sensor |
OLDSTATE-NEWSTATE | Toestandscodes waarbij de overgang de voorwaarde vervult (beide waarden identiek) |
OPERATOR | Verbindingscode van meerdere voorwaarden |
SENSORID1 | ID van het element (bijv. relais) waarvan de toestand moet worden gewijzigd |
TIMEOUT | Vertraging in seconden voordat de actie wordt uitgevoerd |
NEWSTATE2 | Doeltoestand van het element |
OPERATOR2 | Symbol „+" |
Toestandscodes
| Toestand | Code |
|---|---|
| normal | 1 |
| low | 2 |
| warning | 3 |
| alarm | 4 |
| on | 5 |
| off | 6 |
| not connected | 7 |
| pulse | 8 |
Operator-codes
| Operator | Symbol |
|---|---|
| EN (and) | + |
| OF (or) | | |
Logica beheren
- Een nieuwe logica wordt aangemaakt via het veld
ctlLogicRowStatus: Zet dit op de toestandCreateAndWait(5)om een nieuwe invoer inctlLogicsTablete maken. - Geef daarna een naam op in het veld
ctlLogicNameen de logicabeschrijving in het veldctlLogicDescription. - Na het invoeren van de beschrijving wordt de logica actief – herkenbaar aan de waarde
active(1)in het veldctlLogicRowStatus. - Voor tijdelijk deactiveren zet u
ctlLogicDisableop het gewenste interval in seconden, voor reactiveren op0. - Om te verwijderen zet u
ctlLogicRowStatusop de toestanddestroy(6).
Voorbeeld: Logica aanmaken, controleren, deactiveren en verwijderen
Discrete sensoren
▼Sensoren met discrete uitgang van uw Didactum-eenheid zijn afhankelijk van de fysieke aansluiting opgeslagen in de volgende sub-takken:
ctlInternalSensors– interne hoofdsensoren →ctlInternalSensorsDiscretsTablectlCANSensors– sensoren op de CAN-bus →ctlCANSensorsDiscretsTablectlRsSensors– sensoren aan de seriële interface →ctlRsSensorsDiscretsTable
Voorbeeld: Discrete sensoren uitlezen
De positie van een sensor in het systeem blijkt uit de Module-ID (Module) waarin hij fysiek is ingebouwd, en het poortnummer op het module (Num).
Mogelijke toestanden
| Toestand | Betekenis |
|---|---|
normal | Sensor meldt geen alarm |
alarm | Sensor is geactiveerd |
not connected | Sensor niet aangesloten |
De gemeten ruwe waarden staan in het veld Value en kunnen de waarde 1 of 0 aannemen. Indien gewenst kan de logica worden omgekeerd door het veld Reverse op 1 te zetten (standaard: 0).
Voorbeeld: Inversie van een sensor instellen (ID = 101004)
Rookmelder resetten
Voor rookmelders op de CAN-bus (sensor-model VT460) is een reset van de alarmtoestand via SNMP-SET beschikbaar: Schrijf de stringwaarde reset smoke (zonder aanhalingstekens) naar de OID .1.3.6.1.4.1.39052.6.1.1.11 (ctlCANSensorsDiscretSpecific) met de betreffende sensor-ID.
Werking (Agent & Sub-Agent)
▼Bij het opstarten van een Didactum-eenheid wordt eerst de SNMP-agent gestart, gevolgd door de sub-agent die de apparaatspecifieke functionaliteit levert.
Na het starten en de verbinding tussen agent en sub-agent verwerkt de agent binnenkomende verzoeken van de netwerkmanagement-station (Manager) – zogenaamde SNMP PDUs (Protocol Data Units) zoals Get-PDU, GetNext-PDU of Set-PDU – en genereert een overeenkomstig antwoord respectievelijk een Trap-PDU.
Trap-PDUs worden in het bewakingssysteem dynamisch bepaald: De Logica koppelt daarbij trap-berichten aan concrete systeemgebeurtenissen.
Analoge sensoren
▼Analoge sensoren van de Didactum-apparaten beschikken over analoge ingangen evenals analoge of discrete uitgangen. Als een analoge sensor niet is aangesloten of niet is gedefinieerd, bevindt hij zich in de toestand „not connected".
Ook analoge sensoren zijn, afhankelijk van de fysieke aansluiting, opgeslagen in de volgende sub-takken:
ctlInternalSensors→ctlInternalSensorsAnalogsTablectlCANSensors→ctlCANSensorsAnalogsTablectlRsSensors→ctlRsSensorsAnalogsTable
Voorbeeld: Analoge sensoren uitlezen
De positie van een sensor in het systeem blijkt ook hier uit de Module-ID (Module) en de poortnummer op het module (Num).
Mogelijke toestanden & drempelwaarden
Een sensor met analoge uitgang kan afhankelijk van de drempelwaarden ctlAnalogLowAlarm, ctlAnalogLowWarning, ctlAnalogHighWarning en ctlAnalogHighAlarm de volgende toestanden aannemen:
| Toestand | Betekenis |
|---|---|
normal | Meetwaarde ligt boven „Low", maar onder „Warning"/„Alarm" |
low alarm | Meetwaarde ligt onder de drempelwaarde „LowAlarm" |
low warning | Meetwaarde ligt boven „LowAlarm", maar onder „LowWarning" |
high warning | Meetwaarde ligt boven „HighWarning", maar onder „HighAlarm" |
high alarm | Meetwaarde ligt boven de drempelwaarde „HighAlarm" |
Omrekening bij spanningsensoren
De velden ctlAnalogAT0 (standaard „1.0") en ctlAnalogAT75 (standaard „0.0") gelden uitsluitend voor spanningsensoren en bepalen de coëfficiënten voor de omrekening van de meetwaarde volgens de volgende formule:
Omrekening bij stroomsensoren (4–20 mA)
Het veld ctlAnalogExpression (standaard „x") geldt uitsluitend voor stroomsensoren en bepaalt de uitdrukking voor de omrekening van de meetwaarde:
Met de standaardinstelling komt de weergegeven waarde exact overeen met de ongewijzigde meetwaarde. Ondersteund worden de operatoren + − / * % (Modulo) en ^ (macht) evenals de volgende functies:
| Functie | Betekenis |
|---|---|
abs | Absoluutwaarde |
sqrt | Kwadraatwortel |
exp | Exponentiële functie |
ln | Natuurlijke logaritme |
log | Logaritme |
sin / cos / tan | Trigonometrische functies |
asin / acos / atan | Arkusfuncties |
Voorbeeld: Drempelwaarden instellen (Element-ID = 22)
Instellingen opslaan (Flash)
▼In elke Didactum-eenheid wordt een NAND-Flash-geheugen gebruikt als herschrijfbare systeemmgeheugen. Dit geheugen heeft slechts een beperkt aantal schrijfcycli – sensoreinstelligen die tijdens het bedrijf worden gewijzigd, moeten daarom expliciet door de gebruiker in het Flash-geheugen worden overgenomen.
Voor het opslaan van de sensoreinstelligen via SNMP dient de speciale bron ctlUnitSaveToFlash. Wanneer hier een willekeurige waarde ongelijk aan „0" wordt gezet, worden de actuele instellingen in het Flash-geheugen opgeslagen.
ctlUnitSaveToFlash automatisch terug naar 0. Anders levert het veld een foutcode die de oorzaak van de opslagfout aangeeft.Voorbeeld: Instellingen in het Flash-geheugen beveiligen
Trap-meldingen
▼Een Trap is een meldingelement dat een Trap-bericht (Trap-PDU) van het bewakingssysteem (Agent) van uw Didactum-eenheid naar de netwerkmanagement-station (SNMP-Manager) stuurt. Ondersteund worden SNMP-Trap-berichten van de versies 1, 2c en 3.
Traps beheren
Trap-elementen kunnen uitsluitend via de webinterface worden aangemaakt, geconfigureerd en verwijderd – een beheer puur via SNMP is hiervoor niet voorzien.
Opbouw van de Trap-melding
Bij het verzenden van een Trap-bericht wordt automatisch een beschrijvingsregel gegenereerd, bijvoorbeeld:
Hierbij staat trap_1 voor de naam en 602001 voor de unieke ID van het Trap-element. De naam kan worden gewijzigd via de tabel ctlNotifiersTrapsTable of direct in de webinterface.
Doorgegeven variabelen in het bericht
| Variabele | Beschrijving |
|---|---|
.1 | Beschrijving van de geactiveerde logicschakeling |
.2 | Meetwaarden van de sensoren in de logicschakeling |
.3 | Reactietijd van de logicschakeling |
.4 | Naam van de logicschakeling |
.5 | Naam van de sensor waarvan de toestand de logica heeft geactiveerd |
.6 | Toestand van de triggerende sensor |
.7 | Gemeten waarde respectievelijk logicaniveau |
.8 | ID van de triggerende sensor |
.20 | ID van de SNMP-Trap |
.21 | Naam van de SNMP-Trap |
Relais & uitgangen (SNMP)
▼De uitgangselementen (Relais/Uitgangen) van uw Didactum-eenheid zijn afhankelijk van de fysieke aansluiting opgeslagen in de volgende sub-takken:
ctlInternalSensors→ctlInternalSensorsOutletsTablectlCANSensors→ctlCANSensorsOutletsTablectlRsSensors→ctlRsSensorsOutletsTable
Voorbeeld: Beschikbare uitgangen uitlezen
De positie van een uitgang in het systeem blijkt ook hier uit de Module-ID (Module) en de poortnummer op het module (Num).
Mogelijke toestanden
| Toestand | Betekenis |
|---|---|
on | ingeschakeld |
off | uitgeschakeld |
pulse | Impulsschakeling voor een vastgestelde duur |
De starttoestand na het opstarten wordt in het veld Initial vastgelegd. De besturing zelf vindt plaats via het veld Value; de impulstijd in seconden wordt in het veld Pulse gedefinieerd.
Voorbeeld: 5-seconden-impuls op relais sturen (ID = 102003)
SNMP-instellingsvoorbeelden
▼Dit hoofdstuk toont aan de hand van een typische MIB-browser hoe u uw Didactum-eenheid in enkele stappen via SNMP kunt aansluiten.
Stap 1 – MIB-bestand downloaden
Het MIB-bestand is beschikbaar in de webinterface onder Instellingen → SNMP → „MIB-bestand downloaden".
🔍 Vergrößern
Download het bestand en importeer het daarna in uw voorkeur SNMP-manager of MIB-browser.
Stap 2 – MIB-bestand in de manager laden
- Laad het gedownloade MIB-bestand in uw SNMP-manager of MIB-browser.
- Vul dezelfde Community-namen voor lezen en schrijven in die u eerder op de Didactum-eenheid hebt ingesteld.
- Leg het juiste IP-adres, de poort en de SNMP-versie van de eenheid vast in de manager (bij SNMP v3 bovendien de toegangswachtwoorden).
- Controleer de verbinding en lees testgewijs de inhoud van de sensor- en elementvelden uit.
Stap 3 – Boom van de sensorwaarden in de MIB-browser
🔍 Vergrößern
Zo presenteert zich de tak van de analoge sensorwaarden in een typische MIB-browser nadat de Didactum-MIB-bestand is geïmporteerd.
OID-voorbeelden voor directe toegang
Wilt u een specifiek sensorveld direct uitlezen, hang dan eenvoudig de betreffende sensor-ID aan de juiste basis-OID:
.1.3.6.1.4.1.39052.5.2.1.7.201001– Meetwaarde van de analoge temperatuursensor met ID 201001.1.3.6.1.4.1.39052.5.2.1.5.201001– Toegekende naam van dezelfde temperatuursensor.1.3.6.1.4.1.39052.5.1.1.7.101003– Waarde van de discrete droge-kontakt-ingang met ID 101003.1.3.6.1.4.1.39052.5.1.1.5.101003– Toegekende naam van dezelfde droge-kontakt-ingang