wget http://$(uci get configurator.@api[0].ipv6_address)%$(uci get configurator.@api[0].ipv6_interface)/dev/firmware/current/${FILE}
wget http://$(uci get configurator.@api[0].ipv6_address)%$(uci get configurator.@api[0].ipv6_interface)/dev/firmware/current/${FILE}.md5
md5sum -c ${FILE}.md5 && sysupgrade ${FILE}
</pre>
'''Tipp:''' Unter Windows kann der Inhalt der Zwischenablage durch [Umschalt]+[Einfg] in das PuTTY-Konsolenfenster eingefügt werden.
* Bei Ubiquiti Routern ggf. manuell vorgehen (siehe Möglichkeit 3).
=== Möglichkeit 3: manuelles Vorgehen ===
==== unter Linux ====
* Man loggt sich per ssh auf dem Router ein: <tt>ssh root@<ipv6%iface></tt>, siehe auch [[Anleitungen|hier]].
* Man wechselt mit <tt>cd /tmp</tt> in das richtige Verzeichnis. Das aktuelle Verzeichnis kann man sich mit <tt>pwd</tt> anzeigen lassen.
** Das Image wird auf den lokalen PC heruntergeladen und dann auf den Router hochgeladen, dazu gibst du auf deinem Rechner diesen Befehl in die Linux-Konsole ein: <tt>scp <imagename> root@[<ipv6%iface>]:/tmp</tt>, das sieht dann z.B. so aus: <tt>scp openwrt-ar71xx-generic-tl-wr741nd-v4-squashfs-sysupgrade.bin root@[fe80::fad1:11ff:fe90:3e6e%wlan0]:/tmp</tt>
** Alternativ erfolgt der Download direkt auf dem Router <tt>cd /tmp && wget http://[fe80::ff:feee:1%br-mesh]/dev/firmware/<version>/<image></tt>, z.B. <tt>cd /tmp && wget http://[fe80::ff:feee:1%br-mesh]/dev/firmware/0.5.1/openwrt-ar71xx-generic-tl-wr741nd-v4-squashfs-sysupgrade.bin</tt>
* Zuletzt führt man das Update aus: <tt>sysupgrade -n <imagename></tt>. Solange du kein sehr altes Image (vor 0.3.999) auf dem Router hast, kannst du versuchen, ohne <tt>-n</tt> zu flashen, dann bleibt das Passwort erhalten.
==== unter Windows ====
* Zuerst muss das Firmware-Image (bin-Datei mit dem Wert "sysupgrade" im Namen z.B. <tt>"openwrt-ar71xx-generic-ubnt-nano-m-squashfs-<span style="color:#FF0000">sysupgrade</span>.bin"</tt>) auf den Computer heruntergeladen werden.
* Um die Datei auf den Router spielen zu können muss man sich zuerst mit dem Freifunk-Netz verbinden (via WLAN oder LAN).
* Mit [https://winscp.net/eng/download.php WinSCP] kann man die Datei auf das Gerät kopieren.
** Dazu startet man WinSCP und wählt als Übertragungsprotokoll "SCP", gibt IPv6-Adresse des Routers, sowie "root" als User und das dazugehörige Passwort ein.
** [[Datei:Winscp-connection-settings.jpg]]
** Dann wechselt man im linken Explorer (eigener Rechner) in das Verzeichnis wo man das Image heruntergeladen hat und im rechten Explorer in das Verzeichnis "/tmp". Dann kann man die Datei mit Drag 'n Drop auf den Router hochladen.
** [[Datei:Winscp-copy-firmware.jpg]]
* ''Statt WinSCP kann auch [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PSCP] verwendet werden: <tt>pscp -scp -6 <imagename> root@[<ipv6%iface>]:/tmp</tt>''
* Danach loggt man sich via ssh (z.B. mittels [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY]) auf dem Router ein, siehe auch [[Anleitungen|hier]].
* Dann wechselt mit <tt>cd /tmp</tt> in das Verzeichnis wo das Firmware-Image hochgeladen wurde.
* Zuletzt führt man das Update aus: <tt>sysupgrade -n <imagename></tt>. Solange du kein sehr altes Image (vor 0.3.999) auf dem Router hast, kannst du versuchen, ohne <tt>-n</tt> zu flashen, dann bleibt das Passwort erhalten.
'''Bitte beachten:''' Falls der Router früher im Netmon vorhanden war, sollte nach dem Flashen der Router im Netmon gelöscht werden, der Netmon ist EOL und wird nicht mehr verwendet. Dazu einfach im Netmon einloggen: "Router" (Liste der Router) –> "Routerbezeichnung" (Router ''Bezeichnung'') –> "Routeroptionen" -> Haken bei "Router löschen" setzen –> "Löschen" anklicken.
=== Besonderheiten beim Update ===
==== Besonderheiten beim Update von Ubiquiti Routern von 0.5.0 auf 0.5.1 ====
Es ist nötig, erneut die [https://wiki.freifunk-franken.de/w/Anleitung:UbiquitiPicoStationM2HP#Funktionsweise_der_LAN-Schnittstelle_.C3.A4ndern Funktionsweise der LAN-Schnittstelle] zu konfigurieren.
Sofern die Netzwerkschnittstelle des Routers als WAN konfiguriert war, wird dringend empfohlen '''vor''' dem Flashen den Router am Heimrouter vom Internet / WAN zu trennen.
==== Besonderheiten beim Update auf 0.4.0 ====
Wenn bereits 0.4.0rc3f oder neuer installiert ist, einfach mit <tt>sysupgrade</tt> (ohne <tt>-n</tt> Schalter) updaten. Die vorherigen Versionen benötigen zum Flashen noch das <tt>sysupgrade -n</tt> (mit <tt>-n</tt> Schalter). Die alten Images (ab 0.3.999) weisen bei der Verwendung von Sysupgrade bereits auf diesen Umstand hin.
Einfache Regel: Solange du kein sehr altes Image (vor 0.3.999) auf dem Router hast, versuche, ohne <tt>-n</tt> zu flashen. Sollte die Firmware dies noch nicht unterstützen, meldet sie sich mit einer Fehlermeldung. Es geht ansonsten auch nichts kaputt, wenn du mit <tt>-n</tt> flashst.
==== Besonderheiten beim Update auf 0.3.999 ====
Durch den geänderten WLAN-Kanal 1 ist nach dem Flashen die Verbindung zu Routern mit der alten Version über Funk nicht mehr möglich. Sollen also Router aus der Ferne upgedated werden, sollte dies beachtet werden. Nach dem Update bitte im Netmon den Router-Hash zurücksetzen.
==== Besonderheiten beim Update von einer Firmware vor 0.4.0rc4f ====
Gilt nur, wenn auf dem Router eine Firmware vor 0.4.0rc4f installiert ist:
Beim Sysupgrade bitte mit <tt>-n</tt> flashen, damit die alte Config durch die neue überschrieben wird. Dies ist nötig, damit die Daten nicht falsch vermischt werden und am Ende das Passwort nicht mehr stimmt.
=== Failsafe-Modus ===
Wenn beim Flashen etwas schiefgegangen ist und der Router nicht mehr antwortet, dann gibt es als Notnagel noch den [http://wiki.openwrt.org/de/doc/howto/generic.failsafe Failsafe-Modus].
# Router einschalten
# Schalter (QSS) jede Sekunde drücken, etwa eine halbe Minute lang, bis die System-Led schnell blinkt
# IP des eigenen Rechners einstellen auf 192.168.1.2
# Telnet auf den Router 192.168.1.1
# Im Telnet-Fenster (auf dem Router) eingeben:
#: <pre>mount_root</pre>
#: <pre>passwd</pre>
#: <pre>dropbear</pre>
# Unter Windows in Cygwin oder unter Linux in der Konsole:
#: <pre>rm .ssh/known_hosts (nur falls sich scp beschwert, dass der Fingerprint nicht stimmt)</pre>
Eine schöne Anleitung zum Zurück-Flashen eines WR841 gibt es hier im [http://wiki.freifunk-mainz.de/w/Howto/Originalfirmware_zur%C3%BCckflashen Freifunk Mainz Wiki] von ''Antennen-Wolfgang''. Diese Methode funktioniert mit Sicherheit auch mit anderen TP-Link-Modellen. Eine Anleitung für den Router TP 841 mit der Firmware 9.x geht über die Anleitung vom [https://www.freifunk-gera-greiz.de/wiki/-/wiki/Allgemein/WR841N+%3CSLASH%3E+WR841ND Freifunk Gera-Greiz].
== Versionierung ==
== Versionierung ==
Beim Techniktreffen vom [[Protokolle/20160206|06.02.2016]] wurde ein neues Versionierungsschema beschlossen. Am [[Protokolle/20160210|10.02.2016]] wurden noch einige Details geklärt.
Beim Techniktreffen vom [[Protokolle/20160206|06.02.2016]] wurde ein neues Versionierungsschema beschlossen. Am [[Protokolle/20160210|10.02.2016]] wurden noch einige Details geklärt.
Eine Anleitung wie die aktuellen Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann gibt es hier.
Anleitung zur Routerinstallation
für WR841N(D) WR1043N(D)
Bitte beachte die Reihenfolge
1. Router flashen.
2. Router im Webinterface konfigurieren
(3.) Trage dich für Informationen in die Mailingliste ein.
Auspacken
Lieferinhalt
Router (1) auspacken, Teile auf Vollständigkeit überprüfen
falls die Antenne (2) noch nicht angeschlossen ist, schraubt man diese jetzt an
das Netzteil (3) für die Stromversorgung des Routers und das LAN-Kabel (4) braucht man später
Es sollte immer das original Netzteil verwendet werden um Probleme während dem Flashen zu vermeiden.
Firmware (Erst-)Installation
Router Rückseite
Hier eine Liste, welche Routertypen für die Freifunk-Franken-Firmware geeignet sind
Herauszufinden, welche Firmware man braucht, ist ganz einfach: der Routertyp (1) und die Hardwareversion (2) stehen auf der Unterseite des Routers.
Die passende aktuelle Firmware hier herunterladen.
Die Factory-Version ist zu verwenden, wenn vorher noch keine Freifunk-Firmware installiert war.
Die Sysupgrade-Version braucht man nur, wenn bereits eine Freifunk-Firmware installiert ist.
gelbe Buchse
den Computer z.B. mit dem beiliegenden Patchkabel an einen der LAN-Ports (gelb) des Routers anschließen
den Router an Strom anschließen und einschalten
warten, bis der eigene Computer eine gültige IP-Adresse bekommen hat (Falls dies nicht klappt, den Rechner neu starten und prüfen, ob die IP-Adresse automatisch vom Router bezogen wurde.)
im Webinterface des Routers einloggen (Nutzername und Passwort stehen auf der Unterseite des Routers; normalerweise funktioniert http://admin:admin@192.168.0.1)
Firmware-Update
unter "System Tools" –> "Firmware Upgrade" die vorher heruntergeladene Firmware zum Gerät schicken
Geduldig warten, bis der Router neu startet. Während die Installation läuft, ziehe bitte auf keinen Fall den Stecker oder das Netzwerk-Kabel!
Im Webinterface kann nach dem Neustart gegebenenfalls die Fehlermeldung kommen, dass keine Verbindung möglich ist. Die neue Firmware hat kein gewöhnliches Webinterface.
Anleitung zu Zugriff auf das Webinterface ist hier zu finden [1]
Ab 20160213-beta wird der Netmon nicht mehr zum konfigurieren benötigt, dies geschieht rein über das Webinterface
Wichtig:
Der Ortseintrag im Webinterface ist für die korrekte Funktion des Freifunknetzes von hoher Bedeutung.
Das Freifunk-Franken Netz ist in verschiedene Hoods segmentiert (Vgl. Portal:Netz). Ein in die falsche Hood oder ein nicht eingetragener Router, der mit anderen Routern mesht, umgeht die beabsichtigte Segmentierung und verbindet die jeweiligen Hoods auf Level 2 Ebene miteinander, wo lediglich ein Level 3 Routing stattfinden sollte.
Dies ist die momentan häufigste Ursache für Schwierigkeiten und Performance-Defizite im Freifunk Netz.
Wer seinen Standort nicht bekannt geben möchte, möge ihn im Webinterface in der gleichen Hood, in welche der Router seinen tatsächlichen Standort hat, an einem beliebigen anderen Ort platzieren.
Die Aufteilung der Hoods kann man hier einsehen, indem man im Overlay (rechte obere Ecke) die Checkbox Hoods aktiviert.
Gut geeignete Fake-Standorte sind die, die sofort als solche erkannt werden können, z.B.:
für die Fürther Hood: Mitten im Stadtparkweiher, auf der Pegnitz oder auf der Rednitz
für die Nürnberger Hood: Mitten auf dem Wöhrder See
für die Erlanger Hood: Im Schlossgarten oder auf dem Rathausplatz
ganz Allgemein: Flüsse, Seen, Flughafenrollbahnen, auf der Autobahnmitte, mitten auf dem Fußballplatz
Die richtige Angabe des tatsächlichen Standorts erachten wir selbstverständlich für vorteilhafter. Wer keinen Standort angeben möchte, möge sich einen beliebigen innerhalb derselben Hood aussuchen.
Beim Techniktreffen vom 06.02.2016 wurde ein neues Versionierungsschema beschlossen. Am 10.02.2016 wurden noch einige Details geklärt.
Begründung
Wir haben leider nicht die Men-Power um immer sicherzustellen, das die Kompatibilität nach einem Release noch oder eben nicht mehr vorhanden ist.
Dadurch ist der Interpretationsspielraum bei regulären Versionsnummern sehr hoch.
Um diesen Spielraum abzuschaffen, steigen wir auf das Datumsschema um.
Schema
Die Versionsnummer orientiert sich grundsätzlich am Datum des letzten Commits. Auf diesen Commit wird dann entsprechend das Git-Tag gesetzt.
Daraus folgt folgendes Schema:
Build ohne release Tag: YYYYMMDD-[Anzahl commits seit vorherigem Release]-[Commit-ID]
Alpha: YYYYMMDD-alpha
Beta: YYYYMMDD-beta
Release: YYYYMMDD
Sonderfall
Für den seltenen Fall, das es mehrere Tags an einem Tag geben muss, wird der Präfix entsprechend angepasst. Daraus folgt folgendes Schema:
Build ohne release Tag: YYYYMMDD.[1-n]-[Anzahl commits seit vorherigem Release]-[Commit-ID]
Alpha: YYYYMMDD.[1-n]-alpha
Beta: YYYYMMDD.[1-n]-beta
Release: YYYYMMDD.[1-n]
Beispiele
Folgendes Beispiel geht davon aus, das es eine Alpha und eine Beta auf dem selben Commit gegeben hat.
In der Beta wurde am selben Tag ein massives Problem festgestellt, deshalb gab es eine neue Beta. Diese basiert auf einem neueren Commit und wird später auch so released.
Das nächste Beispiel geht davon aus, das es auf dem selben Commit eine alpha, beta und stable gibt:
20160130-alpha
20160130-beta
20160130
Noch eine Bitte
Bitte melde dich bei unserer Mailingliste an! Die Infos dazu gibt es unter Kommunikation. Dort gibt es auch Hilfe und Support bei der Installation. Danke!
