--- format: markdown categories: Netz-Infrastruktur, Nodes title: Firmware ... # Download Die momentan aktuellen Versionen sind immer hier zu finden: Autoupdate-Kanal Für neu gekaufte Router (factory) Upgrade von bestehenden Freifunk-Knoten (sysupgrade) ---------------- ---------------------------------------------------------- ------------------------------------------------------------- **Stabil** (*stable*) Test (*beta*) Experimentell (*experimental*) Alle Firmware-Releases, auch archivierte und noch nicht für ein Autoupdate freigegebene Versionen können hier heruntergeladen werden: **Falls ihr euch nicht sicher seid, welche Version ihr butzen sollt bitte *immer* die stabilen (stable)-Images nutzen.** # Versionen ## Historie FFDO-Release Gluon-Version Aktuelle Kanäle Netz Erstellt am Erstellt von Änderungen ------------ ------------- --------------- ----- ----------- ------------ ---------- 0.9.2 2016.1.5 s+b+e neu 01.06.2016 Markus Gluon v2016.1.5, kein Alfred mehr, Support für 841 V11, x86 und x86-64 Images 0.9.1 2016.1.3 neu 15.04.2016 Markus Ad-Hoc anstatt 802.11s, Gluon v2016.1.3 0.9.0 2016.1.2 neu 20.03.2016 Markus Umstellung auf neue Supernodes und 802.11s statt Ad-Hoc 0.8.2 2016.1.3 alt 16.04.2016 Markus Gluon 2016.1.3 mit Fix für Flash-Bug in 2016.1.2 0.8.1 2016.1.2 alt 20.03.2016 Markus Update auf Gluon 2016.1.2 0.8.0 2016.1 alt 27.02.2016 Markus Ein Tunnel pro Node, Autoupdate-Keys von FFDO statt FFRL 0.7.2 2015.1.2 alt Update auf FFRUHR-FFDO Subdomäne 0.6.1 ffrg ## Autoupdate Es gibt drei mögliche Update-Kanäle (*Branches*), aus denen ein Knoten Firmware-Upates automatisch beziehen kann. Eine neu erstellte Firmware durchläuft immer erst die Branches *experimental* und *beta* bevor das Update als *stable* fúr alle Knoten freigegeben wird. Der zu nutzende Kanal kann im Konfigurationsmodus der Knoten ausgewählt werden. **Als Standard bei neu installierten Knoten ist immer ein Autoupdate über den *stable*-Kanal eingestellt, egal ob die Firmware aus einem anderen Kanal bezogen wurde.** Falls die Einstellung geändert wird bleibt die Änderung aber auch nach einem Update erhalten. ### Stable Bei allen Knoten, an die man nicht problemlos ran kommt und die nicht direkt von Menschen aus der FFDO-Community betrieben werden sollte der Autoupdater i.d.r. immer aktiv sein und auf *stable* gestellt sein. Es werden nur ausgiebig getestete Updates verteilt. ### Beta Knoten, auf ihr im Notfall physikalischen Zugriff habt können problemlos auf *beta* betrieben werden. Die Updates werden in den Beta-Branch gelegt wenn sie nach der Verteilung über *experimental* keine offensichtlichen Fehler mehr enthalten, aber noch ausgiebig getestet werden müssen bevor sie für alle Knoten freigegeben werden können. **Es ist wichtig, viele unterschiedliche Router-Modell im Beta-Test zu haben, da vorher nur einige wenige Modelle getestet werden können.** ### Experimental Neue Firmware, die für ein Autoupdate vorgesehen ist wird kurz nach der Erstellung in den *experimental*-Branch gelegt. Die Updates sind hier noch nicht ausgiebig getestet, es kann also passieren dass ein Router nicht mehr korrekt funktioniert nach dem Update. # Entwicklung ## Buildsystem Unsere Router-Firmware basiert auf dem [Gluon-Projekt](https://gluon.readthedocs.org/). Die FFDO-spezifische Konfiguration und die zur Erstellung der Firmware genutzten Build-Scripte werden auf Github im Repository [site-ffdo](https://github.com/ffdo/site-ffdo) gepflegt. Der Build-Vorgang ist komplett automatisiert und kann auf jedem Host mit [Docker](https://www.docker.com/) ohne großes Vorwissen nachvollzogen werden. ## Image-Server Alle Releases liegen auf Die Firmware wird im Verzeichnis "releases" versioniert abgelegt: /ffdo/releases/x.x.x/images /ffdo/releases/x.x.x/modules /ffdo/releases/y.y.y/images /ffdo/releases/y.y.y/modules Das in einem Branch aktuell ausgelieferte Release wird durch Softlinks festgelegt: /ffdo/stable -> /ffdo/releases/0.7.2 /ffdo/beta -> /ffdo/releases/0.8.0 /ffdo/experimental -> /ffdo/releases/0.8.1 ## Freigabe von Autoupdates Damit ein automatisches Update von den Knoten akzeptiert wird muss im Sysupgrade-Verzeichnis ein *Manifest* für das jeweilige Branch liegen (`stable.manifest`, `beta.manifest`, `experimental.manifest`). Das Manifest enthält SHA512-Checksummen aller Update-Dateien und den Release-Kanal. Das Manifest muss digital unterschrieben sein, damit das Update von den Knoten akzeptiert wird. Momenten sind folgene Regelungen konfiguriert: * Stable und Beta benötigen **zwei Unterschriften** zur Freigabe * Experimental benötigt nur eine Unterschrift. Schlüssel zum Unterschreiben von Firmware-Releases besitzen Till, Torben, Tim und Markus.