Update UBNT EdgeRouter X (X-SFP) von Gluon v2019.x (oder älter) auf Gluon v2020.1 (oder neuer)

Mit Gluon v2020.1 gab es einen Wechsel des NAND-Flash-Handlings bei Ubiquiti EdgeRouter X bzw. X-SFP. Falls defekte Flash-Speicherzellen vorhanden sind, welche bisher keine Probleme bereiteten, kann ein normales Sysupgrade von Gluon 2019.x (oder älter) auf Gluon v2020.1 (oder neuer) zu einem Soft-Brick führen!

Siehe dazu das Gluon-Issue #1937.

Es kann sehr einfach überprüft werden, ob ein normal durchgeführtes Sysupgrade von Gluon v2019.x (oder älter) auf Gluon v2020.1 (oder neuer) zu einem Soft-Brick führen wird/würde.

Bitte per SSH auf den entsprechenden EdgeRouter anmelden.

Folgende Befehlsfolge gibt Aufschluss darauf, ob bereits defekte FLASH-Zellen vorhanden sind:

dmesg | grep 'Bad eraseblock'

Kommt es zu keiner Ausgabe, dann kann der EdgeRouter sorgenfrei per autoupgrade oder per sysupgrade auf jede beliebige Gluon-Version aktualisiert werden.

Kommt es jedoch zu einer Ausgabe wie z.B.

[    1.529273] Bad eraseblock 1157 at 0x0000090a0000

dann bitte die folgend beschriebenen Schritte durchführen. Von Gluon v2019.x (oder älter) auf Gluon v2020.1 (oder neuer) per SSH-Konsole

Vorab:

Mit der folgend beschriebenen Methode wird der EdgeRouter komplett zurückgesetzt (analog zum jungfräulichen Factory-Zustand) und in den Konfigmodus versetzt. Es ist also zwingend der physische Zugriff auf den Router notwendig!

Was bei der folgend beschriebenen Methode jedoch entfällt, ist die Anwendung von TFTP in Kombination mit einem Hardware-Zugang per serieller TTL-Schnittstelle.

Anwendung der folgend beschriebenen Methode auf eigene Gefahr :)

In dem Falle, dass im nachhinein eine Community-spezifisches Freifunk-Firmware auf Basis von Gluon v2019.x (oder älter) aufgespielt werden soll, sind anstelle der weiter unten aufgeführten/verlinkten Images jene Images mit vorangeführtem "Gluon2018.1.2" zu verwenden!

» Eine übergreifender Lösungsansatz des NAND-Flash-Handling-Problems ist hier beschrieben: ERX-Sysupgrade-Problem.md «

Gluon auf UBNT EdgeRouter X und X-SFP

Mit Hilfe dieses Projektes kann ein EdgeRouter X sehr einfach über das Web-GUI der UBNT-Stockfirmware in einen Gluon-Router umgeflasht werden.

Weiterhin wird beschrieben, wie über die Konsole ein EdgeRouter X mit einer bereits aufgespielten Gluon- oder OpenWrt-Firmware auf die UBNT-Stockfirmware zurückgeflasht werden kann.

Die folgende Anleitung gilt für die Ubiquiti Router ER-X und ER-X-SFP:

EdgeRouter X	EdgeRouter X-SFP

Dieses Projekt stellt generische (Community-unabhängige) Gluon-initramfs-Factory-Images bereit.
Es handelt sich bei den Images um eine abgespeckte Gluon-Version.

UBNT EdgeRouter X und Gluon

Bei dem Bauen der Gluon-Firmware fällt aus Router-technischen Gründen kein Factory-Image für den UBNT-EdgeRouter X heraus. Wenn Gluon auf einen EdgeRouter X aufgespielt werden soll, dann muss man bisher auf die interne serielle Schnittstelle des Routers zurückgreifen, oder man muß sich mit einem generischen Lede-Image aushelfen. Es ist auf jeden Fall immer ein mehrphasiges Vorgehen inkl. Konsolennutzung notwendig.

Neuer Lösungsansatz

Folgend wird eine weitere, aber deutlich einfachere Flash-Möglichkeit beschrieben. Ein Community-spezifisches Gluon kann indirekt über den Weg des Web-GUI der UBNT-Stockfirmware auf einen EdgeRouter X geflasht werden. Die Prozedur ist ebenfalls mehrphasig.

Die hier downloadbaren generischen Gluon-Factory-Images können direkt über das Web-GUI der UBNT-Stockfirmware geflasht werden und bieten danach dann dem Nutzer die Möglichkeit, über die Gluon-Konfigseite ein Sysupgrade-Image einer beliebigen Community auf einen EdgeRouter X aufzuspielen. Die komplett abgespeckten generischen Gluon-Factory-Images sind ansonsten funktionslos.

Los geht's: Gluon auf einen EdgeRouter X flashen

Wenn ein EdgeRouter X auf Gluon umgeflasht werde soll, dann wird folgendes benötigt:

Ein hier bereitgestelltes generisches Gluon-initramfs-Factory-Image:
- Für einen EdgeRouter X: Gluon2020.1-ubnt-erx-initramfs-factory.tar
- Für einen EdgeRouter X-SFP: Gluon2020.1-ubnt-erx-sfp-initramfs-factory.tar
Ein Community-spezifisches Gluon-Sysupgrade-Image für einen EdgeRouter X, EdgeRouter X-SFP.

Phase 1 -> Generisches Gluon-Factory über das UBNT Web-GUI flashen

Ein neuer EdgeRouter X hat die feste IP 192.168.1.1, es läuft kein DHCP auf dem Router.
Der EdgeRouter X muß über den eth0-Port (WAN) mit einem PC verbunden werden.
Der verbundendene PC muss mit einer passenden statischen IP konfiguriert werden (z.B. 192.168.1.20).
Der EdgeRouter X ist nun über https://192.168.1.1/ zu erreichen.
Nach dem Login (Benutzer: "ubnt", Passwort: "ubnt") dann unten links auf 'System' klicken.
Im Fenster runterscrollen und bei "Upgrade System Image" eines der hier bereitgestellten generischen Gluon-initramfs-Factory Images verwenden.
Den Anweisungen folgen (inkl. Reboot).
Weiter mit Phase 2

Phase 2 -> Gluon-Sysupgrade über die Gluon-Konfigseite

Nach dem Booten des EdgeRouters ist die Gluon-Konfigseite per Web-Browser über http://192.168.1.1/ zu ereichen.
Der EdgeRouter X muß nun über einen der Ports eth1-4 (LAN) mit dem PC verbunden werden.
Den PC ggf. wieder so konfigurieren, dass er seine IP per DHCP erhält.
Evtl. den Browser-Cache, -Verlauf, etc. löschen. Es kann sonst zu Browser-Problemen wegen des vorherigen http"s"-Zugriffs auf 192.168.1.1 kommen.
Nun über die Gluon-Konfigseite ein Sysupgrade mit einem Sysupgrade-Image einer beliebigen Community durchführen.
Weiter mit Phase 3

Phase 3 -> Einrichten der eigenen Community-Firmware

Nach dem Booten sollte über http://192.168.1.1/ die Gluon-Konfigseite der Community-spezifischen Firmware angezeigt werden.
Konfiguration des Knotens nach eigenem Ermessen durchführen.

Done!

Per Konsole zurück zur UBNT-Stockfirmware

Gute Nachrichten:
Ein EdgeRouter X mit einer bereits aufgespielten Gluon- oder OpenWrt-Firmware läßt sich sehr einfach über die Konsole auf die original UBNT-Stockfrimware zurückflashen.

Dieses Projekt basiert auf einem initramfs-Kernel. Ein Gluon/OpenWrt EdgeRouter X kann mit Hilfe der folgenden Anleitung überredet werden, diesen initramfs-Kernel beim Booten zu laden. Danach liegt ein Gluon-System vor, welches vollständig im RAM abläuft (der Kernel, wie auch das Filesystem). Dadurch wird der Flash-Speicher von der laufenden Firmware nicht eingebunden. Somit kann dort (im Flash-Speicher) die UBNT-Stockfirmware ohne Probleme abgelegt werden. Die Prozedur ist mehrphasig.

Wenn ein Gluon- oder OpenWrt-EdgeRouter zurück auf die UBNT-Stockfirmware geflasht werde soll, dann wird folgendes benötigt:

Ein hier bereitgestelltes "Back to Stock"-initramfs-Binary
- Für einen EdgeRouter X: Gluon2020.1-back-to-stock-ubnt-erx-initramfs-kernel.bin
- Für einen EdgeRouter X-SFP: Gluon2020.1-back-to-stock-ubnt-erx-sfp-initramfs-kernel.bin
Eine original UBNT Stockfirmware für den EdgeRouter X, EdgeRouter X-SFP: https://www.ubnt.com/download/edgemax/edgerouter-x

Phase 1 -> Flashen des initramfs-Binaries

Das "Back to Stock"-initramfs-Binary irgendwie auf den umzuflashenden Gluon- bzw. OpenWrt-EdgeRouter in den Ordner /tmp transferieren (z.B. mit "scp").
Per SSH auf den umzuflashenden Gluon- bzw. OpenWrt-EdgeRouter verbinden.

Auf der Router-Konsole wird dann das "Back to Stock"-initramfs-Binary in die Flash-Kernel-Partitionen "mtdblock3" und "mtdblock4" übertragen:

Bei einem EdgeRouter X bitte folgende Befehlsfolge verwenden:

  dd if=/tmp/Gluon2020.1-back-to-stock-ubnt-erx-initramfs-kernel.bin of=/dev/mtdblock3
  dd if=/tmp/Gluon2020.1-back-to-stock-ubnt-erx-initramfs-kernel.bin of=/dev/mtdblock4

Bei einem EdgeRouter X-SFP bitte folgende Befehlsfolge verwenden:

  dd if=/tmp/Gluon2020.1-back-to-stock-ubnt-erx-sfp-initramfs-kernel.bin of=/dev/mtdblock3
  dd if=/tmp/Gluon2020.1-back-to-stock-ubnt-erx-sfp-initramfs-kernel.bin of=/dev/mtdblock4

Mit 'reboot' den EdgeRouter X neu starten.
Weiter mit Phase 2

Phase 2 -> Flashen der UBNT-Stockfirmware

Der EdgeRouter X muß über einen der Ports eth1-4 (LAN) mit einem PC verbunden werden.
Den PC ggf. so konfigurieren, dass er seine IP per DHCP erhält.
Die UBNT-Stockfirmware auf dem PC lokal entpacken und die Dateien version.tmp, squashfs.tmp, squashfs.tmp.md5, und vmlinux.tmp irgendwie auf den umzuflashenden EdgeRouter X in den Ordner /tmp transferieren (z.B. mit "scp").
Bitte wirklich /tmp als Zielpfad verwenden. Ansonsten können die folgenden Befehlsfolgen zu einem Brick des Routers führen!
Dann mittels 'ssh root@192.168.1.1' auf dem EdgeRouters X einloggen (ein Passwort wird nicht abgefragt).

Auf der Router-Konsole wird nun mit folgenden Befehlen die UBNT-Stockfirmware auf den EdgeRouters X geflasht:

ubidetach -p /dev/mtd5
ubiformat /dev/mtd5
ubiattach -p /dev/mtd5
ubimkvol /dev/ubi0 --vol_id=0 --lebs=1925 --name=troot
mount -o sync -t ubifs ubi0:troot /mnt/

cp /tmp/version.tmp /mnt/version
cp /tmp/squashfs.tmp /mnt/squashfs.img              # <- Das kann 1-2 Minuten dauern...
cp /tmp/squashfs.tmp.md5 /mnt/squashfs.img.md5

dd if=/tmp/vmlinux.tmp of=/dev/mtdblock3
dd if=/tmp/vmlinux.tmp of=/dev/mtdblock4

Mit 'reboot' den EdgeRouter X neu starten.
Weiter mit Phase 3

Phase 3 -> Einrichten der UBNT-Stockfirmware

Ein neuer EdgeRouter X hat die feste IP 192.168.1.1, es läuft kein DHCP auf dem Router.
Der EdgeRouter X muß über den eth0-Port (WAN) mit einem PC verbunden werden.
Der verbundene PC muss mit einer passenden statischen IP konfiguriert werden (z.B. 192.168.1.20).
Das UBNT Web-GUI ist nach dem Booten und nach ca. 2 Minuten per Web-Browser über https://192.168.1.1/ zu erreichen.
Evtl. den Browser-Cache, -Verlauf, etc. löschen. Es kann sonst zu Browser-Problemen wegen der vorherigen http / https-Zugriffe auf 192.168.1.1 kommen.
Nach dem Anmelden (Benutzer: "ubnt", Passwort: "ubnt") den EdgeRouter X nach Belieben konfigurieren.