FHEMWiki - Benutzerbeiträge [de]

Raspberry Pi / Rasbian und SNMP

2015-10-16T21:41:06Z

Pipp37: /* Links */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart

# EXTENDING THE AGENT
extend fhemstatus /etc/init.d/fhem status
</nowiki>

;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwendig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

<code> /bin/ps -e | grep perl </code> findet alle Perl Prozesse.

<code> /bin/ps -ef | grep perl </code> zeigt genaue Daten an.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

;Extended Ausgabe
: <code> snmpwalk -v1 -c public -On localhost nsExtendOutput1 </code>
: oder mit OID
: <code> snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 </code>

<nowiki>
# Ausgabe bereinigt
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3
.1.3.6.1.4.1.8072.1.3.2.3.1.1.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running <-- Das ist die Ausgabe von /etc/init.d/fhem status
.1.3.6.1.4.1.8072.1.3.2.3.1.1.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running
.1.3.6.1.4.1.8072.1.3.2.3.1.2.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

# lesbar
root@fhem1:~# snmpwalk -v1 -c public localhost nsExtendOutput1
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test1" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test2" = INTEGER: 2
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."fhemstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."ser2netstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."lm-syslog-size" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendResult."test1" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."test2" = INTEGER: 8960
NET-SNMP-EXTEND-MIB::nsExtendResult."fhemstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."ser2netstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."lm-syslog-size" = INTEGER: 0
</nowiki>

;Fertiger Suchbefehl
: <code> snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 | grep "fhem is not running" | grep "8072.1.3.2.3.1.1." | head -1 </code>
: <code> snmpwalk -v1 -c public -Ovq localhost .1.3.6.1.4.1.8072.1.3.2.3 | grep "fhem is not running" | head -1 </code>
: oder
;Finden über die SNMP-Prozess Liste
: Damit lässt sich remote jeder Prozess finden.
: Suche in den Parametern:
: <code> snmpwalk -v1 -c public -OvQe localhost 1.3.6.1.2.1.25.4.2.1.5 | grep -i 'fhem.pl fhem.cfg' | grep -v '"-i' </code>
: Suche in den Namen:
: <code> snmpwalk -v1 -c public -OvQe localhost 1.3.6.1.2.1.25.4.2.1.2 | grep -i 'perl' </code>
: <code> snmpwalk -v1 -c public -OvQe localhost 1.3.6.1.2.1.25.4.2.1.2 | grep -i 'ser2net' </code>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]
* Net-SNMP snmpd.conf [http://net-snmp.sourceforge.net/docs/man/snmpd.conf.html]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T21:35:20Z

Pipp37: /* Beispiel */

Raspberry Pi / Rasbian und SNMP

2015-10-16T21:32:35Z

Pipp37: /* Beispiel */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart

# EXTENDING THE AGENT
extend fhemstatus /etc/init.d/fhem status
</nowiki>

;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwendig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

<code> /bin/ps -e | grep perl </code> findet alle Perl Prozesse.

<code> /bin/ps -ef | grep perl </code> zeigt genaue Daten an.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

;Extended Ausgabe
: <code> snmpwalk -v1 -c public -On localhost nsExtendOutput1 </code>
: oder mit OID
: <code> snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 </code>

<nowiki>
# Ausgabe bereinigt
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3
.1.3.6.1.4.1.8072.1.3.2.3.1.1.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running <-- Das ist die Ausgabe von /etc/init.d/fhem status
.1.3.6.1.4.1.8072.1.3.2.3.1.1.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running
.1.3.6.1.4.1.8072.1.3.2.3.1.2.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

# lesbar
root@fhem1:~# snmpwalk -v1 -c public localhost nsExtendOutput1
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test1" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test2" = INTEGER: 2
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."fhemstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."ser2netstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."lm-syslog-size" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendResult."test1" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."test2" = INTEGER: 8960
NET-SNMP-EXTEND-MIB::nsExtendResult."fhemstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."ser2netstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."lm-syslog-size" = INTEGER: 0
</nowiki>

;Fertiger Suchbefehl
: <code> snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 | grep "fhem is not running" | grep "8072.1.3.2.3.1.1." | head -1 </code>
: <code> snmpwalk -v1 -c public -Ovq localhost .1.3.6.1.4.1.8072.1.3.2.3 | grep "fhem is not running" | head -1 </code>
: oder
;Finden über die SNMP-Prozess Liste
: Damit lässt sich remote jeder Prozess finden.
: Suche in den Parametern:
: <code> snmpwalk -v1 -c public -OvQe localhost 1.3.6.1.2.1.25.4.2.1.5 | grep -i 'fhem.pl fhem.cfg' | grep -v '"-i' </code>
: Suche in den Namen:
: <code> snmpwalk -v1 -c public -OvQe localhost 1.3.6.1.2.1.25.4.2.1.2 | grep -i 'perl' </code>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T17:33:11Z

Pipp37: /* Überwachung des Fhem Prozesses und Neustart per cron */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart

# EXTENDING THE AGENT
extend fhemstatus /etc/init.d/fhem status
</nowiki>

;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwendig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

<code> /bin/ps -e | grep perl </code> findet alle Perl Prozesse.

<code> /bin/ps -ef | grep perl </code> zeigt genaue Daten an.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

;Extended Ausgabe
: <code> snmpwalk -v1 -c public -On localhost nsExtendOutput1 </code>
: oder mit OID
: <code> snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 </code>

<nowiki>
# Ausgabe bereinigt
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3
.1.3.6.1.4.1.8072.1.3.2.3.1.1.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running <-- Das ist die Ausgabe von /etc/init.d/fhem status
.1.3.6.1.4.1.8072.1.3.2.3.1.1.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running
.1.3.6.1.4.1.8072.1.3.2.3.1.2.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

# lesbar
root@fhem1:~# snmpwalk -v1 -c public localhost nsExtendOutput1
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test1" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test2" = INTEGER: 2
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."fhemstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."ser2netstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."lm-syslog-size" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendResult."test1" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."test2" = INTEGER: 8960
NET-SNMP-EXTEND-MIB::nsExtendResult."fhemstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."ser2netstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."lm-syslog-size" = INTEGER: 0
</nowiki>

;Fertiger Suchbefehl
: <code> snmpwalk -v1 -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 | grep "fhem is not running" | grep "8072.1.3.2.3.1.1." | head -1 </code>
: <code> snmpwalk -v1 -c public -Ovq localhost .1.3.6.1.4.1.8072.1.3.2.3 | grep "fhem is not running" | head -1 </code>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T17:28:10Z

Pipp37: /* Testen mit Snmp-Tools */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart

# EXTENDING THE AGENT
extend fhemstatus /etc/init.d/fhem status
</nowiki>

;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwendig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

<code> /bin/ps -e | grep perl </code> findet alle Perl Prozesse.

<code> /bin/ps -ef | grep perl </code> zeigt genaue Daten an.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

;Extended Ausgabe
: <code> snmpwalk -v2c -c public -On localhost nsExtendOutput1 </code>
: oder mit OID
: <code> snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 </code>

<nowiki>
# Ausgabe bereinigt
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3
.1.3.6.1.4.1.8072.1.3.2.3.1.1.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running <-- Das ist die Ausgabe von /etc/init.d/fhem status
.1.3.6.1.4.1.8072.1.3.2.3.1.1.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running
.1.3.6.1.4.1.8072.1.3.2.3.1.2.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

# lesbar
root@fhem1:~# snmpwalk -v2c -c public localhost nsExtendOutput1
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test1" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test2" = INTEGER: 2
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."fhemstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."ser2netstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."lm-syslog-size" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendResult."test1" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."test2" = INTEGER: 8960
NET-SNMP-EXTEND-MIB::nsExtendResult."fhemstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."ser2netstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."lm-syslog-size" = INTEGER: 0
</nowiki>

;Fertiger Suchbefehl
: <code> snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 | grep "fhem is not running" | grep "8072.1.3.2.3.1.1." </code>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T17:17:19Z

Pipp37: /* Testen mit Snmp-Tools */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart

# EXTENDING THE AGENT
extend fhemstatus /etc/init.d/fhem status
</nowiki>

;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwendig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

<code> /bin/ps -e | grep perl </code> findet alle Perl Prozesse.

<code> /bin/ps -ef | grep perl </code> zeigt genaue Daten an.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

;Extended Ausgabe
: <code> snmpwalk -v2c -c public -On localhost nsExtendOutput1 </code>
: oder mit OID
: <code> snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3 </code>

<nowiki>
# Ausgabe bereinigt
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.8072.1.3.2.3
.1.3.6.1.4.1.8072.1.3.2.3.1.1.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running <-- Das ist die Ausgabe von /etc/init.d/fhem status
.1.3.6.1.4.1.8072.1.3.2.3.1.1.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

.1.3.6.1.4.1.8072.1.3.2.3.1.2.10.102.104.101.109.115.116.97.116.117.115 = STRING: fhem is not running
.1.3.6.1.4.1.8072.1.3.2.3.1.2.13.115.101.114.50.110.101.116.115.116.97.116.117.115 = STRING: checking Serial port to network proxy...done (ser2net running).

# lesbar
root@fhem1:~# snmpwalk -v2c -c public localhost nsExtendOutput1
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutput1Line."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."fhemstatus" = STRING: fhem is not running
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."ser2netstatus" = STRING: checking Serial port to network proxy...done (ser2net running).
NET-SNMP-EXTEND-MIB::nsExtendOutputFull."lm-syslog-size" = STRING: 500 /var/log/syslog
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test1" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."test2" = INTEGER: 2
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."fhemstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."ser2netstatus" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendOutNumLines."lm-syslog-size" = INTEGER: 1
NET-SNMP-EXTEND-MIB::nsExtendResult."test1" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."test2" = INTEGER: 8960
NET-SNMP-EXTEND-MIB::nsExtendResult."fhemstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."ser2netstatus" = INTEGER: 0
NET-SNMP-EXTEND-MIB::nsExtendResult."lm-syslog-size" = INTEGER: 0
</nowiki>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T16:46:54Z

Pipp37: /* Überwachung des Fhem Prozesses und Neustart per cron */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart

# EXTENDING THE AGENT
extend fhemstatus /etc/init.d/fhem status
</nowiki>

;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwendig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

<code> /bin/ps -e | grep perl </code> findet alle Perl Prozesse.

<code> /bin/ps -ef | grep perl </code> zeigt genaue Daten an.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T16:33:54Z

Pipp37: /* Konfiguration SNMP */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>
;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwendig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

<code> /bin/ps -e | grep perl </code> findet alle Perl Prozesse.

<code> /bin/ps -ef | grep perl </code> zeigt genaue Daten an.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T16:17:39Z

Pipp37: /* Testen mit Snmp-Tools */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>
;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwenidig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

oder als Table
<nowiki>
root@fhem1:~# snmptable -v1 -c public localhost .1.3.6.1.4.1.2021.2
SNMP table: UCD-SNMP-MIB::prTable

prIndex prNames prMin prMax prCount prErrorFlag prErrMessage prErrFix prErrFixCmd
1 init 0 0 1 noError noError /usr/bin/sudo /sbin/reboot
2 ser2net 0 0 1 noError noError /usr/bin/sudo /etc/init.d/ser2net restart
3 perl 2 5 1 error Too few perl running (# = 1) noError /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T16:11:37Z

Pipp37: /* Testen mit Snmp-Tools */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>
;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwenidig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 2
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 5
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-- Fehler bei Perl
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: Too few perl running (# = 1) <-- Grund des Fehlers
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>
snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T16:06:49Z

Pipp37: /* Beispiel */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl - at least one perl process, but no more than 5
proc perl 5 2
procfix perl /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>
;Erklärung
<code> proc perl 5 2 </code> bedeutet, dass mindestens 2 Perl Prozesse laufen sollen. Das ist notwenidig, wenn z.B. Webmin installiert ist. Dieses Tool hat auch einen Perl Prozess!.

Wenn nur Fhem einen Perl Prozess belegt, reicht ein <code> proc perl </code>.

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.
#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

==== Testen mit Snmp-Tools ====
; Systeminfos
<nowiki>root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.1.0
SNMPv2-MIB::sysDescr.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
</nowiki>

;Prozessüberwachung
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prIndex.3 = INTEGER: 3
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prNames.3 = STRING: perl
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMin.3 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.3 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prCount.3 = INTEGER: 0
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.3 = INTEGER: error(1) <-
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrMessage.3 = STRING: No perl process running.
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.3 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
UCD-SNMP-MIB::prErrFixCmd.3 = STRING: /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>
snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T15:44:02Z

Pipp37: /* Überwachung des Fhem Prozesses und Neustart per cron */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl
proc perl
procfix perl /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

* Neustart snmpd Daemon
<code> service snmpd restart </code>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T15:42:29Z

Pipp37: /* Beispiel */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Community & Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

<code>snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1</code>

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

Basierend auf die in diesem Artikel beschriebenen Mechanismen wird ein SNMP-Watchdog für Fhem erstellt.

==== Konfiguration SNMP ====

* /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
# Port/NIC binding
#
agentAddress udp:161

# SYSTEM INFORMATION
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com
sysServices 72

# community
nocommunity public

rwcommunity writesecret 192.168.0.0/16
rwcommunity writesecret localhost

###########################################################################
# Process Monitoring
#
#
# ID:1 init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# ID:2 process ser2net
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart

# ID:3 process perl
proc perl
procfix perl /usr/bin/sudo /etc/init.d/fhem restart
</nowiki>

* /etc/sudoers
: Eine Zeile wie folgt hinzufügen.
<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

* /etc/snmp/snmp.conf
: Aus-Kommentieren mibs
<nowiki>#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

* Neustart snmp
<code> service snmp restart </code>

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T15:20:45Z

Pipp37: /* SNMPD Prozessüberwachung */

Raspberry Pi / Rasbian und SNMP

2015-10-16T15:08:52Z

Pipp37: /* Rechner neu starten */

Raspberry Pi / Rasbian und SNMP

2015-10-16T15:01:05Z

Pipp37: /* Raspberry Pi / Rasbian und SNMP (IN ARBEIT) */

Raspberry Pi / Rasbian und SNMP

2015-10-16T15:00:29Z

Pipp37: /* Hilfe/Support */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

== Links ==
* Watchdog per SNMP [https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog]

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T14:57:52Z

Pipp37: /* Beispiel */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

... In Arbeit ....
... to be continued ....

[[Raspberry Pi]]

== Hilfe/Support ==
* Fragen werden gerne im FHEM-Forum auf [http://forum.fhem.de http://forum.fhem.de] beantwortet.
* Für Feedback ist [http://forum.fhem.de/index.php?topic=42348.msg345307 dieser Beitrag] im Forum vorgesehen.

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T14:34:42Z

Pipp37: /* Prozesse neu starten / Reboot Raspi über SNMP */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende prErrFix-OID schreibt.

<nowiki>root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot <- Dieser Befehl wird dann ausgelöst
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart

# hier die OIDs - bereingte Augabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
..
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
..
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0) <- Hier eine 1 zum Auslösen des Reboots schreiben
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Zum Neustart des Rechner schreibt man nun den Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.1'''

Es wird <code> /usr/bin/sudo /sbin/reboot </code> ausgeführt und der Rechner fährt neu hoch.

Wenn man das remote machen möchte, einfach ''localhost'' durch die Raspberry-IP ersetzen und schon hat man einen einfachen Remote-Reboot mit Boardmitteln erstellt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.1 i 1

Broadcast message from root@fhem1.local (Fri Oct 16 16:26:32 2015):

The system is going down for reboot NOW!
UCD-SNMP-MIB::prErrFix.1 = INTEGER: runFix(1) </nowiki>

== Beispiel ==

=== Überwachung des Fhem Prozesses und Neustart per cron ===

... In Arbeit ....
... to be continued ....
[[Raspberry Pi]]

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T14:14:31Z

Pipp37: /* Prozesse neu starten / Reboot Raspi über SNMP */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab.

Die Konfiguration der Prozesse ist unter [[#SNMPD Prozessüberwachung]] beschrieben. Mit dem zusätzlichen Parameter ''-On'' werden nur die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki> root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende OID schreibt.

... In Arbeit ....
... to be continued ....
[[Raspberry Pi]]

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T14:10:48Z

Pipp37: /* SNMPD Prozessüberwachung */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab. Wie schon unter [[#SNMPD Prozessüberwachung]] beschrieben, bekommt man mit dem zusätzlichen Parameter ''-On'' die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki>
root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende OID schreibt.

... In Arbeit ....
... to be continued ....
[[Raspberry Pi]]

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T14:10:01Z

Pipp37: /* SNMPD Prozessüberwachung */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init /usr/bin/sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab. Wie schon unter [[#SNMPD Prozessüberwachung]] beschrieben, bekommt man mit dem zusätzlichen Parameter ''-On'' die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki>
root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende OID schreibt.

... In Arbeit ....
... to be continued ....
[[Raspberry Pi]]

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T14:08:28Z

Pipp37: /* Prozesse neu starten / Reboot Raspi über SNMP */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab. Wie schon unter [[#SNMPD Prozessüberwachung]] beschrieben, bekommt man mit dem zusätzlichen Parameter ''-On'' die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki>
root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: /usr/bin/sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: /usr/bin/sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

=== Dienst ser2net neu starten ===

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
In dem gezeigten Fall wird <code> /usr/bin/sudo /etc/init.d/ser2net restart </code> ausgeführt.

<nowiki>root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1) </nowiki>

Wenn man nun den Dienst entfernt neu starten möchte, geht das aus dem eigenen LAN ganz einfach. <LAN-IP-RPI> wird z.b durch lokale IP '''192.168.0.160''' vom Raspberry ersetzt.

<code>snmpset -v2c -c writesecret <LAN-IP-RPI> .1.3.6.1.4.1.2021.2.1.102.2 i 1</code>

=== Rechner neu starten ===

Weiters wurde in dem Beispiel noch ein Prozess zur Überwachung definiert. Der erste konfigurierte ''proc'' lautet ''init'' und der dazu passende ''procfix'' wurde mit <code> /usr/bin/sudo /sbin/reboot </code> eingestellt.

Damit wird der Rechner neu gestartet, wenn man die Zahl 1 per ''snmpwrite'' in die passende OID schreibt.

... In Arbeit ....
... to be continued ....
[[Raspberry Pi]]

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T13:51:02Z

Pipp37: /* Prozesse neu starten / Reboot Raspi über SNMP */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab. Wie schon unter [[#SNMPD Prozessüberwachung]] beschrieben, bekommt man mit dem zusätzlichen Parameter ''-On'' die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki>
root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Hierher wird der Wert 1 geschrieben, um den Befehl auszulösen
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0 </nowiki>

Zum Auslösen des ''procfix'' Befehles für ''ser2net'' wird der Wert '''1''' in die OID .1.3.6.1.4.1.2021.2.1.'''102.2''' geschrieben.
<nowiki>
root@fhem1:~# snmpset -v2c -c writesecret localhost .1.3.6.1.4.1.2021.2.1.102.2 i 1
UCD-SNMP-MIB::prErrFix.2 = INTEGER: runFix(1)
</nowiki>

... In Arbeit ....
... to be continued ....
[[Raspberry Pi]]

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T13:26:40Z

Pipp37: /* Prozesse neu starten / Reboot Raspi über SNMP */

{{Baustelle}}

== Raspberry Pi / Rasbian und SNMP (IN ARBEIT)==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert, um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

== Einleitung ==
Das [https://de.wikipedia.org/wiki/Simple_Network_Management_Protocol '''SNMP (Simple Network Management Protocol)'''] läuft über das verbindungslose UDP Protokoll Port 161(SNMP) und Port 162(TRAP) und wurde entwickelt, um Netzwerkgeräte entfernt zu überwachen und zu steuern.

== Installation Debian/Rasbian und MIBS laden ==
Wenn man nicht als root unterwegs ist, muss noch ein sudo bei jedem Befehl vorangestellt werden.

<nowiki>apt-get install snmpd snmp snmp-mibs-downloader</nowiki>

Sollten die [https://de.wikipedia.org/wiki/Management_Information_Base '''MIB's (Management Information Base)'''] nicht automatisch geladen werden, wird der Download initiert.
<nowiki>download-mibs </nowiki>

== SNMPD Konfiguration ==
Zuerst werden Einstellungen wie Systemname, Systemadmin usw.. gemacht.

Datei: /etc/snmp/snmpd.conf
<nowiki>
###############################################################################
#
# AGENT BEHAVIOUR
#
# Listen for connections from the local system only
# agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
# agentAddress udp:161,udp6:[::1]:161
agentAddress udp:161

###############################################################################
#
# SYSTEM INFORMATION
#
# Note that setting these values here, results in the corresponding MIB objects being 'read-only'
# See snmpd.conf(5) for more details
sysLocation Haus1-Heizkeller
sysContact Administrator meinemail@gmail.com

# Application + End-to-End layers
sysServices 72
</nowiki>
'''Erklärung:''' Wichtig ist ''agentAddress''. Wird nur ''udp:161'' angegeben, ist der Zugriff von jeder IP aus möglich.

== SNMPD Prozessüberwachung ==
Konfiguration in Datei /etc/snmp/snmpd.conf
<nowiki>
# readonly community
rocommunity public

# write from 192.168.x.x subnets
rwcommunity writesecret 192.168.0.0/16

# write from localhost
rwcommunity writesecret localhost

# Process Monitoring
#
# init process dummy for reboot
proc init
procfix init sudo /sbin/reboot

# process ser2net / at least one process
proc ser2net
procfix ser2net /usr/bin/sudo /etc/init.d/ser2net restart </nowiki>

'''Erklärung:'''
Diese Infos beziehen sich auf die Protokoll Version 1 und 2c.

* rocommunity = Name für den Zugriff im "Nur Lesemodus". Wird sonst nichts angegeben, ist der Zugriff von jeder IP aus möglich.
* rwcommunity = Name für den "Schreibzugriff". Hier sind 2 Einträge vorhanden. ''192.168.0.0/16'' erlaubt das Schreiben von jeder IP, die mit 192.168 anfängt. Die 2. Zeile ''localhost'' erlaubt das auch dem Rechner selbst.
* proc = Prozessname wie er mit der Befehlszeile ps -aux angezeigt wird.
* procfix = Befehl der ausgeführt wird, wenn auf die dazugehörige [https://de.wikipedia.org/wiki/Object_Identifier ''' OID (Object Identifier)'''] ''schreibend'' zugegriffen wird.

== Sudo Rechtevergabe ==
Wird ''procfix'' verwendet, muß noch diese Einstellung gemacht werden.

Konfiguration in Datei /etc/sudoers

Eine Zeile wie folgt hinzufügen.

<nowiki>
### for snmp procfix scripts as root
snmp ALL=(ALL) NOPASSWD: ALL </nowiki>

'''Erklärung:'''
Der SNMP Dienst läuft auf Rasbian standardmäßig unter dem user:snmp und group:snmp.

Dieser User darf keine Prozesse starten oder beenden und schon gar nicht den gesamten Rechner neu starten.

Um das zu ermöglichen, müssen dem Benutzer snmp root Rechte per sudo vergeben werden. Dazu ist der gezeigte Eintrag nowendig.

Nach jeder Änderung muss zum Aktivieren der Einstellung der snmpd-Dienst neu gestartet werden.

<nowiki>service snmpd restart </nowiki>

== SNMP Client - Verwendung von OID-Namen aktivieren ==
Um OID Namen statt der kryptischen 1.3.x.x.x.x. Nummern zu verwenden ist noch dieser Schritt nötig.

Aus-Kommentieren mibs : in Datei /etc/snmp/snmp.conf
<nowiki>
#
# As the snmp packages come without MIB files due to license reasons, loading
# of MIBs is disabled by default. If you added the MIBs you can reenable
# loaging them by commenting out the following line.

#### mibs : </nowiki>

== SNMP Befehle ==
Nach einem abschliessenden Neustart des snmpd-Daemons mit <code> service snmpd restart </code> können auf dem lokalen Rechner <code> snmpwalk </code> und <code> snmpget </code> Befehle eingeben werden.

Der genaue Syntax kann auf der Konsole mit <code> man <Befehl> </code> angezeigt werden.

;snmpwalk
: Lesender Zugriff auf SNMP Variblen mit allen im Baum darunter liegenden Werten.
;snmpget
: Lesender Zugriff auf nur einen einzigen Wert.
;snmpwrite
: Schreibender Zugriff auf einen Wert.

----

Mit <code> snmpget </code> sehen wir uns nun Werte zu dem System an.

<nowiki>
root@fhem1:~# snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0
SNMPv2-MIB::sysContact.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.2.1.1.6.0
SNMPv2-MIB::sysLocation.0 = STRING: Haus1-Heizkeller

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.4.0
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com

root@fhem1:~# snmpget -v1 -c public -On localhost .1.3.6.1.2.1.1.6.0
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
</nowiki>

'''Erklärung:''' Hier sehen wir unsere in der beschriebenen Konfiguration eingetragenen Werte.

;snmpget
: -v1 = SNMP Version 1
: -v2 = SNMP Version 2
: -c public = Zugriff mit dem Namen public - meistens wird dieser Name für "Nur-Lese" Zugriff verwendet.
: -0n = Ausgabe der OID-Zahlenwerte anstatt der MIB-Namen
: localhost = Zugriff auf den lokalen Rechner. Hier die IP des Rechners einsetzen, wenn remote abgefragt werden soll.
: .1.3.6.1.2.1.1.4.0 = OID mit dem Wert

----

Mit <code> snmpwalk </code> sehen wir uns den gesamten Baum eines Wertes an.
<nowiki>
root@fhem1:~# snmpwalk -v1 -c public -On localhost .1.3.6.1.2.1.1
.1.3.6.1.2.1.1.1.0 = STRING: Linux fhem1.local 3.18.9+ #768 PREEMPT Sun Mar 15 18:59:03 GMT 2015 armv6l
.1.3.6.1.2.1.1.2.0 = OID: .1.3.6.1.4.1.8072.3.2.10
.1.3.6.1.2.1.1.3.0 = Timeticks: (292649) 0:48:46.49
.1.3.6.1.2.1.1.4.0 = STRING: Administrator meinemail@gmail.com
.1.3.6.1.2.1.1.5.0 = STRING: fhem1.local
.1.3.6.1.2.1.1.6.0 = STRING: Haus1-Heizkeller
.1.3.6.1.2.1.1.7.0 = INTEGER: 72
.1.3.6.1.2.1.1.8.0 = Timeticks: (7) 0:00:00.07
.1.3.6.1.2.1.1.9.1.2.1 = OID: .1.3.6.1.6.3.10.3.1.1
.1.3.6.1.2.1.1.9.1.2.2 = OID: .1.3.6.1.6.3.11.3.1.1
.1.3.6.1.2.1.1.9.1.2.3 = OID: .1.3.6.1.6.3.15.2.1.1
.1.3.6.1.2.1.1.9.1.2.4 = OID: .1.3.6.1.6.3.1
.1.3.6.1.2.1.1.9.1.2.5 = OID: .1.3.6.1.2.1.49
.1.3.6.1.2.1.1.9.1.2.6 = OID: .1.3.6.1.2.1.4
.1.3.6.1.2.1.1.9.1.2.7 = OID: .1.3.6.1.2.1.50
.1.3.6.1.2.1.1.9.1.2.8 = OID: .1.3.6.1.6.3.16.2.2.1
.1.3.6.1.2.1.1.9.1.3.1 = STRING: The SNMP Management Architecture MIB.
.1.3.6.1.2.1.1.9.1.3.2 = STRING: The MIB for Message Processing and Dispatching.
.1.3.6.1.2.1.1.9.1.3.3 = STRING: The management information definitions for the SNMP User-based Security Model.
.1.3.6.1.2.1.1.9.1.3.4 = STRING: The MIB module for SNMPv2 entities
.1.3.6.1.2.1.1.9.1.3.5 = STRING: The MIB module for managing TCP implementations
.1.3.6.1.2.1.1.9.1.3.6 = STRING: The MIB module for managing IP and ICMP implementations
.1.3.6.1.2.1.1.9.1.3.7 = STRING: The MIB module for managing UDP implementations
.1.3.6.1.2.1.1.9.1.3.8 = STRING: View-based Access Control Model for SNMP.
.1.3.6.1.2.1.1.9.1.4.1 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.2 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.3 = Timeticks: (5) 0:00:00.05
.1.3.6.1.2.1.1.9.1.4.4 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.5 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.6 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.7 = Timeticks: (6) 0:00:00.06
.1.3.6.1.2.1.1.9.1.4.8 = Timeticks: (7) 0:00:00.07
</nowiki>

Einige nützliche OIDs. Wenn der Parameter -On weg gelassen wird, ist der Wert "Human Readable".
;Filesysteme
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.25.2.3</code>
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.25.2.3</code>
;Systeminfo
: <code>snmpget -v2c -c public localhost .1.3.6.1.2.1.1.1.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.4.0</code>
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.1.6.0</code>
;Uptime
: <code>snmpget -v1 -c public localhost .1.3.6.1.2.1.25.1.1.0</code>
; Netzwerk Daten / Transfer
: <code>snmpwalk -v2c -c public localhost .1.3.6.1.2.1.2.2.1</code>
: <code>snmpwalk -v2c -c public -On localhost .1.3.6.1.2.1.2.2.1</code>
; Prozesse
: <code>snmpwalk -v1 -c public localhost .1.3.6.1.2.1.25.4.2.1</code>

== Prozesse neu starten / Reboot Raspi über SNMP ==

Um auf Ereignisse der überwachten Prozesse zu reagieren, fragen wir die Daten wie folgt ab. Wie schon vorher beschrieben bekommt man mit dem zusätlichen Parameter ''-On'' die OIDs angezeigt.

<code> snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1 </code>

<nowiki>
root@fhem1:~# snmpwalk -v2c -c public localhost .1.3.6.1.4.1.2021.2.1
UCD-SNMP-MIB::prIndex.1 = INTEGER: 1
UCD-SNMP-MIB::prIndex.2 = INTEGER: 2
UCD-SNMP-MIB::prNames.1 = STRING: init
UCD-SNMP-MIB::prNames.2 = STRING: ser2net <- Das ist der Prozess (ID .2)
UCD-SNMP-MIB::prMin.1 = INTEGER: 0
UCD-SNMP-MIB::prMin.2 = INTEGER: 0
UCD-SNMP-MIB::prMax.1 = INTEGER: 0
UCD-SNMP-MIB::prMax.2 = INTEGER: 0
UCD-SNMP-MIB::prCount.1 = INTEGER: 1
UCD-SNMP-MIB::prCount.2 = INTEGER: 1
UCD-SNMP-MIB::prErrorFlag.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0) <- Das ist der Status (0=Prozess läuft)
UCD-SNMP-MIB::prErrMessage.1 = STRING:
UCD-SNMP-MIB::prErrMessage.2 = STRING:
UCD-SNMP-MIB::prErrFix.1 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFix.2 = INTEGER: noError(0)
UCD-SNMP-MIB::prErrFixCmd.1 = STRING: sudo /sbin/reboot
UCD-SNMP-MIB::prErrFixCmd.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart <- Damit wird der daemon neu gestartet

# bereinigte Ausgabe
root@fhem1:~# snmpwalk -v2c -c public -On localhost .1.3.6.1.4.1.2021.2.1
.1.3.6.1.4.1.2021.2.1.2.1 = STRING: init
.1.3.6.1.4.1.2021.2.1.2.2 = STRING: ser2net
.....
.1.3.6.1.4.1.2021.2.1.100.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.100.2 = INTEGER: noError(0)
.....
.1.3.6.1.4.1.2021.2.1.102.1 = INTEGER: noError(0)
.1.3.6.1.4.1.2021.2.1.102.2 = INTEGER: noError(0) <- Das ist der Status von ser2net (ID .2 = 2. zu überwachender Prozess in der snmpd.conf)
.1.3.6.1.4.1.2021.2.1.103.1 = STRING: sudo /sbin/reboot
.1.3.6.1.4.1.2021.2.1.103.2 = STRING: /usr/bin/sudo /etc/init.d/ser2net restart
</nowiki>

Um nun den Status des Prozesses ''ser2net'', welcher in ''/etc/snmp/snmpd.conf'' unter ''proc'' eingetragen ist, abzufragen, gilt folgendes Kommando. Mit dem Parameter '' -OvQw '' bekommt man nur den Wert!
<nowiki>
root@fhem1:~# snmpget -v2c -c public localhost .1.3.6.1.4.1.2021.2.1.100.2
UCD-SNMP-MIB::prErrorFlag.2 = INTEGER: noError(0)

root@fhem1:~# snmpget -v2c -c public -OvQe localhost .1.3.6.1.4.1.2021.2.1.100.2
0

</nowiki>

... In Arbeit ....
... to be continued ....
[[Raspberry Pi]]

https://sites.google.com/site/ghidit/how-to-2/using-snmp-as-a-process-watchdog

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Raspberry Pi / Rasbian und SNMP

2015-10-16T13:00:45Z

Pipp37:

Raspberry Pi / Rasbian und SNMP

2015-10-16T12:16:29Z

Pipp37: /* SNMP Befehle */

Raspberry Pi / Rasbian und SNMP

2015-10-16T12:08:19Z

Pipp37: /* SNMP Befehle */

Raspberry Pi / Rasbian und SNMP

2015-10-16T11:23:39Z

Pipp37: /* SNMP Befehle */

Raspberry Pi / Rasbian und SNMP

2015-10-16T10:52:46Z

Pipp37:

Raspberry Pi / Rasbian und SNMP

2015-10-16T10:45:13Z

Pipp37: /* SNMPD Konfiguration */

Raspberry Pi / Rasbian und SNMP

2015-10-16T10:42:59Z

Pipp37:

Raspberry Pi / Rasbian und SNMP

2015-10-16T10:04:11Z

Pipp37:

Raspberry Pi / Rasbian und SNMP

2015-10-16T10:02:35Z

Pipp37:

Raspberry Pi / Rasbian und SNMP

2015-10-16T00:29:03Z

Pipp37: Die Seite wurde neu angelegt: „{{Baustelle}} === Raspberry Pi / Rasbian und SNMP == Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''. Wei…“

{{Baustelle}}

=== Raspberry Pi / Rasbian und SNMP ==

Dieses Howto beschreibt die Installation des SNMP Daemons und der SNMP Tools am '''Raspberry Pi'''.

Weiters wird beschrieben, wie man SNMP konfiguriert um damit einen laufenden Prozess zu überwachen und bei Bedarf neu zu starten. Auch ein kompletter Neustart des Mini-Rechners über SNMP wird hier gezeigt.

[[Kategorie:Raspberry Pi]]
[[Kategorie:HOWTOS]]

Ubiquit mFi/mPower

2015-10-15T23:48:05Z

Pipp37:

== Ubiquiti mFi/mPower ==

'''Ubiquiti mFi/mPower IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''

=== WiFi Reconnects alle 2 Minuten ===
Wird kein Software-Kontroller verwendet und ist WiFi mit WPA Verschlüsselung eingestellt verliert die Leiste immer die Verbindung zum Accesspoint. 
Der Grund ist ein periodischer Neustart des WPA Dienstes in der Leiste. Auch ein Update auf die Version 2.1.11 hat das Problem nicht beseitigt.
[http://community.ubnt.com/t5/mFi/mFi-mPower-mini-disassociates-and-reassociates-to-WiFi-AP-every/m-p/1372786 Eintrag im Ubnt Forum]

''' Lösung: Im Moment stellt nur die Verwendung der unsicheren WEP Verschlüsselung das Problem ab. '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Benutzer Diskussion:Pipp37

2015-10-15T23:44:46Z

Pipp37: /* Ubiquiti mFi/mPower test */

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big>'''Hallo Pipp37,''' willkommen im FHEM Wiki!</big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]''' ''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]''' ''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]''' ''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]''' ''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]''' ''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]''' ''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [[Wikipedia:Was Wikipedia nicht ist|was Wikipedia nicht ist]], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [[wikipedia:Hilfe:Zusammenfassung und Quellen|Hilfe:Zusammenfassung und Quellen]]. 
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|meiner Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 23:00, 1. Apr. 2015 (CEST)
|}

Benutzer Diskussion:Pipp37

2015-10-15T23:44:33Z

Pipp37: /* Features */

Benutzer Diskussion:Pipp37

2015-10-13T22:59:19Z

Pipp37: /* Ubiquiti mFi/mPower */

Ubiquit mFi/mPower

2015-10-13T22:53:12Z

Pipp37:

== Ubiquiti mFi/mPower==

'''Ubiquiti mFi/mPower IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''

=== WiFi Reconnects alle 2 Minuten ===
Wird kein Software-Kontroller verwendet und ist WiFi mit WPA Verschlüsselung eingestellt verliert die Leiste immer die Verbindung zum Accesspoint. 
Der Grund ist ein periodischer Neustart des WPA Dienstes in der Leiste. Auch ein Update auf die Version 2.1.11 hat das Problem nicht beseitigt.
[http://community.ubnt.com/t5/mFi/mFi-mPower-mini-disassociates-and-reassociates-to-WiFi-AP-every/m-p/1372786 Eintrag im Ubnt Forum]

''' Lösung: Im Moment stellt nur die Verwendung der unsicheren WEP Verschlüsselung das Problem ab. '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T10:29:00Z

Pipp37: /* WiFi Reconnects alle 2 Minuten */

== Ubiquiti mFi/mPower==

'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''

=== WiFi Reconnects alle 2 Minuten ===
Wird kein Software-Kontroller verwendet und ist WiFi mit WPA Verschlüsselung eingestellt verliert die Leiste immer die Verbindung zum Accesspoint. 
Der Grund ist ein periodischer Neustart des WPA Dienstes in der Leiste. Auch ein Update auf die Version 2.1.11 hat das Problem nicht beseitigt.
[http://community.ubnt.com/t5/mFi/mFi-mPower-mini-disassociates-and-reassociates-to-WiFi-AP-every/m-p/1372786 Eintrag im Ubnt Forum]

''' Lösung: Im Moment stellt nur die Verwendung der unsicheren WEP Verschlüsselung das Problem ab. '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T10:25:00Z

Pipp37: /* WiFi Reconnects alle 2 Minuten */

== Ubiquiti mFi/mPower==

'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''

=== WiFi Reconnects alle 2 Minuten ===
Wird kein Controller verwendet und ist WiFi mit WPA Verschlüsselung eingestellt verliert die Leiste immer die Verbindung zum Accesspoint. 
Der Grund ist ein periodischer Neustart des WPA Dienstes in der Leiste. Auch ein Update auf die Version 2.1.11 hat das Problem nicht beseitigt.
[http://community.ubnt.com/t5/mFi/mFi-mPower-mini-disassociates-and-reassociates-to-WiFi-AP-every/m-p/1372786 Eintrag im Ubnt Forum]

''' Lösung: Im Moment stellt nur die Verwendung der unsicheren WEP Verschlüsselung das Problem ab. '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T10:20:34Z

Pipp37: /* Bekannte Probleme */

== Ubiquiti mFi/mPower==

'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''

=== WiFi Reconnects alle 2 Minuten ===
Wird kein Controller verwendet und ist WiFi mit WPA Verschlüsselung eingestellt verliert die Leiste immer die Verbindung zum Accesspoint. 
Der Grund ist ein periodischer Neustart des WPA Dienstes in der Leiste. Auch ein Update auf die Version 2.1.11 hat das Problem nicht beseitigt.
[http://community.ubnt.com/t5/mFi/mFi-mPower-mini-disassociates-and-reassociates-to-WiFi-AP-every/m-p/1372786 Link im Ubnt Forum]

''' Lösung: Im Moment stellt nur die Verwendung der unsicheren WEP Verschlüsselung das Problem ab. '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T09:55:35Z

Pipp37:

== Ubiquiti mFi/mPower==

'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T09:53:46Z

Pipp37: /* WiFi Frequenzen / Kanäle */

== Ubiquiti mFi/mPower==

{{Baustelle}}
'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen. '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T09:53:13Z

Pipp37: /* Bekannte Probleme */

== Ubiquiti mFi/mPower==

{{Baustelle}}
'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

=== WiFi Frequenzen / Kanäle ===
Es wurde beobachtet, dass sich die Leisten bei der Verwendung des WiFi Kanals 13 (2472 MHz) nicht verbinden.
Dieses Verhalten wurde sogar bei Kanälen ab 8 (2447 MHz) beobachtet.
Dabei wurde die Firmware 2.1.8 und 2.1.11 verwendet.

''' Lösung: WiFi Kanal von 1 - 7 (2412 MHz - 2442 MHz) bei den WLAN-Accesspoints einstellen '''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T09:32:12Z

Pipp37: /* Links */

== Ubiquiti mFi/mPower==

{{Baustelle}}
'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* mFi/mPower Firmware release 2.1.11 (4/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-11/m-p/1230774]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-10-11T09:30:11Z

Pipp37: /* Firmware Versionen */

== Ubiquiti mFi/mPower==

{{Baustelle}}
'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26
* 2.1.11 - 2015-04-16

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-04-10T21:11:02Z

Pipp37: /* Bekannte Probleme */

== Ubiquiti mFi/mPower==

{{Baustelle}}
'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

=== Zeitsynchronisation ===
Wenn die NTP Zeitsynchronisation mit der erforderliche Zeitzone nicht eingestellt wird, funktionieren gewisse Dinge wie z. B. das Summieren der Verbrauchswerte nicht.

Darum muss unbedingt der NTP Sync in der WEB-UI der Leiste nach dem Upgrade auf 2.1.8, wie in diesem Wiki beschrieben, eingestellt werden.

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]

Ubiquit mFi/mPower

2015-04-06T23:20:36Z

Pipp37:

== Ubiquiti mFi/mPower==

{{Baustelle}}
'''Ubiquiti mFi©/mPower© IP Steckdosen'''

Über WiFi/LAN schaltbare Steckdosenleiste mit Verbrauchsmessung. (LAN nur mit Pro Version)

== Features ==
230V IP-Steckdosenleiste mit unterschiedlicher Portanzahl. Jede Steckdose kann extra per Befehl geschaltet werden. Die angeschlossene Last wird gemessen und stellt folgende Werte pro Port zur Verfügung:
* Stromaufnahme
* Stromspannung
* Wirkleistungsfaktor
* aktuelle Energieaufnahme
* verbrauchte Energie - aktuelles Monat (ab Firmware 2.1.x)
* verbrauchte Energie - Vormonat (ab Firmware 2.1.x)

Protokolle
* http, https, HTTPS, telnet, ssh, ntp

== Allgemein ==
Die Leisten lassen sich komplett per Web Browser flashen,bedienen und konfigurieren. 
Die Standard Login-Zugangsdaten zur Ubi-WEB-UI lauten: User:ubnt / Passwort: ubnt

Grundsätzlich waren die Geräte in Verbindung mit der Ubiquiti Kontroller Software vorgesehen, können nun aber auch problemlos "standalone" verwendet werden.

Alle hier in diesem WIKI zusammengestellten Informationen beziehen sich auf die Verwendung der Leisten '''ohne''' Ubiquiti Kontrollersoftware.

Bei Lieferungen im April 2015 war auf allen Leisten die Firmware Version 2.0.8 installiert. Diese Firmware bietet nur rudimentäre Funktionen und auch die Energiemessung funktioniert nur in Verbindung mit der 64-Bit Java-Kontrollersoftware.
'''Darum ist ein Firmwareupdate auf mind. 2.1.8 (Stand 2/2015) notwendig.'''

== Bekannte Probleme ==

=== Verhalten nach Stromausfall===
Nach einem Stromausfall (bzw. direkt nach dem Einstecken in eine Steckdose) werden die Ports nach dem Starten der Firmware immer eingeschaltet.
Das gilt allerdings nur ohne der Verwendung der Ubiquiti Kontrollersoftware.

=== Auslieferungsfirmware Version 2.0.8 ===
* In dieser Version funktioniert die Energiemessung im Standalone-Modus nicht.
* Keine Möglichkeit die Zeitzone sowie die NTP Zeit-Synchronistaion über die WEB-UI einzustellen.

''' Lösung: Firmware auf mind. 2.1.8 upgraden.'''

== Firmware Versionen ==
Folgende Versionen wurden von Ubiquiti zum Download freigegeben.

* 2.0.7
* 2.0.8 (Download nicht auffindbar - Standard-Auslieferungsversion?
* 2.0.12
* 2.0.13
* 2.0.14
* 2.0.15
* 2.0.23
* 2.0.24
* 2.1.1
* 2.1.2
* 2.1.3
* 2.1.4
* 2.1.5
* 2.1.8 - 2015-02-26

== Modelle EU Raum ==
* 1 Port / P1E / WiFi
* 3 Port / P3E / WiFi
* 6 Port / P6E / WiFi & LAN (Pro Version)

=== Spezifikationen mPower Pro (EU)===
[[Datei:Ubi-mPower6eu.jpg|200px|thumb|right|mPower 6 Port EU]]
* Größe: 250.37 x 116.7 x 49 mm
* Gewicht: 754,4g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 6
* Speicher: 16 MB RAM, 8 MB Flash
* LAN: 1 x 10/100 Ethernet
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

=== Spezifikationen mPower (EU)===
[[Datei:Ubi-mPower3eu.jpg|200px|thumb|right|mPower 3 Port EU]]
* Größe: 240 x 82.8 x 41.5 mm
* Gewicht: 545g
* Spannung: 220-250VAC, 50Hz, 16A pro Ausgang, 16A Gesamt
* Ausgänge: 3
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: -10 bis 45°C
* Luftfeuchte: 95% max.

=== Spezifikationen mPower mini (EU)===
[[Datei:Ubi-mPower1eu.jpg|100px|thumb|right|mPower 1 Port EU]]
* Größe: 110.8 x 71 x 67.7 mm
* Gewicht: 170g
* Spannung: 220-250VAC, 50Hz, 10A
* Ausgänge: 1
* Speicher: 16 MB RAM, 8 MB Flash
* WiFi Standard: 802.11b/g/n
* LEDs: 1 LED Status
* Betriebstemperatur: 0 bis 40°C
* Luftfeuchte: 10 bis 90% Nichtkondensierend

== Hinweis zum Betrieb mit FHEM ==
Es befindet sich gerade ein neues Modul in Entwicklung. Die Infos dazu sind in dieser [http://forum.fhem.de/index.php/topic,35722.0.html Diskussion im Fhem Forum]zu finden.

== Ersteinrichtung ohne Controller ==

=== Ersteinrichtung der Leiste ohne Controller / Iphone ===

Smartphone / z.B. mit dem Iphone unter IOS7 
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk - nach ein paar Sekunden erscheint die UBI-Web Oberfläche automtatisch. (Captive Portal). Einfach warten, bis das Portal erscheint, das kann schon mal 10 bis 20 Sekunden dauern.
# Sobald das Portal sichtbar ist, das eigene WLAN auswählen und die Zugangsdaten eingeben.
# Danach den mFi Account konfigurieren. Dabei ist der Eintrag Personal auszuwählen und alles andere frei zu lassen.
# Apply dücken, die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben.
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots Iphone:
<gallery>
File:Ubi-discoverytool.JPG|Ubi Discovery Toolbox
File:Iphone-captive1.jpg|Captive Portal - select WiFi Network / mFi Account
File:Iphone-captive2.jpg|Captive Portal - select mFi Account
File:upgrade-2-0-8.jpg|UBI Web UI - upgrade.cgi
File:upgrade-2-0-8-final.jpg|UBI Web UI - upgrade.cgi done

</gallery>

=== Ersteinrichtung der Leiste ohne Controller / Windows7 ===
Ubiquiti Auslieferungs-Firmware Version: 2.0.8 (oder alle 2.x Versionen)

# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden des PC mit dem neuen WLAN Netzwerk.
# Warten bis das Fenster zum neuen Netzwerk erscheint - dann Heimnetzwerk wählen.
# Dann mit dem Firefox auf <nowiki> http://192.168.2.20 </nowiki> gehen und eine Ausnahme für das Zertifikat hinzufügen.
# Es erschein die Konfigurationsseite. Dort Network scannen und die Security Daten des WLAN eingeben. '''Beim mFi Account ist NICHTS auszuwählen - alles leer lassen! '''
# Apply dücken. Die mPower Leiste startet neu und nach ca. 1 Minute sollte sie sich mit dem WiFi verbunden haben und per DHCP eine IP-Adresse erhalten haben
# Um die IP-Adresse herauszufinden, einfach das [http://www.ubnt.com/downloads/discovery/ubnt-discovery-v2.3.zip IP-Address Ubiquiti Discovery Tool v2.3] runterladen und entpacken. Dann die .bat oder die .jar Datei doppelklicken und das Tool sucht im lokalen Netz nach UBI-Produkten.
# Nun die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin.
# Vor dem Flashen mit dem Browser normal auf die Leiste surfen. <nowiki> http://IP-Leiste</nowiki> Wechseln zum Reiter Configuration. Wenn nochmal die Konfigurationsseite kommen sollte, einfach den Kontroller neu einstellen - alles leer lassen.
# Jetzt wird die Leiste mit einem Browser geflasht (am Besten mit Firefox) indem man auf die IP der Leiste geht und direkt zur upgrade.cgi surft. '''<nowiki> http://IP-UBILeiste/upgrade.cgi</nowiki>''' - Username=ubnt / Passwort=ubnt Wenn das Upgrade fertig ist bleibt der Updatebalken bei 100% stehen.
# '''Nach dem Updaten die Ports der Leiste über die WEB Oberfläche aus- und einschalten.''' Ab sofort zählt sie dann auch die verbrauchte Energie wie gewünscht ohne Ubi-Kontroller!
# Weiter geht es mit der Einrichtung der [[#Einstellung_der_Timezone_und_NTP_Timesync|Zeitzone/Timesync]]

----
Screenshots:
<gallery>
File:Pc-wlan1.jpg|WiFi verbinden
File:Pc-wlan2-netzwerk.JPG|Netztwerktyp
File:Pc-wlan3-firefox.JPG|Firefox Zertifikat 1
File:Pc-wlan4-firefox.JPG|Firefox Zertifikat 2
File:Pc-wlan5-firefox.JPG|UBI Config UI
File:Pc-wlan7-firefox.JPG|UBI Config UI
File:Iphone-captive2.jpg|UBI FW 2.0.8 UI

</gallery>

=== Update alter 1er Firmware ===

Eine uralte Firmware (vor 2.0) auf die 2.1.8 Version upzudaten ist nur per Telnet/SSH/SCP möglich.

# Windows Benutzer bitte Putty downloaden. Es wird pscp und putty benötigt. Alle Dateien in ein einfach zu ereichendes Verzeichnis wie z.B. c:\temp downloaden. http://the.earth.li/~sgtatham/putty/latest/x86/pscp.exe http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe Linux Benutzer sollten ssh installiert haben.
# Die Firmware Version 2.1.8 von http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin downloaden. Ab der 2.1x Version gibt es für alle Leisten (1-Port, 3-Port und 6 Port) die selbe firmware.bin. Linux User Download mit: <code><nowiki> wget http://www.ubnt.com/downloads/mfi/2.1.8/firmware/M2M/firmware.bin </nowiki> </code>
# Reset der Leiste mit "Factory reset" - Drücken der reset Taste auf der Leiste für mindestend 10 Sekunden. Die Leiste startet neu hoch und erstellt einen Accesspoint mit einer eigenen SSID mit dem Namen mfi-xxxxx.
# Verbinden mit dem neuen WLAN Netzwerk. Die IP Adresse der Leiste lautet: 192.168.2.20.
# Windows Nutzer gehen auf die Eingabeaufforderung und wechseln in das Verzeichnis c:\temp. <code>c: <ENTER> cd \temp <Enter> </code>
# Dann wird die Firmware übertragen. Benutzername und Passwort lauten ubnt Windows: <code> pscp.exe -scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code> Linux: <code> scp firmware.bin ubnt@192.168.2.20:/tmp/fwupdate.bin </code>
# Nun mit SSH oder Telnet auf die Leiste gehen. Login: ubnt / Passwort: ubnt Windows: <code> putty.exe -telnet 192.168.2.20 </code> Linux: <code> ssh ubnt@192.168.2.20 </code>
# Jetzt das Firmware-Flashen anstoßen. Das abschließende & Zeichen nicht vergessen! Windows und Linux: <code> /sbin/syswrapper.sh upgrade2 & </code>
# Die LED der Leiste blinkt nach kurzer Zeitg abwechselnd orange und blau. Diesen Vorgang nicht unterbrechen!! Nach ein paar Minuten ist der Vorgang beendet.
# Abschließend noch mal einen Hardware Reset mit der Taste, wie am Anfang, machen.
# Nun kann die Leiste, wie in der Ersteinrichtung beschrieben, konfiguriert werden. Die Updateprozeduren müssen natürlich nicht nochmal ausgeführt werden.

=== Einstellung der Timezone und NTP Timesync ===
Die UBI-Web-UI der Firmware 2.1.8 zeigt 2 neue Reiter System und Machines.
Im Reiter System wird die Zeitzone eingestellt. GMT+1 Central European Time (Daylight Savings) und aktivieren Enable NTP Client mit dem Server pool-ntp.org. 
Dann den Button "Change" klicken und "Configuration contains changes. Apply these changes? APPLY"

Ab sofort hat die Leiste immer die richtige Zeit.

<gallery>

File:ubi-fw-2.1.8-ui.jpg|Web UI 2.1.8
File:ubi-zeitzone.jpg|Zeitzoneneinstellung

</gallery>

== Links ==
* Website von Ubiquiti[http://www.ubnt.com/]
* PDF Datenblatt mFi/mPower [http://dl.ubnt.com/datasheets/mfi/mFi_DS.pdf]
* Forum des Herstellers [http://community.ubnt.com/t5/mFi/bd-p/mFi]
* mFi/mPower Firmware release 2.1.8 (2/2015) [http://community.ubnt.com/t5/mFi/mFi-release-2-1-8/td-p/1188368/jump-to/first-unread-message]
* Upgrade Prozedur aus dem Ubiquiti Forum [https://community.ubnt.com/t5/mFi-Frequently-Asked-Questions/mFi-Can-I-upgrade-mFi-device-firmware-manually/ta-p/485311]
* Varia Store Deutschland (Bezugsquelle) [http://varia-store.com/Hardware/UBIQUITI-Networks:::637_734.html]
* Forenbeitrag Fhem: {{Link2Forum|Topic=35722}}

[[Kategorie:Other Components]]
[[Kategorie:IP Components]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Energieverbrauchsmessung]]