Server Dokumentation: Unterschied zwischen den Versionen

Version vom 12. Dezember 2017, 01:18 Uhr

Dokumentation

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

Github vom Freifunk Nordheide

Freifunk Nordheide Github Repo

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/le-renew.log

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

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

map.freifunk-nordheide.net

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 ist unter /opt/hopglass/server/ installiert und liefert via Apache Reverse Proxy und /hopglass/ aus. Das ermöglicht Komprimierung der JSON-Responses und die Nutzung eines SSL-Zertifikats. Seine Einstellungen und Daten liegen unter /etc/hopglass-server/ffnh/. Die Daten werden alle 5 Minuten zwischengespeichert und jede Stunde auf die letzten 7 Tage reduziert.

Achtung: das letzte Release ist sehr alt und läuft nicht richtig mit der aktuellen Knotenliste. Daher mit git clone https://github.com/hopglass/hopglass-server server (ohne Release) klonen.

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
• /nodes.zone Named DNS zone file

Karten-Frontend Hopglass

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 Kartenanwendung ist unter /home/freifunker/hopglass/build installiert und die Einstellungen in der config.json abgelegt. Diese zeigt den Kartenbereich von mindestens 25Km rund um Buchholz und die neuen Knoten werden für einen Tag als grün gekennzeichnet.

Sie wird über den Apache ausgeliefert.

Nodelist

Die Kontenliste unter map.freifunk-nordheide.de/nodelist zeigt alle verfügbaren Knotendaten im Netz. Sie visualisiert die Daten (/nodes.json und /graph.json) aus obigem Hopglass-Server.

Die Karten-Anwendung ist unter /home/freifunker/nodelist installiert und wird über den Apache ausgeliefert.