FAQ EPC SNMP Engl
General
- SNMP can be used on an EPC
- to get UDP (Port 161) Status and Sensor informations
- to switch Powerports
For a complete list of possible SNMP requests and actions go ito the Webinterface of the EPC and enter the Configuration - SNMP menu. There you find the link Download SNMP MIB.
For all devices of the Expert Power Control NET series applies:
- supported SNMP Versions: SNMPv1 und SNMPv2c
- supported SNMP Commands:
- SNMPGET : request Status- and Sensor informations
- SNMPGETNEXT : request next Status information
- SNMPSET : request EPC state change
- To query the EPC via SNMP, you need a NetworkManagmentSystem, like e.g. HP-OpenView, OpenNMS, Nagios, etc... or simple command line tools like e.g. NET-SNMP that are used in the following examples.
SNMP Communities
SNMP authenticates the network requests by so-called communities. Every SNMP get request (read access) has to be accompanied with a public community, and every condition change request (write access) needs a private community send along. The SNMP communities are, so to speak, read and write passwords. In SNMP versions v1 and v2c the communities are sent unencrypted across the network and can therefore easily be intercepted with IP sniffers. We recommend to use SNMP in a DMZ demilitarized zone or use the IP ACL for access control!
MIBs
The values that can be read or written, the so-called 'Managed Objects', are arranged in Management Information Bases (short MIBs). Three different types of Objects can be queried:
- system
- interface
- powerports
system und interface are standardized MIB's (MIB-II), the powerports structure is in the enterprise part of the MIB (GUDEADS-EPC-MIB::gadsEPC) that was constructed especially for the EPC. Subordinated to these three structures are the OIDs (Object Identifiers). An OID represents the location of a value inside the MIB. Each OID may alternatively be referred to with its symbol name (subtree name).
The following example tables apply for the Expert Power Control NET 8x Rev. 2 or the 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 occurred on a powerPort. | r |
NET-SNMP
NET-SNMP provides a widely used collection of SNMP command line tools (snmpget, snmpset, smnpwalk, etc.). NET-SNMP is available for Linux and Windows.
After the installation of NET-SNMP you should put the device specific MIB of the EPC in net-snmp's share directory, e.g. in
c:\usr\share\snmp\mibs
or
/usr/share/snmp/mibs
So you can later use the 'subtree names' instead of the OID's:
- 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 Setup
http://www.gudeads.com/wiki/images/epc_v2.2_config_snmp.jpg
Examples
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
Query the Powerport 1 state
snmpget -v2c -mALL -c private 192.168.1.232 epc8powerPortState.1
GUDEADS-EPC-MIB::epc8powerPortState.1 = INTEGER: on(1)
Turn Powerport 1 on
snmpset -v2c -mALL -c private 192.168.1.232 epc8powerPortState.1 integer 1
downloads
All MIB-Tables can be accessed directly from the device. Under
http://[device IP]/config_snmp.html
click on the Link "Download SNMP MIB". The device specific MIB will be shown.
Example-MIBs: