Zum Inhalt springen

Geronimo: Unterschied zwischen den Versionen

Aus Opennet
Inhalt gelöscht Inhalt hinzugefügt
weitere Ergänzungen
Ersetze irreführende Versionsnummer durch HTTP-API-Verweis
 
(27 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{team
[[Image:Geronimo Logo.png|thumb|gerONImo - ein Geist der über allen APs schwebt ;)]]
|description=Geronimo
Geronimo ist ein zentrales Informationsframework, dass insbesondere die Kartendarstellung unterstützt.
|nextMeeting=nur bei Bedarf
* Datenquelle [[ondataservice]] (per [[OLSR]] AP Infos sammeln)
|members=[[Benutzer:Matthias M|Matthias M.]], [[Benutzer:Lars|Lars]]
* Karten-Darstellung mit verbesserter [[Openlayers]] Karte
|kontakt=[mailto:admin@opennet-initiative.de admin@opennet-initiative.de]
|logo=Geronimo Logo.png
}}


==Ziele==
== Überblick ==
Geronimo ist ein zentrales Framework für die Sammlung und Verteilung Opennet-relevanter Informationen. Der Fokus liegt auf der Verwendbarkeit durch Dienste.
*Vereinheitlichung der Daten (AP namen, Daten , ...)
*Zusammenfassung aller Informationsquellen (OLSR, ondataservice, Wiki, ...)
*lose Kopplung (REST API, Erweiterbarkeit, ...)
*flexible Datengenerierung
*Speicherung Langzeitinfos


Status:
===Openlayers===
* Geronimo (alt, auslaufender Betrieb, keine HTTP-API) wird genutzt von:
(Kartendarstellung im Web)
** alte [[Openlayers|Karte]]: https://opennet-initiative.de/map
*sofortige ondemand Updates der Daten
** Wiki: https://on-i.de/wiki/Extension:APData
*schnelleres laden (geoJSON, BBOX, ...)
* [[Geronimo/v2|Geronimo]] (neu, mit HTTP-API, aktiv in Betrieb und Entwicklung) wird genutzt von:
*mehr Informationen (Kanäle)
** API zur Abfrage von Routing- und Geräteinformationen: https://api.opennet-initiative.de/
*optimiertes UI
** neue [[Openlayers|Karte]]: https://map.opennet-initiative.de/
** Kartendarstellung auf der Status-Seite jedes AP


==To do==
== Siehe auch ==
* [[Freifunk API]]
* <s>Ablösung der Minikarte (Anzeigen der Nachbarn)</s>
* [[Karte]]
* <s>Datenmenge reduzieren </s>
* <s>leere Felder weglassen in final weglassen</s>
* 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

==Architektur==
Der Quellcode liegt in einem [http://svn.on-i.de/listing.php?repname=on_geronimo&path=%2F&sc=0 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 ([http://cherrypy.org 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 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:
<pre>
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/
</pre>
Letztere können auch mit einer Suchbox mit Mercator Koordinaten gefiltert werden
<pre>
http://www.opennet-initiative.de/api/links/online?bbox=11.925507659912,54.040317086552,12.314492340088,54.119673430674
</pre>
Das ganze wird durch eine verbesserte Version der [[Openlayers]] Karte im Browser angezeigt und liegt unter ./src/www.


===Ablauf===
*cronjob ruft geronimo.py auf
*WSGI generiert Seiten mittels geronimoCGI.py (Cherrypy framework)
*Features nodes, links, neighbours, bbox


==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.


[[Category:Software]]
[[Category:Software]]

Aktuelle Version vom 3. Februar 2025, 14:10 Uhr

Team

Geronimo
Treffen: nur bei Bedarf
Geronimo
Mitglieder:
Matthias M., Lars
Kontakt:
admin@opennet-initiative.de


Überblick

Geronimo ist ein zentrales Framework für die Sammlung und Verteilung Opennet-relevanter Informationen. Der Fokus liegt auf der Verwendbarkeit durch Dienste.

Status:

Siehe auch