EdgeRouter X: Umzug auf die neue Firmware, ohne dass wer hinfahren muss

Im Beitrag zu Gluon 2025.1.3 hatten wir versprochen, den Ubiquiti EdgeRouter X in einem eigenen Schritt nachzuholen. Dieser Schritt ist fast geschafft: Von den 21 EdgeRouter X auf unserer Karte laufen 19 schon auf der neuen Firmware, ohne dass jemand hinfahren musste und ohne dass die Einstellungen verloren gingen.

Der EdgeRouter X hat kein WLAN. Als sogenannter „Offloader“ hängt (meistens) am Internetanschluss und schiebt den Verkehr zu unseren Supernodes, oft seit vielen Jahren und an Stellen, an die niemand mal eben herankommt. Genau deshalb war es wichtig, dieses Gerätemodell auch bei der neuen Firmware nicht zurückzulassen.

Ein Stapel schwarzer Ubiquiti EdgeRouter X von vorn, ganz unten ein breiterer EdgeRouter X SFP. Auf dem obersten Gerät steht eine gelbe Beschriftung von Hand.

27 Kilobyte zu viel

Für den Kernel, das Herzstück der Firmware, hat der EdgeRouter X zwei Fächer zu je 3 MB. Der Kernel von Gluon 2025.1 war bei unserer ersten Messung 3,03 MB groß. Es fehlten also 27 Kilobyte, weniger als ein Foto vom Handy.

Platz gibt es genug, denn die beiden Speicherplatz-Slots liegen direkt nebeneinander. Die neue Firmware nutzt sie als einen Slot mit 6 MB. Das passt für das Update auf Gluon 2025.1 nun nicht mehr, der Router lehnt die neue Firmware ab. Die übliche Anleitung für diesen Umzug löscht außerdem alle Einstellungen. Dann müsste jemand zu jedem Router hinfahren und ihn neu einrichten.

Dazu kommt ein stiller Haken: Der Router merkt erst nach dem Herunterladen, dass die neue Firmware nicht passt. Danach versucht er es beim nächsten Server und eine Stunde später wieder von vorn. Das wären rund 345 MB am Tag, für nichts. Deshalb haben die neuen Images für den EdgeRouter X einen eigenen Namen, den ein alter Router gar nicht erst sucht.

Der Umzug in vier Schritten

  1. Zwischenfirmware: Per Auto-Update kommt eine Firmware auf dem alten Stand, die zusätzlich unser Umzugspaket mitbringt.
  2. Abwarten und prüfen: Frühestens nach einer Stunde Laufzeit holt der Router die neue Firmware und prüft Signaturen und Prüfsumme.
  3. Umziehen: Er legt seine Einstellungen im Arbeitsspeicher ab, schreibt die neue Firmware, kontrolliert den Kernel und spielt die Einstellungen zurück.
  4. Neustart: Nach rund zwei Minuten ist der Router wieder da, mit Gluon 2025.1.

Name, Standort, Kontakt und alle anderen Einstellungen bleiben erhalten. Fehlt unterwegs etwas, etwa die Verbindung oder eine gültige Firmware, schreibt der Router nichts und versucht es eine Stunde später wieder.

Ganz ohne Risiko ist das nicht: Geht es beim Schreiben selbst schief, z.B. durch einen ungünstig gelegenen Stromausfall, kommt der Router nicht mehr von allein zurück, und jemand muss mit einem seriellen Kabel ran. Im Labor haben wir so viele Szenarien wie möglich nachgestellt, um den Umzug möglichst sicher zu machen.

Die Grundlage sind die Skripte von darkxst, danke dafür! Von uns kommen das Erhalten der Einstellungen und der Ablauf ohne manuellen Eingriff.

Stand derzeit

Am 1. November haben wir die Zwischenfirmware bei 18 Routern in 11 Domains von Hand (per ssh aus der Ferne) aufgespielt und den Umzug gestartet. Alle 18 kamen im ersten Versuch durch. Dazu kommt unser Testrouter. Die letzten beiden Router sollen den ganzen Weg allein gehen, sobald die Zwischenfirmware im Auto-Update steht.

Umgezogene Router erkennt Ihr auf der Karte am Modellnamen Ubiquiti EdgeRouter X KA. Das KA ist nur unser „Marker“ für Geräte, die bereits im neuen Partitionschema laufen. Das Gerät bleibt von der Hardware natürlich dasselbe.

Was Ihr tun müsst

Nichts, wenn Euer EdgeRouter X am Netz hängt und das Auto-Update eingeschaltet ist.

Falls Ihr das Auto-Update ausgeschaltet habt, kommt keine Zwischenfirmware bei Eurem Router an. Schaltet es ein oder schreibt uns an projekt@neanderfunk.de.

Liegt bei Euch ein EdgeRouter X, der lange ausgeschaltet war? Dann meldet Euch bitte, bevor Ihr ihn wieder anschließt. Sehr alte Firmware kommt mit diesem Weg vermutlich nicht klar.

Wer es genau wissen will: Die technischen Einzelheiten stehen in der Beschreibung des Pakets und in unserem Beitrag im Freifunk-Forum.