Geronimo/v1
Geronimo v1 wird nicht mehr aktiv weiterentwickelt. Neue Anwendungen sollten stattdessen Geronimo v2 verwenden. |
Inhaltsverzeichnis |
Überblick
Geronimo v1 ist ein zentrales Informationsframework, das insbesondere die Kartendarstellung unterstützt.
- Datenquelle Ondataservice (per OLSR AP Infos sammeln)
- Karten-Darstellung mit verbesserter Openlayers Karte
- Export nach Freifunk Nodelist API per geronimo_freifunknodelist.sh
Ziele
- Vereinheitlichung der Daten (AP namen, Daten , ...)
- Zusammenfassung aller Informationsquellen (OLSR, ondataservice, Wiki, ...)
- lose Kopplung (REST API, Erweiterbarkeit, ...)
- flexible Datengenerierung
- Speicherung Langzeitinfos
To do
-
Ablösung der Minikarte (Anzeigen der Nachbarn) -
Datenmenge reduzieren -
leere Felder weglassen in final weglassen - UGW Erreichbarkeit je AP berechnen und anzeigen
- Wiki auswerten
- ein ressourcenschonender Wiki-Reader ist in der Entwicklung
- Ansprechpartner, Standort, Foto des APs aus Wiki finden
- Vorlage:accesspoint für verteilte Wartung der Daten einführen
- Kanal/SSID Ansicht für Links
- zur Zeit nicht sinnvoll machbar, da viele APs keine Daten per OLSR liefern, was wohl an veralteter Firmware liegt
- UGW Erreichbarkeit eines Knotens
- Formatierung mit pylint prüfen
- Code cleanup
- Openlayers schrumpfen
- Wifidog Funkkegel anpassbar machen
- Zeitliche Dimension einführen, ggF. rrdtools dadurch ersetzen oder anzapfen
Architektur
Der Quellcode liegt in einem GIT Repository und ist komplett in Python geschrieben. Er gliedert sich in zwei Hauptmodule:
- geronimo.py - Backend, das die Daten zusammensammelt
- geronimoCGI.py - HTTP Frontend (CherryPy), dass an Apache gekoppelt wird
Der Datenaustausch erfolgt über die Dateien nodes.cache, links.cache (Pickle Framework) und die interne Repräsentation über einfache Objekte (siehe primitives.py). Die Backend Module, welche die Daten einsammeln liegen unter /helpers (zur Zeit nur Wiki, ondataservice DB und OLSR lastseen CSV) und diese werden über config.ini mit den richtigen Pfaden versorgt.
Das Frontend liefert derzeit geoJSON und kann wie folgt aufgerufen werden:
http://www.opennet-initiative.de/api/node/neighbours?ip=192.168.1.59 http://www.opennet-initiative.de/api/nodes/online/ http://www.opennet-initiative.de/api/nodes/offline/ http://www.opennet-initiative.de/api/links/online/
Letztere können auch mit einer Suchbox mit Mercator Koordinaten gefiltert werden
http://www.opennet-initiative.de/api/links/online?bbox=11.925507659912,54.040317086552,12.314492340088,54.119673430674
Das ganze wird durch eine verbesserte Version der Openlayers Karte im Browser angezeigt und liegt unter ./src/www.
Datenfluss
Ein cronjob ruft regelmäßig geronimo.py auf. Dort wird zunächst das lastseen Verzeichnis gelesen und ermittelt welche APs wann online waren. Danach wird eine Liste der APs aus dem Wiki generiert (Opennet Nodes) und alle APs mit wichtigen Details aus ondataservice ergänzt. Zum Schluss wird das ganze in die Cache Dateien geschrieben.
Wenn nun per Openlayers dir Karte angezeigt wird, wird die aktuelle BBOX bestimmt und ein Call auf den API-Services gemacht (je Layer). Über WSGI und Cherrypy wird dann aus der geronimoCGI.py dann der entsprechende Einstiegspunkt gewählt und abgearbeitet. Dabei werden die Cache-Dateien gelesen und je nach Anforderung nachgefiltert, sowie als JSON formatiert und ausgegeben. Openlayers parst dieses wieder auf Client-Seite und wendet basierend auf den Eigenschaften der Objekte die definierten Stile an.
Server-Installation
Der Dienst läuft derzeit auf dem WWW Server (Server/on-v6) und ist unter /var/www/geronimo/src zu finden.
In der config.ini sind die Pfade entsprechend der lokalen Einrichtung zu setzen. Das Unterverzeichnis ./www muss dann dem Apache zugänglich und über diesen statisch freigegeben werden. Außerdem muss eine zusätzliche URL (z.Z. www.on-i.de/api/) per WSGI mit geronimoCGI.py verknüpft werden. Diese öffentliche URL muss anschließend in ./www/index.html als BASE_URL=* eingetragen werden.