Freifunk Firmware fuer Wiesbaden ================================ Hier findet ihr die aktuelle Gluon Firmware fuer Wiesbaden. Bitte lest euch diese paar Saetze sorgsam durch ... Unsere Firmware basiert auf Gluon. Gluon ist ein modulares Framework mit dessen Hilfe man eine Firmware fuer WLAN Mesh Knoten erstellen kann. Dieses Framework basiert auf OpenWRT und wird von vielen Freifunk Communities in Deutschland verwendet. Gluon Dokumentation: http://gluon.readthedocs.org Gluon Source (Basis): https://github.com/freifunk-gluon/gluon Gluon Source (Pakete): https://github.com/freifunk-gluon/packages W A R N U N G ============= Die Firmware die du hier findest ist eine reine Schenkung von uns an dich. Du installiert diese auf deine eigene Gefahr! Wenn du Probleme feststellst, dann helfen wir dir selbstverstaendlich gerne dabei diese zu analysieren. Branches ======== Die aufgefuehrten Firmware Branches repraesentieren jeweils einen Entwicklungszweig bzw. Konfigurationsstand der Gluon Firmware mit unterschiedlichem Reifegrad und unterschiedlicher Stabilitaet. Stable ------ Sagt schon alles Noetige. Nimm diese Firmware, wenn du einen normalen Freifunk-Knoten flashen willst. Diese basiert naemlich auf der stabilen Version von Gluon. Dieser Firmware Stand ist ausgiebig getestet und die Wahrscheinlichkeit, dass gravierende Probleme auftreten ist aeusserst gering. Erforderliche Signaturen: 4 (Autoupdater) Beta ---- Der "Beta" Branch wird von uns verwendet, um neue stabile Gluon Versionen vorab mit der Wiesbadener Freifunk Konfiguration zu testen. Wenn wir unsere Tests abgeschlossen haben und keine Probleme festgestellt haben, erstellen wir neue Firmware Images fuer den "Stable" Branch. Wenn du auch bereit bist neue Versionen in diesem fruehen Reifestadium auf ausgewaehlten Knoten zu testen, darfst du das natuerlich gerne machen. Wenn du Probleme feststellst erstell am Besten ein neues Issue auf Github. Erforderliche Signaturen: 3 (Autoupdater) Experimental ------------ Im "Experimental" Branch findest du die Firmware, die auf dem aktuellsten Entwicklungsstand der Gluon Firmware basiert, also "Cutting Edge". Diese Firmware wird regelmaessig automatisiert erzeugt. Wir haben diese nicht getestet und raten davon ab diese auf normalen Freifunk-Knoten zu flashen. Wenn du unbedingt total neue Funktionen benoetigst und nicht bis zur stable Version warten kannst oder mitentwickeln moechtest macht dieser Branch fuer dich erst Sinn. Die Wahrscheinlichkeit, dass unerwartete Fehler auftreten oder dein Freifunk-Knoten gar nicht mehr funktioniert ist gross! Erforderliche Signaturen: 1 (Autoupdater) Autoupdater =========== In unserer Firmware ist die Autoupdater Funktion standardmaessig aktiviert und fuer den Firmware Branch "stable" eingestellt. Die Autoupdater Funktion ist dafuer gedacht um dir als Knotenbetreiber Arbeit abzunehmen. Sie traegt auch dazu bei das Freifunk-Netz auf einen moeglichst aktuellen technischen Stand zu halten. Der Autoupdater prueft regelmaessig ob neue Firmware Versionen verfuegbar sind. Wenn das der Fall ist wird dein Knoten automatisch geupdatet, i.d.R. nachts. So ganz stimmt das nicht. Der Autoupdater wird eine neue Firmware Version erst installieren, wenn _alle erforderlichen Signaturen_ vorhanden sind, die zudem noch valide sein muessen. Das soll verhindern, dass sich eure Knoten neue Firmware von boesen Hackern herunterladen, die dann boese Dinge macht. Was ist diese Signatur? Jeder Freifunk Admin hat ein eigenes Schluesselpaar, bestehend aus einen oeffentlichen und einen geheimen Schluessel. Die oeffentlichen Schluessel werden von uns in die Freifunk Firmware integriert, der geheime Schluessel wird von jedem Admin sorgsam geheim gehalten. Jeder Admin unterschreibt eine neue Firmware Version mit seinem geheimen Schluessel. Mit dem oeffentlichen Schluessel koennen die Knoten ueberpruefen ob die Signaturen (Unterschriften) auch echt sind. Bevor der Autoupdater also eine neue Firmware Version auf deinen Knoten installiert, prueft dieser: 1. ob die erforderliche Anzahl an Signaturen vorhanden ist und 2. ob jede einzelne Signatur auch wirlich valide ist und nicht von fehlerhaft ist oder von einem boesen Hacker stammt Die hier erklaerten Firmware Branches findest du auch im Config-Mode der Freifunk-Knoten wieder. Dort kannst du ihn ein- bzw. ausschalten und auch den von dir gewuenschten Firmware Branch einstellen. Wir empfehlen die Autoupdater Funktion aktiviert zu lassen. Viele Gruesse und viel Spass mit Freifunk! Das Admin-Team