Update des EdgeRouter X auf neue Firmware Gluon v2025.1
Router im Freifunk Nordhessen werden standardmäßig automatisch auf die jeweils aktuelle Firmware upgedatet. Ausnahmen sind Geräte, die nicht mehr von der aktuellen Firmware unterstützt werden oder in deren Einstellungen automatische Updates deaktiviert wurden.
Die Modelle Ubiquiti EdgeRouter X und Ubiquiti EdgeRouter X SFP erfordern für das Update auf die Nordhessen-Firmware 1.4.7 (basierend auf Gluon v2025.1) leider ein paar manuelle Eingriffe. Danach werden Updates auf zukünftige Firmware Versionen wieder automatisch erledigt.
Warum ist für diese beiden Geräte kein einfaches Update möglich?
Auf dem Speicher des EdgeRouter X und EdgeRouter X SFP existieren unter Anderem zwei 3MB große Speicherbereiche, von denen nur einer aktiv von unserer Firmware genutzt wird. Bisher hatten die 3MB ausgereicht um den sogenannten Kernel der Firmware zu speichern. Der Kernel der neuen Firmware ist größer und passt nicht mehr in diesen Speicherbereich.
Wie ermöglicht diese Anleitung, dass ein Update doch funktioniert?
Mit dieser Anleitung werden die zwei 3MB großen Speicherbereiche in einen 6MB großen Speicherbereich umgewandelt. Dies funktioniert mit Hilfe von zwei Scripten, welche diese Anpassung des Speichers vornehmen und dabei gleich die neue Nordhessen-Firmware installieren.
Kann man das nicht automatisch erledigen?
Nachdem das erste Script gestartet wird, läuft das Update automatisch durch, jedoch verliert der Router dabei alle Einstellungen. Danach ist der Konfigurationsmodus wieder aktiv und man kann, wie bei der Ersteinrichtung, Details eintragen und Einstellungen vornehmen.
Anleitung:
Für diese Anleitung wird SSH Zugriff auf den Router benötigt. Wie das funktioniert wird in dieser Anleitung beschrieben: Konfiguration eines Accesspoints aus der Ferne
Achtung!!! Alle Einstellungen werden zurückgesetzt.
Sie müssen in der Lage sein den Router nach diesem Update im Konfigurationsmodus vor Ort neu einzurichten.
Schritt 1:
Verbinden Sie sich per SSH mit dem EdgeRouter X oder EdgeRouter X SFP
Schritt 2:
Führen Sie diese zwei Befehle einen nach dem anderen auf dem Router aus.
(Text kopieren, einfügen und mit der Enter-Taste starten)
Dies lädt zwei Scripte auf den Router herunter.
wget -P /tmp/ http://firmware01.ffnordhessen.net/tools/gluon-v2025-erx-migration/ubnt_erx_migrate.sh
wget -P /tmp/ http://firmware01.ffnordhessen.net/tools/gluon-v2025-erx-migration/ubnt_erx_stage2.sh
Schritt 3:
Führen Sie nun den für ihr Modell bestimmten Befehl auf dem Router aus.
(Text kopieren, einfügen und mit der Enter-Taste starten)
Dies lädt die neue Nordhessen-Firmware als Datei auf den Router herunter.
Für den EdgeRouter X:
wget -O /tmp/sysupgrade.img http://firmware01.ffnordhessen.net/firmwares/1.4.7/images/sysupgrade/gluon-ff_nh-1.4.7-ubiquiti-edgerouter-x-sysupgrade.bin
Für den EdgeRouter X SFP:
wget -O /tmp/sysupgrade.img http://firmware01.ffnordhessen.net/firmwares/1.4.7/images/sysupgrade/gluon-ff_nh-1.4.7-ubiquiti-edgerouter-x-sfp-sysupgrade.bin
Schritt 4:
Bevor der Update-Prozess gestartet werden kann, muss mit diesem Befehl die Script-Datei ausführbar gemacht werden.
(Text kopieren, einfügen und mit der Enter-Taste starten)
Wenn dies erfolgreich war, erscheint keine Rückmeldung.
chmod +x /tmp/ubnt*.sh
Schritt 5:
Mit diesem Befehl wird nun ein Script gestartet, was den Update-Prozess übernimmt.
(Text kopieren, einfügen und mit der Enter-Taste starten)/tmp/ubnt_erx_migrate.sh
Es erscheint danach folgende Meldung:
Diese Abfrage bitte mit “y” bestätigen. Es beginnt dann der Updateprozess. Ab dann darf auf keinen Fall die Stromversorgung getrennt werden, bis das Update abgeschlossen ist.
Schritt 6:
Nun können Sie ihren Computer per Netzwerkkabel an den Port eth1 des EdgeRouter X oder EdgeRouter X SFP anschließen und wie bei der Ersteinrichtung mit dem Webbrowser unter der IPv4-Adresse 192.168.1.1 die benötigten Einstellungen vornehmen. Eine Anleitung dazu finden Sie hier: #FFNordhessen Tutorial: Freifunk-Firmware Config Oberfläche
Ihr EdgeRouter X oder EdgeRouter X SFP ist nun mit der aktuellen Nordhessen-Firmware ausgestattet und für zukünftige Updates bereit. 😀
