FAQ EPC SNMP

Allgemeines

• SNMP kann verwendet werden, um am EPC
  • per UDP (Port 161) Statusinformtionen und ggf. Sensorinformationen abzufragen
  • die Powerports zu schalten.

Für eine vollständige Auflistung der an Ihrem Gerät möglichen SNMP Abfragen und Steueraktionen rufen Sie das Webinterface des EPC im Browser auf, gehen Sie ins Menü Configuration - SNMP und dort auf den Link Download SNMP MIB.

Für alle Geräte der Expert Power Control NET Serie gilt:

• unterstützte Versionen: SNMPv1 und SNMPv2c
• unterstützte SNMP Befehle:
  • SNMPGET : Status- und Sensorinformation erfragen
  • SNMPGETNEXT : nächste Statusinformation erfragen
  • SNMPSET : EPC Zustandsänderung anfordern

• Um den EPC per SNMP abzufragen, benötigen Sie ein NetworkManagmentSystem, wie z.B. HP-OpenView, OpenNMS, Nagios, etc... oder z.B. die einfachen Kommandozeilen-Tools des NET-SNMP welche auch unten in den folgenden Beispielen zum Einsatz kommen.

SNMP Communities

SNMP authentifiziert die Netzwerk-Anfragen anhand sogenannter Communities. Der SNMP Request muss bei Abfragen (Lesezugriff) die public Community, bei Zustandsänderungen (Schreibzugriff) die private Community mitsenden. Die SNMP-Communities sind sozusagen Lese- bzw. Schreibpasswörter. Bei den SNMP Versionen v1 und v2c werden die Communities unverschlüsselt im Netzwerk übertragen und können innerhalb dieser Kollisionsdomäne daher leicht mit IP-Sniffern abgehört werden. Wir empfehlen beim Einsatz von SNMP also unbedingt die Nutzung einer DMZ bzw. die Verwendung der IP-ACL als Zugriffschutz!

MIBs

Die Werte, die vom EPC ausgelesen bzw. verändert werden können, die so genannten 'Managed Objects', werden in Managment Information Bases (kurz MIBs) beschrieben. Es lassen sich drei verschiedene MIBs vom EPC abfragen:

• system
• interface
• powerports

system und interface sind standardisierte MIBs (MIB-II), powerports ist in einer MIB (GUDEADS-EPC-MIB::gadsEPC) speziell für den EPC entworfen. Diesen drei Teilstrukturen sind sog. OIDs (Object Identifiers) untergeordnet. Ein OID stelle steht für den Ort eines Wertes innerhalb der MIB Struktur. Jeder OID kann alternativ mit seinem Symbolnamen (subtree name) bezeichnet werden.

Die folgenden Beispieltabellen gelten für den Expert Power Control NET 8x Rev. 2 bzw. Expert Power Control NET 8x 8010

system

subtree name	OID
system	1.3.6.1.2.1.1
sysDescr	1.3.6.1.2.1.1.1
sysObjectID	1.3.6.1.2.1.1.2
sysUpTime	1.3.6.1.2.1.1.3
sysContact	1.3.6.1.2.1.1.4
sysName	1.3.6.1.2.1.1.5
sysLocation	1.3.6.1.2.1.1.6
sysServices	1.3.6.1.2.1.1.7

interface

subtree name	OID
ifIndex	1.3.6.1.2.1.2.2.1.1
ifDescr	1.3.6.1.2.1.2.2.1.2
ifType	1.3.6.1.2.1.2.2.1.3
ifMtu	1.3.6.1.2.1.2.2.1.4
ifSpeed	1.3.6.1.2.1.2.2.1.4
ifPhysAddress	1.3.6.1.2.1.2.2.1.6
ifAdminStatus	1.3.6.1.2.1.2.2.1.7
ifOperStatus	1.3.6.1.2.1.2.2.1.8
ifLastChange	1.3.6.1.2.1.2.2.1.9
ifInOctets	1.3.6.1.2.1.2.2.1.10
ifInUcastPkt	1.3.6.1.2.1.2.2.1.11
ifInNUcastPkts	1.3.6.1.2.1.2.2.1.12
ifInDiscards	1.3.6.1.2.1.2.2.1.13
ifInErrors	1.3.6.1.2.1.2.2.1.14
ifInUnknownProtos	1.3.6.1.2.1.2.2.1.15
ifOutOctets	1.3.6.1.2.1.2.2.1.16
ifOutUcastPkts	1.3.6.1.2.1.2.2.1.17
ifOutNUcastPkts	1.3.6.1.2.1.2.2.1.18
ifOutDiscards	1.3.6.1.2.1.2.2.1.19
ifOutErrors	1.3.6.1.2.1.2.2.1.20
ifOutQLen	1.3.6.1.2.1.2.2.1.21
ifSpecific	1.3.6.1.2.1.2.2.1.22

powerports

subtree name	OID	description	r / w
GUDEADS-EPC-MIB	1.3.6.1.4.1.28507	Gude Analog- und Digitsysteme GmbH MIB (Private Enterprise)	r
GUDEADS-EPC-MIB::gadsEPC8	1.3.6.1.4.1.28507.1	Expert Power Control MIB	r
epc8powerports	1.3.6.1.4.1.28507.1.1.2	Expert Power Control's Powerports	r
epc8portNumber	1.3.6.1.4.1.28507.1.1.2.1	total number of powerports	r
epc8portTable	1.3.6.1.4.1.28507.1.1.2.2	Expert Power Control's Powerports SMI-Table	r
epc8powerPortName	1.3.6.1.4.1.28507.1.1.2.2.1.2	A textual string containing name of a PowerPort.	r
epc8powerPortState	1.3.6.1.4.1.28507.1.1.2.2.1.3	current state a PowerPort (0=off, 1=on)	rw
epc8powerPortSwitchCount	1.3.6.1.4.1.28507.1.1.2.2.1.4	total number of switch actions ocurred on a powerPort.	r

NET-SNMP

NET-SNMP bietet eine sehr weit verbreitete Sammlung von SNMP Kommandozeilen Tools (snmpget, snmpset, snmpwalk, etc.) NET-SNMP ist u.a. für Linux und Windows verfügbar. Nach der Installation von NET-SNMP sollten Sie die Gerätespezifische MIB des EPC in net-snmp's share Verzeichnis legen, z.B. nach

c:\usr\share\snmp\mibs

bzw.

/usr/share/snmp/mibs

So können Sie später anstatt der OIDs die 'subtree names' verwenden :

• subtree names

snmpwalk -v2c -mALL -c public 192.168.1.232 epc8powerports

• OID

snmpwalk -v2c -mALL -c public 192.168.1.232 1.3.6.1.4.1.28507

EPC Einstellungen

http://www.gudeads.com/wiki/images/epc_v2.2_config_snmp.jpg

---

Beispiele

walk system oids

snmpwalk -v2c -mALL -c public 192.168.1.232 system

SNMPv2-MIB::sysDescr.0 = STRING: ExpertPowerControl NET 8x
SNMPv2-MIB::sysObjectID.0 = OID: GUDEADS-EPC-MIB::gadsEPC
DISMAN-EXPRESSION-MIB::sysUpTimeInstance = Timeticks: (293200) 0:48:52.00
SNMPv2-MIB::sysContact.0 = STRING: http://www.gudeads.com/
SNMPv2-MIB::sysName.0 = STRING: ExpPowerControl
SNMPv2-MIB::sysLocation.0 = STRING: 
SNMPv2-MIB::sysServices.0 = INTEGER: 0

walk interface oids

snmpwalk -v2c -mALL -c public 192.168.1.232 interfaces

RFC1213-MIB::interfaces.0.0 = INTEGER: 1
RFC1213-MIB::ifIndex.1 = INTEGER: 1
RFC1213-MIB::ifDescr.1 = STRING: "eth_cf52235"
RFC1213-MIB::ifType.1 = INTEGER: ethernet-csmacd(6)
RFC1213-MIB::ifMtu.1 = INTEGER: 1500
RFC1213-MIB::ifSpeed.1 = Gauge32: 10000
RFC1213-MIB::ifPhysAddress.1 = Hex-STRING: 00 19 32 00 00 07 
RFC1213-MIB::ifAdminStatus.1 = INTEGER: up(1)
RFC1213-MIB::ifOperStatus.1 = INTEGER: up(1)
RFC1213-MIB::ifLastChange.1 = Wrong Type (should be Timeticks): INTEGER: 0
RFC1213-MIB::ifInOctets.1 = Counter32: 450378
RFC1213-MIB::ifInUcastPkts.1 = Counter32: 661
RFC1213-MIB::ifInNUcastPkts.1 = Counter32: 3254
RFC1213-MIB::ifInDiscards.1 = Counter32: 0
RFC1213-MIB::ifInErrors.1 = Counter32: 0
RFC1213-MIB::ifInUnknownProtos.1 = Counter32: 0
RFC1213-MIB::ifOutOctets.1 = Counter32: 255309
RFC1213-MIB::ifOutUcastPkts.1 = Counter32: 591
RFC1213-MIB::ifOutNUcastPkts.1 = Counter32: 6
RFC1213-MIB::ifOutDiscards.1 = Counter32: 0
RFC1213-MIB::ifOutErrors.1 = Counter32: 594
RFC1213-MIB::ifOutQLen.1 = Gauge32: 0
RFC1213-MIB::ifSpecific.1 = OID: SNMPv2-SMI::zeroDotZero.0

walk powerports

snmpwalk -v2c -mALL -c public 192.168.1.232 epc8powerports

GUDEADS-EPC-MIB::epc8portNumber = INTEGER: 8
GUDEADS-EPC-MIB::epc8powerPortName.1 = STRING: "SwitchPort 1"
GUDEADS-EPC-MIB::epc8powerPortName.2 = STRING: "SwitchPort 2"
GUDEADS-EPC-MIB::epc8powerPortName.3 = STRING: "SwitchPort 3"
GUDEADS-EPC-MIB::epc8powerPortName.4 = STRING: "SwitchPort 4"
GUDEADS-EPC-MIB::epc8powerPortName.5 = STRING: "SwitchPort 5"
GUDEADS-EPC-MIB::epc8powerPortName.6 = STRING: "SwitchPort 6"
GUDEADS-EPC-MIB::epc8powerPortName.7 = STRING: "SwitchPort 7"
GUDEADS-EPC-MIB::epc8powerPortName.8 = STRING: "SwitchPort 8"
GUDEADS-EPC-MIB::epc8powerPortState.1 = INTEGER: on(1)
GUDEADS-EPC-MIB::epc8powerPortState.2 = INTEGER: on(1)
GUDEADS-EPC-MIB::epc8powerPortState.3 = INTEGER: off(0)
GUDEADS-EPC-MIB::epc8powerPortState.4 = INTEGER: off(0)
GUDEADS-EPC-MIB::epc8powerPortState.5 = INTEGER: off(0)
GUDEADS-EPC-MIB::epc8powerPortState.6 = INTEGER: off(0)
GUDEADS-EPC-MIB::epc8powerPortState.7 = INTEGER: off(0)
GUDEADS-EPC-MIB::epc8powerPortState.8 = INTEGER: off(0)
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.1 = Counter32: 5
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.2 = Counter32: 1
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.3 = Counter32: 0
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.4 = Counter32: 0
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.5 = Counter32: 0
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.6 = Counter32: 0
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.7 = Counter32: 0
GUDEADS-EPC-MIB::epc8powerPortSwitchCount.8 = Counter32: 0

Powerport 1 Schaltzustand abfragen

snmpget -v2c -mALL -c private 192.168.1.232 epc8powerPortState.1

GUDEADS-EPC-MIB::epc8powerPortState.1 = INTEGER: on(1)

Powerport 1 einschalten

snmpset -v2c -mALL -c private 192.168.1.232 epc8powerPortState.1  integer 1

downloads

• NET-SNMP

Alle MIB-Tabellen können direkt vom Gerät bezogen werden. Unter

http://[IP des Gerätes einsetzen]/config_snmp.html

klicken Sie auf den Link "Download SNMP MIB". Sie bekommen dann die Gerätespezifische Tabelle angezeigt.

Als Beispiel-MIBs:

• GUDEADS-EPC8X-MIB.txt
• GUDEADS-EPC24X-MIB.txt

Glossar

• SNMP, MIBs
• OID