Geronimo: Unterschied zwischen den Versionen

Aus Opennet
Wechseln zu: Navigation, Suche
(+Freifunk)
Zeile 72: Zeile 72:
 
Der Dienst läuft derzeit auf dem WWW Server ([[Server/on-v6]]) und ist unter '''/var/www/geronimo/src''' zu finden
 
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.
 
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.
 +
 +
 +
==Siehe auch==
 +
* [[Freifunk API]]
  
 
[[Category:Software]]
 
[[Category:Software]]

Version vom 31. Dezember 2014, 09:31 Uhr

Team
Geronimo Logo.png
Geronimo
Treffen: nur bei Bedarf
Opennet Karte
Mitglieder:
Matthias M.
Kontakt:
admin@opennet-initiative.de


Inhaltsverzeichnis

Vorbemerkung

Geronimo ist ein zentrales Informationsframework, dass insbesondere die Kartendarstellung unterstützt.

Ziele

  • Vereinheitlichung der Daten (AP namen, Daten , ...)
  • Zusammenfassung aller Informationsquellen (OLSR, ondataservice, Wiki, ...)
  • lose Kopplung (REST API, Erweiterbarkeit, ...)
  • flexible Datengenerierung
  • Speicherung Langzeitinfos

Openlayers

(Kartendarstellung im Web)

  • sofortige ondemand Updates der Daten
  • schnelleres laden (geoJSON, BBOX, ...)
  • mehr Informationen (Kanäle)
  • optimiertes UI

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 eigenen SVN 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.

Ablauf

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.

Einrichtung

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.


Siehe auch

Meine Werkzeuge
Namensräume

Varianten
Aktionen
Start
Opennet
Kommunikation
Karten
Werkzeuge