Interne Datenpunkte

Der Kontrolldatenpunkttyp für den SNMP Manager (= SNMP Treiber).

Der Name des Datenpunkts setzt sich zusammen aus der Treibernummer und dem im Config-File angegebenen Namen. Im Standardfall ist dies ”_1_SNMPManager”

Die Elemente dieses Datenpunkts dienen zur Kommunikation mit der SNMP Treiberschicht und geben auch Rückmeldung über den Zustand des Treibers.

Dieses Feld zeigt an, wenn ein sog. Generic trap verschickt wurde. Als Möglichkeiten stehen zur Auswahl

• Coldstart
• Warmstart
• LinkUp
• LinkDown
• AuthenticationFailure
• EgpNeighborLoss

Die jeweilige Bedeutung dieser Begriffe sind der RFC 3418 (SNMP v2) zu entnehmen.

Dieses Element enthält die Werte der Payload-Elemente.

Um Octet Strings zu behandeln, welche nicht druckbare Zeichen beinhalten, kann der Config Eintrag [snmpdrv] trapPayloadOctetStringHex aktiviert werden.

Dieses Element liefert Informationen bezüglich "homeless" Traps.

Die Meldung wird im folgendem Format gespeichert:

<Agent Name>|<AgentId>|<SNMP Datentyp als String>(<SNMP Datentyp als Integer Wert>)|<OID>|<agent IP>

Beispiel

• Sollte der Agent, der das Trap versendet, nicht konfiguriert worden sein, kommt es zu folgender Ausgabe:

  ?|?|INT32 (2)|1.3.6.1.4.1.8691.10.2242.11.6|192.168.152.25

  Ein Trap wurde erhalten von einem Gerät mit der IP 192.168.152.25. Da der Agent und die ID nicht bekannt sind wurden sie durch ein "?" ersetzt.

• Sollte der Agent konfiguriert sein, jedoch die OID unbekannt, so erfolgt folgende Ausgabe:

  _1_SNMPAgent_6|6|INT32 (2)|1.3.6.1.4.1.12148.9.1.10.0|192.168.152.18

  Ein Trap wurde Agent _1_SNMPAgent_6 mit der IP 192.168.152.18 erhalten. DIe OID1.3.6.1.4.1.12148.9.1.10. ist jedoch für das WinCC OA System unbekannt.

Der SNMP Agent Datenpunkttyp bildet die Parametrierung für einen anzusprechenden Agent ab. Die Datenpunktnamen setzen sich aus der Treibernummer, dem String aus dem Configfile und der Agentnummer zusammen. Die Agentnummer ist eine frei wählbare Zahl von 1 bis maxAgents. Im Normalfall heißt ein Datenpunkt dann z.B.: ”_1_SNMPAgent_5”.

Zusätzlich muss ein Datenpunkt mit der Bezeichnung ”_SNMPAgent” existieren. Ist dies nicht der Fall, so muss der Config-Eintrag ”agentDPTemplate” geändert werden.

• bit0: Redundanzumschaltung bei Timeout, d.h. wenn bei einem Read- oder Write-Request der TIMEOUT Status zurückgeliefert wird
• bit1: Redundanzumschaltung bei keepAlive-Fehler (KeepAlive-Überprüfung schlägt fehl)
• bit2: Treiber verwendet getBulk-Requests statt einzelner getNext-Requests.
• bit3: Die Verbindung wird bei Auftreten eines USM-Fehlers (Fehlercode ≤ 100) beendet.
• bit4: Die Verbindung wird bei Auftreten eines User-USM-Fehlers (Fehlercode > 100) beendet.
• bit5: Es wird eine Alive-Abfrage bei Änderung der Konfiguration durchgeführt.
• bit6: Legt fest ob ein Octet-String innerhalb des Browse Ergebnisses im hexadezimalen Format (=1) oder als sichbtarer String (=0; default) angezeigt werden soll.

Wenn ein Protokollfehler auftritt, so wird an diesem Datenpunkt die entsprechende OID angezeigt. Da hier ein DynText vorliegt, werden immer alle aktuellen nicht verfügbaren OIDs angezeigt. Des Weiterem werden auch die entsprechenden Invalid-Bits bei den WinCC OA Elementen gesetzt.

Format:

errorcode#OID - ERROR: errortext

Die möglichen Fehlercodes sind:

OID Fehler

• 2//!< No such VB name, see error index
• 3 //!< Bad Vb
• 6 //!< No access to MIBs data
• 7 //!< Requested type was incorrect
• 8 //!< Request Pdu has inccorect length
• 9 //!< Request Pdu has wrong encoding
• 10 //!< Request Pdu has wrong value
• 11 //!< Unable to create object specified
• 12 //!< Inconsistent value in request
• 13 //!< Resources unavailable
• 14 //!< Unable to comit
• 15 //!< Unable to undo
• 16 //!< Authorization error
• 17 //!< Mib Object not writeable
• 18 //!< Inconsistent naming used

Protokollfehler

• -5 //!< outstanding request timed out
• -8 //!< snmp::destroyed with oustanding reqs pending

Transportfehler

• -20 //!< transport unsupported
• -21 //!< transport in use
• -22 //!< transport operation failed
• -23 //!< transport missing rights

Das Datenpunktelement zeigt den Verbindungsstatus des SNMP Agents an.

Folgendes gilt für jeden Agent, welcher für einen SNMP Manager konfiguriert wurde:

• Beim Start des Managers wird der Wert des ConnState Flags auf FALSE gesetzt.

• Das Konfigurieren der ersten Peripherieadresse für einen Agent löst einen Alive-Check aus und der Wert des DPE wird auf TRUE gesetzt, sollte der konfigurierte Agent verfügbar sein. Anschließend wird der Wert bei jedem weiteren Alive-Check aktualisiert.

• Um diesen ersten Alive-Check auszulösen, muss die Peripherieadresse aktiv geschalten werden.

Das Datenpunktelement enthält die Antwort auf den Schreibversuch des SNMP Agents. Hierbei werden folgende Information hinterlegt:

<Fehlercode>#<interne Agent-ID>_<OID> [ -error: <Fehlerbeschreibung>].

Beispiel für das erfolgreiche Schreiben durch den Treiber:

0#1_1.3.6.1.4.1.8691.10.2242.10.1.1.4.11

Beispiel für ein fehlerhaftes Schreiben durch den Treiber:

-5#1_1.3.6.1.4.1.8691.10.2242.10.1.1.4.11 - error: SNMP++: SNMP request timed out

Die entsprechenden Fehlercodes entnehmen Sie der Beschreibung des DPE Elementes Status.ErrorOID.

Zeigt das aktive Target an, mit dem der Treiber gerade kommuniziert.

• 0: erster Agent
• 1: zweiter Agent

Über dieses Element können zwei Kommandos an die lokale Agent-Repräsentation abgeschickt werden:

• Clearerror(1) löscht den ErrorOID Datenpunkt und auch alle internen Errors.
• Checkerror(2)aktualisiert den ErrorOID Datenpunkt und das QueueLength Element

Definiert die Start-OID für die Abfrage aller Daten des Agents. Diese werden dann auf das DPE Browse.Result geschrieben.

Wenn dieses DPE leer gelassen wird, wird die Abfrage mit der Start-OID "1.3.6.1" gestartet.

Es ist auch möglich, per dpSet auf dieses Datenpunktelement mehrere Browsing-Requests anzustoßen. Die Requests kommen der Reihe nach in eine Abarbeitungsliste und werden anschließend in der selben Reihenfolge abgearbeitet.

Grundsätzlich gibt es kein Limit für Browsing-Requests. Ein Browsing-Request wird jedoch verworfen, wenn sich bereits ein identischer Request in der Abarbeitungsliste befindet.

Jeder Browsing-Request wird durch den String identifiziert (siehe DPE "Browse.RequestId"), der auf dieses Datenpunktelement geschrieben wurde. Folgende Requests sind unterschiedlich und würden somit gleichzeitig zur Liste hinzugefügt:

• “1.3.6.1.2.1.1”
• “1.3.6.1.2.1.1:7”
• “1.3.6.1.2.1.1:3”
• “1.3.6.1.2.1”
• “1.3.6.1.2.1.2”

In diesem DPE wird das Ergebnis der Abfrage, welche mittels Browse.Start gestartet wurde, ausgegeben. Während des Browsens steht in diesem DPE "1 - started browsing".

Nachdem das Browsen erfolgreich durchgeführt wurde, enthält das Ergebnis die Daten des Agents. Ein Datensatz setzt sich immer aus 3 Zeilen zusammen:

• 1. Zeile: OID
• 2. Zeile: Wert in einer default Transformation
• 3. Zeile: Datentyp als Zahl#Datentyp als Text

Beispiel mit zwei Datensätzen:

1.3.6.1.2.1.1.1.0
Hardware: x86 Family 6 Model 15 Stepping 8 AT/AT COMPATIBLE
4#OCTETS
1.3.6.1.2.1.1.3.0
0:00:26.60
67#TIMETICKS

Mögliche Werte für den Datentyp:

• 2 - INT32
• 3 - BITS
• 4 - OCTETS
• 6 - OID
• 64 - IPADDR
• 65 - CNTR32
• 66 - UINT32
• 67 - TIMETICKS
• 68 - OPAQUE
• 70 - CNTR64

Enthält das Ergebnis keine durch 3 teilbare Anzahl an Einträgen, so handelt es sich um eine Statusmeldung. In diesem Fall steht in der ersten Zeile ein Statuscode:

1 - Abfrage gestartet
-1 - Fehler

Fehlercode und Beschreibung sind in der zweiten Zeile enthalten.

Zum Beispiel:

-1
-5#SNMP++: SNMP request timed out

Zeigt den Verbindungsstatus des redundanten Agents. Beim Start des Managers wird dieses Datenpunktelement auf FALSE gesetzt. Erst nach der ersten erfolgreich empfangenen Nachricht wird der Status auf TRUE gesetzt

Wird gesetzt wenn mit dem Agent während der mit agentConnectTimeout konfigurierten Zeitspanne keine Nachrichten ausgetauscht wurden.

Wird keine IP-Adresse definiert oder wurde die Adresse gelöscht (Leerstring), so wird dieses Element unabhängig vom aktuellen Status auf FALSE gesetzt und eine Redundanzumschaltung ist nicht möglich.

Über dieses Element können Kommandos an den Treiber-Layer geschickt werden. Dieses Element dient zu Testzwecken.

• Alive query (1) wird an alle verbundenen Targets gesendet

Das SecurityLevel beschreibt, welche Sicherungsmaßnahmen beim Datenaustausch zu ergreifen sind.

• noAuthNoPriv (1) keine Authetifizierung und keine Verschlüsselung
• authNoPriv (2) Authentifizierung, aber keine Verschlüsselung
• authPriv (3) Authentifizierung und Datenverschlüsselung

Defaultwert ist (1).

Der anzusprechende Kontextname auf dem Zielrechner. Der Context beinhaltet bestimmte MIB-Objekte.

Pro Agent kann nur ein Contextname angegeben werden. Sollen auf einem Agent mehrere Context-Bereiche abgefragt werden, so müssen mehrere Datenpunkte angelegt werden.

Für die Authentifizierung der SNMP User stehen zwei Protokolle zur Verfügung.

• none (1) kein Authentifizierungsprotokoll
• HMAC_MD5 (2) MD5 Authentifizierung
• HMAC_SHA (3) SHA Authentifizierung
• HMAC_SHA2_224 (4) SHA2 Authentifizierung
• HMAC_SHA2_256 (5) SHA2 Authentifizierung
• HMAC_SHA2_384 (6) SHA2 Authentifizierung
• HMAC_SHA2_512 (7) SHA2 Authentifizierung

Defaultwert ist (1).

Die verschickten Daten können zur Erhöhung der Sicherheit auch verschlüsselt werden. Für diese Verschlüsselung muss ein Protokoll ausgewählt werden.

• none (1) keine Verschlüsselung
• DES (2) DES Verschlüsselung (Data Encryption Standard)
• IDEA (9) IDEA-Verschlüsselung (International Data Encryption Algorithm)
• AES128 (4) Advanced Encryption Standard Verschlüsselung mit 128 bit Schlüssel
• AES192 (20) Advanced Encryption Standard Verschlüsselung mit 192 bit Schlüssel
• AES256 (21) Advanced Encryption Standard Verschlüsselung mit 256 bit Schlüssel

Default ist (1).

• bit0: Redundanzumschaltung bei Timeout, d.h. wenn bei einem Read- oder Write-Request der TIMEOUT Status zurückgeliefert wird
• bit1: Redundanzumschaltung bei keepAlive-Fehler (KeepAlive-Überprüfung schlägt fehl)
• bit2: Treiber verwendet getBulk-Requests statt einzelner getNext-Requests.
• bit3: Die Verbindung wird bei Auftreten eines USM-Fehlers (Fehlercode ≤ 100) beendet.
• bit4: Die Verbindung wird bei Auftreten eines User-USM-Fehlers (Fehlercode > 100) beendet.
• bit5: Es wird eine Alive-Abfrage bei Änderung der Konfiguration durchgeführt.
• bit6: Legt fest ob ein Octet-String innerhalb des Browse Ergebnisses im hexadezimalen Format (=1) oder als sichbtarer String (=0; default) angezeigt werden soll.

Zeigt das aktive Target an, mit dem der Treiber gerade kommuniziert.

• 0: erster Agent
• 1: zweiter Agent

Letzte Nummer der OID (Object identifier = Objektbezeichner). Diese Nummer wird zu den OID-Notifikation, die im WinCC OA MIB definiert ist, hinzugefügt. Wenn dieser DPE modifiziert wird, wird ein SNMPv3-Trap vom SNMP-Manager an die entsprechende SNMP V3-Entity gesendet.

Mit -dbg 26 bekommen Sie Debugausgaben, wenn ein Trap verschickt wurde.

Definiert die Start-OID für die Abfrage aller Daten des Agents. Diese werden dann auf das DPE Browse.Result geschrieben.

Wenn dieses DPE leer gelassen wird, wird die Abfrage mit der Start-OID "1.3.6.1" gestartet.

Es ist auch möglich, per dpSet auf dieses Datenpunktelement mehrere Browsing-Requests anzustoßen. Die Requests kommen der Reihe nach in eine Abarbeitungsliste und werden anschließend in der selben Reihenfolge abgearbeitet.

Grundsätzlich gibt es kein Limit für Browsing-Requests. Ein Browsing-Request wird jedoch verworfen, wenn sich bereits ein identischer Request in der Abarbeitungsliste befindet.

Jeder Browsing-Request wird durch den String identifiziert (siehe DPE "Browse.RequestId"), der auf dieses Datenpunktelement geschrieben wurde. Folgende Requests sind unterschiedlich und würden somit zur Liste hinzugefügt:

• “1.3.6.1.2.1.1”
• “1.3.6.1.2.1.1:7”
• “1.3.6.1.2.1.1:3”
• “1.3.6.1.2.1”
• “1.3.6.1.2.1.2”

In diesem DPE wird das Ergebnis der Abfrage, welche mittels Browse.Start gestartet wurde, ausgegeben. Während des Browsens steht in diesem DPE "1 - started browsing".

Nachdem das Browsen erfolgreich durchgeführt wurde, enthält das Ergebnis die Daten des Agents. Ein Datensatz setzt sich immer aus 3 Zeilen zusammen:

• 1. Zeile: OID
• 2. Zeile: Wert in einer default Transformation
• 3. Zeile: Datentyp als Zahl#Datentyp als Text

Beispiel mit zwei Datensätzen:

1.3.6.1.2.1.1.1.0
Hardware: x86 Family 6 Model 15 Stepping 8 AT/AT COMPATIBLE
4#OCTETS
1.3.6.1.2.1.1.3.0
0:00:26.60
67#TIMETICKS

Mögliche Werte für den Datentyp:

• 2 - INT32
• 3 - BITS
• 4 - OCTETS
• 6 - OID
• 64 - IPADDR
• 65 - CNTR32
• 66 - UINT32
• 67 - TIMETICKS
• 68 - OPAQUE
• 70 - CNTR64

Enthält das Ergebnis keine durch 3 teilbare Anzahl an Einträgen, so handelt es sich um eine Statusmeldung. In diesem Fall steht in der ersten Zeile ein Statuscode:

1 - Abfrage gestartet

-1 - Fehler

Fehlercode und Beschreibung sind in der zweiten Zeile enthalten.

Zum Beispiel:

-1

-5#SNMP++: SNMP request timed out

Definiert die Sicherheitsmaßnahmen beim Datenaustausch:

• noAuthNoPriv (1) keine Authentifizierung und keine Verschlüsselung
• authNoPriv (2) Authentifizierung, aber keine Verschlüsselung
• authPriv (3) Authentifizierung und Datenverschlüsselung

Defaultwert ist (1).

Für die Authentifizierung der SNMP User stehen zwei Protokolle zur Verfügung.

• none (1) kein Authentifizierungsprotokoll
• HMAC_MD5 (2) MD5 Authentifizierung
• HMAC_SHA (3) SHA Authentifizierung
• HMAC_SHA2_224 (4) SHA2 Authentifizierung
• HMAC_SHA2_256 (5) SHA2 Authentifizierung
• HMAC_SHA2_384 (6) SHA2 Authentifizierung
• HMAC_SHA2_512 (7) SHA2 Authentifizierung

Defaultwert ist (1).

Die verschickten Daten können zur Erhöhung der Sicherheit auch verschlüsselt werden. Für diese Verschlüsselung muss ein Protokoll ausgewählt werden.

• none (1) keine Verschlüsselung
• DES (2) DES Verschlüsselung (Data Encryption Standard)
• IDEA (9) IDEA Verschlüsselung (International Data Encryption Algorithm)
• AES128 (4) Advanced Encryption Standard
• AES192 (20)
• AES256 (21)

Default ist (1).

Zeigt den Verbindungsstatus des redundanten Agents. Beim Start des Managers wird dieses Datenpunktelement auf FALSE gesetzt. Erst nach der ersten erfolgreich empfangenen Nachricht wird der Status auf TRUE gesetzt

Wird gesetzt wenn mit dem Agent während der mit agentConnectTimeout konfigurierten Zeitspanne keine Nachrichten ausgetauscht wurden.

Wird keine IP-Adresse definiert oder wurde die Adresse gelöscht (Leerstring), so wird dieses Element unabhängig vom aktuellen Status auf FALSE gesetzt und eine Redundanzumschaltung ist nicht möglich.