Server Dokumentation

Inhaltsverzeichnis

1 Dokumentation
- 1.1 Github vom Freifunk Nordheide
2 Wiki nordheide.freifunk.net
- 2.1 SSL Certificate
3 map.freifunk-nordheide.net
- 3.1 Die Freifunkkarte
  - 3.1.1 Karten-Backend Hopglass Server
  - 3.1.2 Karten-Frontend Hoplass

Dokumentation

Auch Server brauch hin und wieder mal einen Klapps oder etwas Hilfe. Hier einfach mal ein paar Hilfestellungen

Github vom Freifunk Nordheide

Wiki nordheide.freifunk.net

SSL Certificate

Wir verwenden für nordheide.freifunk.net SSL-Certificates von Let's Encrypt. D.h. über die root crontab wird regelmässig geprüft ob das Certificate demnächst ausläuft und die Aktualisierung angefordert. Leider gibt es verschiedene Gründe warum das evtl. schief gehen kann. Das Log liegt unter

/var/log/runJobs.log

Manuell kann man die evtl. anstehende Aktualisierung so anstoßen:

sudo /usr/local/sbin/le-renew nordheide.freifunk.net

map.freifunk-nordheide.net

Die Freifunkkarte

Karten-Backend Hopglass Server

Die Daten der Freifunkkonten werden mit einem Hopglass Server aggregiert dem Karten-Frontend (s.u.) zur Darstellung übergeben.

Der Server läuft auf Port 4000, ist unter /opt/hopglass/server/ installiert. Seine Einstellungen und zwischengespeicherten Daten liegen unter /etc/hopglass-server/ffnh/. Die Daten werden alle 5 Minuten zwischengespeichert und jede Stunde auf die letzten 7 Tage reduziert.

Betrieben wird er über systemctl restart hopglass-server@ffnh.service.

Bereitgestellte URLs:

/nodes.json HopGlass nodes.json v2
/graph.json HopGlass graph.json v1
/mv/nodes.json Meshviewer nodes.json v2
/mv/graph.json Meshviewer graph.json v1
/mv1/nodes.json Meshviewer nodes.json v1
/mv1/graph.json Meshviewer graph.json v1
/raw.json Raw data collected, same as the raw.json save file
nodelist.json format (github.com/ffansbach/nodelist)
/hosts hosts file to be placed in /etc/hosts
/metrics Prometheus metrics
/wifi-aliases.txt Aliases file for Wifi Analyzer app
/WifiAnalyzer_Alias.txt Aliases file for Wifi Analyzer app
/ffapi.json Freifunk API file
/nodes.zone Named DNS zone file

Karten-Frontend Hoplass

Die Hopglass-Karte unter map.freifunk-nordheide.de wird im Browser zusammengestellt und zeigt den aktuellen Zustand und Vernetzung der Knoten in Freifunk Nordheide. Sie nutzt eine wählbare Leaflet-Karte als Hintergrund und stellt darauf u.a. folgendes dar:

Freifunkknoten mit Geo-Koordinaten
Netzverbindung und Verbindungsqualität
Anzahl der Nutzer/Geräte am jeweiingen Knoten

Die Karten-Anwendung ist unter /home/freifunker/hopglass/build installiert und die Einstellungen in der config.json abgelegt. Diese schränkt den Kartenbereich auf 25Km rund um Buchholz und die angezeigten Knoten auf die letzten 7 Tage ein. Sie wird über den Apache ausgeliefert.