Projekt, um die Gateway-Server eines Freifunk-Mesh-Netzwerks auf Ausfaelle zu ueberwachen.
Das Programm laeuft regelmaessig und ueberprueft, ob die Internet-Verbindung moeglich ist und DNS, DHCP und NTP funktioniert. Jeweils ueber IPv4 und IPv6.
Die Ergebnisse werden auf einen Webserver, auf dem gatemon-html laeuft, welches diese dann anzeigt.
Das Programm muss auf einem Rechner laufen, welcher als normaler Teilnehmer im Freifunk-Netz haengt.
Dieser Rechner darf kein DHCP nutzen, da der DHCP-Port von dem DHCP-Test gebraucht wird. Deswegen muss dieser eine statische IPv4-Adresse konfiguriert haben.
Ausserdem sollte er NTP-synchronisiert sein, damit er eine akkurate Zeit hat, da der gatemon-html-Server die Ergebnisse ansonsten ablehnt.
Danach braucht du einen geheimen Schluessel, damit dein Gatemon Daten an den zentralen Server senden darf.
Diesen bekommst du zur Zeit von genofire, jplitza, mortzu oder ollibaba - einfach im Chat fragen.
Anleitung, wie man einen gatemon auf einem Raspberry Pi installiert, insbesondere die Netzwerkkonfiguration, findest du im Wiki.
apt-get install monitoring-plugins-basic monitoring-plugins-standard dnsutils git make gcc curl jq
git clone https://github.com/FreifunkBremen/gatemon /opt/gatemon
cd /opt/gatemon
make check_dhcp
cp gatemon.cfg /etc/
cp gatemon.cron /etc/cron.d/gatemon
Danach musst du /etc/gatemon.cfg bearbeite:
- setze API_TOKEN auf den geheimen Schluessel, den du bekommen hast
- benenne mit GATEMON_NAME kurz deinen gatemon (bleibe unter 20 Zeichen)
- set GATEMON_PROVIDER to the name or short description of your Internet provider
- set NETWORK_DEVICE to your freifunk interface (i.e. eth0)
- leave the other entries unchanged, or ask the admin of your gatemon-html server for correct settings
cd /opt/gatemon
git pull --rebase
make check_dhcp