Opennet Firmware für Fortgeschrittene

2016-09-05T19:44:14Z

Markus: Monitoring Datensammlung aktualisiert, da jetzt Daten von allen APs abgefragt werden

= Überblick =
Die folgenden Hinweise zu erweiterten Anwendungsfällen der Opennet (bzw. Openwrt) Firmware sind meist nicht für Einsteiger geeignet. Komm vielleicht einfach zu unseren [[Aktuelle Ereignisse|regelmäßigen Treffen]], falls du Fragen dazu haben solltest.

= Monitoring eines AP =
== Einrichtung auf dem AP ==

=== Grundlegendes Monitoring (alle Firmware-Versionen) ===
Das weitverbreitete Monitoring-System [http://munin-monitoring.org munin] ist leicht auf den APs einzurichten:

opkg update
opkg install muninlite
/etc/init.d/xinetd enable
/etc/init.d/xinetd start

Nun lauscht fortan auf Port 4949 der inet-Daemon, welcher bei Bedarf das lokale muninlite startet, um entfernte Anfragen zu beantworten.

=== Erweitertes Monitoring ===
Im Vergleich zum grundlegenden Monitoring (siehe oben) werden folgende zusätzlichen Daten erfasst:
* [https://github.com/munin-monitoring/contrib/pull/668 ath9k]: Übertragungsgeschwindigkeiten und Ereignisse
* [https://github.com/munin-monitoring/contrib/pull/664 olsrd]: Verbindungsqualität und Ping-Zeiten zu Nachbarn; Routing-Umgebung
* [https://github.com/munin-monitoring/contrib/pull/663 WLAN: Kanalbelegung]
* [https://github.com/munin-monitoring/contrib/pull/723 WLAN: Signal/Noise]
* WLAN: aktuell aktiver Kanal
* Ping-Zeit zum aktiven Gateway (via Tunnel)
* Anzahl der DHCP-Leases auf dem LAN-Interface

==== Firmware v0.5.2 oder später ====
Web-Interface: installiere im Menü ''Opennet -> Basis -> Module'' das Paket ''on-monitoring''.

Konsole: <tt>on-function install_from_opennet_repository on-monitoring</tt>

==== Firmware v0.4.5 bis v0.5.1 ====
In den openwrt-Basisversionen der älteren Firmware-Versionen ist leider nicht das Paket ''micropython'' enthalten, das für die Monitoring-Plugins erforderlich ist.
opkg update
opkg install \
http://downloads.openwrt.org/chaos_calmer/15.05/ar71xx/generic/packages/packages/libffi_3.0.13-1_ar71xx.ipk \
http://downloads.openwrt.org/chaos_calmer/15.05/ar71xx/generic/packages/packages/micropython_1.4.5-20150827-936e25b164d837fc91e4bafd76580e747b235dff-1_ar71xx.ipk \
http://downloads.openwrt.org/chaos_calmer/15.05/ar71xx/generic/packages/packages/micropython-lib_0.5-20150827-bfbbf85a181d84e2494ea6f15be311734666bf67-1_ar71xx.ipk \
http://downloads.on/openwrt/stable/0.5.2/ar71xx/packages/opennet/on-monitoring_0.5.2-1697_ar71xx.ipk
Die Fehlermeldungen (postinstall-Skripte) sind akzeptabel, erfordern jedoch ein wenig Nachbehandlung:
(. /usr/lib/opennet/on-monitoring.sh; enable_suggested_munin_plugin_names wireless_channel_occupation_)
sed -i '/^PLUGINS=".*irqstats"$/s/irqstats/irqstats plugindir_/' /usr/sbin/munin-node
/etc/init.d/xinetd enable
/etc/init.d/xinetd start

== Datensammlung ==
Ist das Monitoring installiert befragt ''howmei'' deinen AP im Fünf-Minuten-Takt nach seinem aktuellen Zustand (z.B. Netzwerkaktivität, Uptime, Load, ...).

Du kannst natürlich auch auf einem eigenen Server einen munin-Sammler konfigurieren, der deinen AP abfragt.

Bedenke bitte vor der Einrichtung von munin auf einem AP, dass dadurch private Daten (z.B. Verkehrsaufkommen im Tagesverlauf) sichtbar werden können. Überwache also keinesfalls fremde APs ohne explizites Einverständnis der Nutzer.

= Patch aus dem Repository anwenden =
Falls ein Problem einer Release-Version mit einem Patch/Commit aus dem Repository zu beheben ist, dann kann folgender Aufruf verwendet werden, um einen oder mehrere Commits auf die aktuelle Firmware auf einem AP anzuwenden:

on-function apply_repository_patch GIT_COMMIT_HASH [..]

Ein Patch kann auch wieder entfernt werden:

ON_PATCH_ARGS=--reverse on-function apply_repository_patch GIT_COMMIT_HASH [..]

Die Funktion ''apply_repository_patch'' ist erst nach dem Firmware Release v0.5.2 verfügbar. Um die obige Funktion bereits in Version 0.5.2 einzusetzen, ist folgender Ablauf auszuführen (dabei wird der [https://dev.opennet-initiative.de/changeset/4eb43e1/on_firmware Commit für dieses Feature] angewandt):

opkg update && opkg install patch
wget -q -O - http://dev.on-i.de/changeset/4eb43e138606da459fcf9048c3cde5aa7634e23d/on_firmware?format=diff | patch -p4 --directory /
on-function clear_caches

= Pakete aus dem Opennet-Repository installieren / explizite Kernel-Abhängigkeiten =
Wir bauen die Opennet-Firmware zwar aus den openwrt-Quellen ohne Kernel-Anpassungen, nichtsdestotrotz hat jedoch der von uns erzeugte Kernel eine andere Build-ID, als der Kernel aus dem dazugehörigen Openwrt-Release. Daher resultiert der Versuch, ein Paket mit Abhängigkeiten vom Kernel aus dem openwrt-Repository zu installieren, etwa in folgender Fehlermeldung:
root@AP:~# opkg install tinc
Installing tinc (1.0.26-1) to root...
Downloading http://downloads.openwrt.org/chaos_calmer/15.05/ar71xx/generic/packages/packages/tinc_1.0.26-1_ar71xx.ipk.
Collected errors:
* satisfy_dependencies_for: Cannot satisfy the following dependencies
for tinc:
* kernel (= 3.18.20-1-7bed08fa9c06eb8089e82c200340ec66) *
* opkg_install_cmd: Cannot install package tinc.

Sofern das gewünschte Paket Teil des opennet-Builds ist, lässt es sich folgendermaßen installieren:
on-function install_from_opennet_repository tinc

Im Unterschied zum üblichen Aufruf von opkg gibt es dabei keine Meldungen auf der Standardausgabe, sofern der Installationprozess fehlerfrei ablief.

= Workarounds für bekannte Probleme anwenden =
Für sehr spezifische Umstände/Geräte/Situationen sind Workarounds erforderlich, um die gewünschte Funktionalität herzustellen. Diese Workarounds sind nicht Teil der Firmware, da sie:
* nur unter eng begrenzten Umständen hilfreich bzw. unschädlich sind,
* eine schlechte Lösung darstellen,
* oder nicht ohne technisches Detailwissen verwendet werden sollten.

Damit diese Workarounds nicht auf individuellen Datenträgern herumliegen, werden sie im Firmware-Repository zentral gelagert. Wer einen der Workarounds anwenden möchte, möge sich das jeweilige Skript anschauen und dann selbständig entscheiden, ob dieses Skript sein Problem löst.

Liste der Workarounds im [[Opennet_DEV|Firmware-Repository]]: https://dev.opennet-initiative.de/browser/on_firmware/opennet/workarounds

Das Auflisten, Installieren und Entfernen der obigen Workarounds ist seit v0.5.3 über die Kommandzeile möglich, z.B.:

on-workarounds install on_workaround_wifi_master_hangs minutely

= Remote Syslog =
Remote Logging kann sinnvoll sein, um problematische Zustände auf APs zu analysieren. Die APs senden dabei ihre Log-Meldungen nicht nur an den lokalen Buffer (verfügbar via ''logread''), sondern auch an den konfigurierten syslog-Server. So sind beispielweise auch nach einem Neustart des AP seine Fehlermeldungen nachvollziehbar.

== Empfänger / Server ==
Auf [[Server/howmei]] läuft ein syslog-Server, der empfänglich für fremde Nachrichten ist.

Die Ergebnisse für jeden Host liegen unter ''/var/log/opennet-hosts/...''.

Die einzige notwendige Konfigurationsänderung ist in der neu zu erstellenden Datei ''/etc/rsyslog.d/opennet-hosts.conf'' zu finden:
<pre>
$ModLoad imtcp
$InputTCPServerBindRuleset remote
$InputTCPServerRun 514

$ModLoad imudp
$InputUDPServerBindRuleset remote
$UDPServerRun 514

$template RemoteHost,"/var/log/opennet-hosts/%HOSTNAME%/syslog.log"

$RuleSet remote
*.* ?RemoteHost

$DefaultRuleset local
$RuleSet local
</pre>

Hinzu kommt noch eine logrotate-Konfiguration (/etc/logrotate.d/opennet-remote-syslog) für tägliche Kompression und Löschung nach einem Quartal:
<pre>
/var/log/opennet-hosts/*/*.log {
daily
rotate 91
compress
delaycompress
missingok
sharedscripts
postrotate
service rsyslog rotate >/dev/null
endscript
}
</pre>

== Sender / Client ==
Ein auf OpenWrt basierender Client benötigt folgende Einstellungen:
uci set "system.@system[0].log_ip=192.168.10.13"
reload_config

Alternativ ist auch im Web-Interface das Logging aktivierbar: ''Administration -> System -> Logging</pre>'' (die Host-IP ''192.168.10.13'' eintragen). Anschließend muss ''reload_config'' per Hand ausgeführt werden.

Probeweiser Meldungsversand:
echo foo | logger

[[Kategorie:Firmware]]

Opennet - Benutzerbeiträge [de]

Opennet Firmware für Fortgeschrittene