Howto/Flashen

Unter Flashen versteht man das Aufspielen einer neuen Firmware auf einen Router.

Integrität der Firmware prüfen

Wenn Du Dir das Firmware-File geladen hast, dann überprüfe es bitte mit den Prüfsummen in dem gleichen Pfad der Quelle vom Image. Damit stellst Du sicher, dass die Datei fehlerfrei durch das Netz zu Dir ging und du dir nicht etwas Korruptes in den Router programmierst.

$ md5 openwrt-ar71xx-generic-<ROUTER-MODELL>-<HW-REVISION>-squashfs-factory.bin
$ grep openwrt-ar71xx-generic-<ROUTER-MODELL>-<HW-REVISION>-squashfs-factory.bin md5sums

Die beiden 32 Bytes langen Prüfsummen müssen übereinstimmen. Wenn nicht, lösche das openwrt-….bin und lade es erneut herunter. Stimmen die Prüfsummen, kannst Du es in den Router flashen.

Orginal Firmware ersetzen

Aufspielen der neuen Firmware per Webinterface

Am Einfachsten geschieht dies über die Funktion Firmware Upgrade im Webinterface, das der Hersteller TP-Link bei seinen Modellen von Haus aus anbietet.

Schritt 1: Auf dem Router einloggen

Um die neue Firmware aufspielen zu können, müssen wir uns zunächst auf dem Router einloggen.

Dazu verbinden wir uns als ersten mit dem Netzwerk, das der neue Router "von Haus aus" aufbaut. Das geht bei den von uns verwendeten TP-Link-Geräten standardmäßig per Ethernet-Kabel oder per WLAN (der Name des WLAN lautet so etwas wie "TP-Link_FC0D32"). In beiden Fällen sollten wir uns ohne größere Konfiguration direkt mit dem Netzwerk verbinden können.

Sind wir verbunden, loggen wir uns per HTTP auf dem Webinterface des Routers ein. Die Adresse dazu ist die http://192.168.0.1/ und Nutzername und Passwort lauten standardmäßig admin.

Schritt 2: Neue Firmware aufspielen

Jetzt muss die neue Firmware (das Betriebssystem) des Routers überspielt werden. Neu aufgespielt wird die freie Software OpenWRT. In der Weboberfläche des Routers wählen wir links in der Navigation den Punkt System Tools aus. Dort finden wir den Punkt Firmware Upgrade.

Welches neue Firmware-Image wir aufspielen, hängt vom Gerätetyp ab und davon, ob das Gerät sich noch im Ursprungszustand befindet oder bereits geflasht wurde.

Wir wählen das geeignete Image aus und bestätigen mit "OK". Die Installation findet automatisch statt und der Router startet im Anschluss mit dem neuen Betriebssystem.

Schritt 3: Einloggen und Konfigurieren

Mit dem "Flashen" sind wir an dieser Stelle fertig. Der Router läuft nun mit der freien Software OpenWRT, die wir als Ausgangsbasis für unser Freifunk-Netz in Mainz verwenden. Weiter geht es mit dem Einloggen und Konfigurieren des Geräts für die Teilnahme an unserem Netz. Dazu folgen wir den entsprechenden Anleitungen.

OpenWRT neu flashen

Möchtest du das OpenWRT auf deinem bestehenden Router durch eine neue Version ersetzen, oder diesen neu aufsetzen, dann folge diesem Schema:

Schritt 1: Auf dem Router einloggen

Um die neue Firmware aufspielen zu können, müssen wir uns zunächst auf dem Router einloggen.

Hier loggst du dich über ssh auf deinem Router ein:

ssh root@<IP vom Router>

Dort besorgen wir uns die neue Firmware die wir flashen möchten.

Todo: Nach dem Domzin Umzug Link entfernen
Solltest du zu den Helden gehören, die ein Todo gelöst haben, darfst du diesen Hinweis löschen.

Die Images findest du unter images.freifunk-mainz.de (bzw. unter images.freifunk.lacerta.uberspace.de bis zum Domain Umzug).

Da der Speicherplatz auf den Plasteroutern sehr limitiert ist laden wir das neue Image in die Ramdisk:

cd /tmp
wget http://images.freifunk-mainz.de/<Ordner & Dateiname der neuen Firmware>

Alternativ kannst du diese auch von deinem Lokalen Computer auf den Router per ssh hochladen:

scp <Dateiname der neuen Firmware> root@<IP vom Router>:/tmp

Schritt 2: Neue Firmware aufspielen

Zum eigentlichen flashen hilft dir das Kommando sysupgrade.

Möchtest du deine bestehende Konfiguration überschreiben nutzt du den Flag -n, ansonsten lässt du diesen weg (Vergiss nicht deinen Tinc Schlüssel vorher zu sichern!). Weitere Optionen findest du unter sysupgrade --help:

sysupgrade -n /tmp/<Dateiname der neuen Firmware>

Der ganze Prozess müsste in etwa so aussehen:

Performing system upgrade...
Unlocking firmware ...

Writing from <stdin> to firmware ...
Appending jffs2 data from /tmp/sysupgrade.tgz to firmware...TRX header not found
Error fixing up TRX header

Writing from <stdin> to firmware ... [w]
Upgrade completed
Rebooting system...

Schritt 3: Einloggen und Konfigurieren

Hast du die alten Konfigurationsdateien mit dem Update überschrieben (-n Flag), dann meldet sich dein Router nur unter der Adresse 192.168.1.1. Um dich zu verbinden musst du dir selbst eine fixe IP-Adresse zuweisen, z.B.:

ifconfig eth0 192.168.1.2

Danach kannst du dich per telnet verbinden und ein Passwort setzen:

telnet 192.168.1.1

passwd

Weitere Informationen zu Sysupgrade im OpenWRT Wiki