Mb am 21. Juni 2013 um 11:57 Uhr

2013-06-21T11:57:57Z

Mb: Die Seite wurde neu angelegt: „=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 S…“

2013-03-07T18:29:46Z

Die Seite wurde neu angelegt: „=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 S…“

Neue Seite

=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 '''N'''etwork'''M'''anagment'''S'''ystem, like e.g. [http://h20229.www2.hp.com/ HP-OpenView], [http://www.opennms.org/ OpenNMS], [http://www.nagios.org/ Nagios], etc... or simple command line tools like e.g. [http://net-snmp.sourceforge.net/ 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 [http://en.wikipedia.org/wiki/DMZ_%28computing%29 demilitarized zone] or use the [[FAQ EPC IP ACL | IP ACL]] for access control!

=MIBs=
The values that can be read or written, the so-called 'Managed Objects', are arranged in '''M'''anagement '''I'''nformation '''B'''ases (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===
{| cellpadding="5" cellspacing="0" border="1"
|- style="background-color:#f0f0f0; font-style:bold;"
|subtree name
|OID
|-
|system
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.html 1.3.6.1.2.1.1]
|-
|sysDescr
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.1.html 1.3.6.1.2.1.1.1]
|-
|sysObjectID
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.2.html 1.3.6.1.2.1.1.2]
|-
|sysUpTime
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.3.html 1.3.6.1.2.1.1.3]
|-
|sysContact
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.4.html 1.3.6.1.2.1.1.4]
|-
|sysName
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.5.html 1.3.6.1.2.1.1.5]
|-
|sysLocation
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.6.html 1.3.6.1.2.1.1.6]
|-
|sysServices
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.1.7.html 1.3.6.1.2.1.1.7]
|}

===interface===
{| cellpadding="5" cellspacing="0" border="1"
|- style="background-color:#f0f0f0; font-style:bold;"
|subtree name
|OID
|-
|ifIndex
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.1.html 1.3.6.1.2.1.2.2.1.1]
|-
|ifDescr
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.2.html 1.3.6.1.2.1.2.2.1.2]
|-
|ifType
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.3.html 1.3.6.1.2.1.2.2.1.3]
|-
|ifMtu
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.4.html 1.3.6.1.2.1.2.2.1.4]
|-
|ifSpeed
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.5.html 1.3.6.1.2.1.2.2.1.4]
|-
|ifPhysAddress
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.6.html 1.3.6.1.2.1.2.2.1.6]
|-
|ifAdminStatus
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.7.html 1.3.6.1.2.1.2.2.1.7]
|-
|ifOperStatus
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.8.html 1.3.6.1.2.1.2.2.1.8]
|-
|ifLastChange
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.9.html 1.3.6.1.2.1.2.2.1.9]
|-
|ifInOctets
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.10.html 1.3.6.1.2.1.2.2.1.10]
|-
|ifInUcastPkt
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.11.html 1.3.6.1.2.1.2.2.1.11]
|-
|ifInNUcastPkts
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.12.html 1.3.6.1.2.1.2.2.1.12]
|-
|ifInDiscards
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.13.html 1.3.6.1.2.1.2.2.1.13]
|-
|ifInErrors
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.14.html 1.3.6.1.2.1.2.2.1.14]
|-
|ifInUnknownProtos
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.15.html 1.3.6.1.2.1.2.2.1.15]
|-
|ifOutOctets
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.16.html 1.3.6.1.2.1.2.2.1.16]
|-
|ifOutUcastPkts
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.17.html 1.3.6.1.2.1.2.2.1.17]
|-
|ifOutNUcastPkts
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.18.html 1.3.6.1.2.1.2.2.1.18]
|-
|ifOutDiscards
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.19.html 1.3.6.1.2.1.2.2.1.19]
|-
|ifOutErrors
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.20.html 1.3.6.1.2.1.2.2.1.20]
|-
|ifOutQLen
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.21.html 1.3.6.1.2.1.2.2.1.21]
|-
|ifSpecific
|[http://www.alvestrand.no/objectid/1.3.6.1.2.1.2.2.1.22.html 1.3.6.1.2.1.2.2.1.22]
|}

===powerports===
{| cellpadding="5" cellspacing="0" border="1"
|- style="background-color:#f0f0f0; font-style:bold;"
|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=
[http://net-snmp.sourceforge.net/ 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 [http://www.gudeads.com/files/software/GUDEADS-EPC-MIB.txt 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=
*[http://net-snmp.sourceforge.net/ NET-SNMP]

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:
*[http://www.gudeads.com/files/software/GUDEADS-EPC8X-MIB.txt GUDEADS-EPC8X-MIB.txt]
*[http://www.gudeads.com/files/software/GUDEADS-EPC24X-MIB.txt GUDEADS-EPC24X-MIB.txt]

=Glossary=
*[http://de.wikipedia.org/wiki/Snmp SNMP, MIBs]
*[http://de.wikipedia.org/wiki/Object_Identifier OID]

@@ Zeile 185: / Zeile 185: @@
 =NET-SNMP=
-[http://net-snmp.sourceforge.net/ NET-SNMP] provides a widely used collection of SNMP command line tools (snmpget, snmpset, smnpwalk, etc.).
+[http://net-snmp.sourceforge.net/ NET-SNMP] provides a widely used collection of SNMP command line tools (snmpget, snmpset, snmpwalk, etc.).
 NET-SNMP is available for Linux and Windows.

FAQ EPC SNMP Engl - Versionsgeschichte

Mb am 21. Juni 2013 um 11:57 Uhr

Mb: Die Seite wurde neu angelegt: „=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 S…“

Mb: Die Seite wurde neu angelegt: „=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 S…“