Skip to content
Script to monitor the gateway servers of a Freifunk mesh network for outages
Shell C Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
checks
.SRCINFO
.gitignore
LICENSE
Makefile
PKGBUILD
README.md
VERSION
check_dhcp.c
gatemon-setup.nonroot.service
gatemon-setup.nonroot.sh
gatemon.cfg
gatemon.cron
gatemon.nonroot.service
gatemon.root.service
gatemon.sh
gatemon.timer

README.md

Gatemon

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.

Abhaengigkeiten

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.

Installation (als root)

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

Update (as root)

cd /opt/gatemon
git pull --rebase
make check_dhcp
You can’t perform that action at this time.