|
|
| (170 dazwischenliegende Versionen von 23 Benutzern werden nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| {{Entwurf}}
| | = Der wichtigste Hinweis zuerst = |
| | |
| <div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; background-color:#ffFF00;">
| |
| <b><center>Für ältere Versionen (vor 20160213-beta) [https://wiki.freifunk-franken.de/mediawiki/index.php?title=Anleitungen&oldid=5828 hier] gucken</center></b>
| |
| </div>
| |
| | |
| = Firmware =
| |
| Diese Anleitung ist ab der 20160213-beta gültig!
| |
| | |
| Aktuell ist die Version 20160310/ https://dev.freifunk-franken.de/firmware/current/
| |
| | |
| Eine Anleitung wie die aktuellen Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann gibt es [[FirmwareEntwicklung|hier]].
| |
| | |
| '''Tipp:''' Die Inbetriebnahme eines mit FF-Firmware geflashten Router/Registrierung zum Weitergeben/Ausdrucken als [[media:Anleitung_zur_Inbetriebnahme_eines_Freifunkrouters.pdf|PDF]].
| |
| | |
| == 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 ===
| |
| [[Datei:dein_router.jpg|400px|thumb|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 ===
| |
| [[Datei:TP_link_version.jpg|400px|thumb|Router Rückseite]]
| |
| | |
| * Hier eine [[Portal:Hardware|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 [https://dev.freifunk-franken.de/firmware/current/ 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.
| |
| | |
| [[Datei:gelbe_buchse.jpg|400px|thumb|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)
| |
| | |
| [[Datei:TP_link_firmware.jpg|400px|thumb|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.
| |
| * Das Passwort sollte geändert werden! Siehe [[Anleitungen|hier]].
| |
| | |
| === Konfigurieren über das Webinterface ===
| |
| | |
| Anleitung zu Zugriff auf das Webinterface ist hier zu finden [https://wiki.freifunk-franken.de/w/Anleitung_ab_20160213-beta#Zugriff_auf_das_Webinterface_zum_konfigurieren]
| |
| Ab 20160213-beta wird der Netmon nicht mehr zum konfigurieren benötigt, dies geschieht rein über das Webinterface
| |
| | |
|
| |
|
| <div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; border:2px solid #dc0067;color:#000;"> | | <div style="margin-bottom:1em; padding:1em 1em 0.5em 1em; border:2px solid #dc0067;color:#000;"> |
| <b>Wichtig:</b><br/> | | Einen Freifunkrouter stellt man nicht einfach hin und überlässt ihn sich selbst – wie es eigentlich für sämtliche am Internet angeschlossene Geräte gilt, wenn es auch oft genug nicht beachtet wird –, sondern man übernimmt langfristig Verantwortung, <abbr title="vor allem">v. a.</abbr> was regelmäßige Updates und Übernahme größerer Änderungen im Netzwerk angeht. Diese werden mit hinreichend großem Vorlauf angekündigt. Wenn diese trotzdem nicht beachtet werden, läuft man Gefahr, dass der Router irgendwann nicht mehr funktioniert oder, wenn er Störungen im Netz produziert, gesperrt wird. Das gilt gerade auch für Freifunkrouter, wo eigene Modifikationen – die wir explizit unterstützen, solange sie das Netz nicht stören und kompatibel zu unseren Netz sind – vorgenommen wurden. |
| 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.
| | '''Der Routeraufsteller/Betreiber ist für seinen Router verantwortlich. Dies gilt auch für die Einstellungen wie <abbr title="zum Beispiel">z. B.</abbr> Sendeleistung.''' |
|
| |
|
| Die Aufteilung der Hoods kann man [https://monitoring.freifunk-franken.de/map hier] einsehen, indem man im Overlay (rechte obere Ecke) die Checkbox Hoods aktiviert.
| | Auch sollte man Netzwerkkenntnisse mitbringen. Aber keine Panik: Freifunkrouter sind im Allgemeinen nicht pflegeintensiv. |
|
| |
|
| Gut geeignete Fake-Standorte sind die, die sofort als solche erkannt werden können, z.B.:
| | Durch das Betreiben eines Freifunkrouters stimmt man dem [[PicoPeeringAgreement | Pico Peering Agreement]] (PPA) zu. |
| * 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.
| |
| </div> | | </div> |
|
| |
|
| == Firmware-Update == | | = Die richtige Hardware auswählen = |
|
| |
|
| Wenn bereits eine Freifunk-Franken-Firmware auf dem Router installiert ist, geht man zum Updaten nach einer der folgenden Methoden vor:
| | Das [[Portal:Hardware#Empfehlung_bei_Neukauf | Portal Hardware]] enthält eine Liste unserer unterstützten Geräte. |
|
| |
|
| === Möglichkeit 0: Webinterface ===
| | Im Zweifel nimm [[Portal:Kommunikation|Kontakt]] mit der Community auf, hier wird dir weitergeholfen wenn du Probleme hast. |
| Man wählt im Webinterface den Menüpunkt Update an und läd dort die neue sysupgrade Datei hoch.
| |
|
| |
|
| === Möglichkeit 1: sysupgrade.sh === | | == Die richtige Firmware Variante auswählen == |
| '''<span style="color:#FF0000">Achtung: Funktioniert erst <u>ab</u> Firmware Version 0.5.1</span>'''
| | Seit dem Release im Dezember 2019 gibt es zwei verschiedene Varianten der Firmware: |
| * Man loggt sich auf dem Router per ssh ein, siehe auch [[Anleitungen|hier]]. | | * die Node Firmware, die mit dem zentralen [[KeyXchangeV2|KeyXchange-V2]] laufen. (Empfohlen für Anfänger mit dem ersten Freifunk-Router.) |
| * Und startet folgendes Skript ''/etc/sysupgrade.sh''
| | * die neue Layer3-Firmware für ein dezentrales Netz. Mehr unter [[Layer3Firmware]] und [[Layer_3_Firmware]]. (Aufwändiger, dafür dezentral.) |
|
| |
|
| === Möglichkeit 2: Skript einfügen ===
| | Der Vorteil der "dezentralen Firmware" wird unter [[Layer_3_Firmware#Redundanz|Layer_3_Firmware -> Redundanz]] beschrieben. |
| * Man loggt sich auf dem Router per ssh ein, siehe auch [[Anleitungen|hier]].
| |
| * Man fügt in das Fenster der Konsole dieses Skript ein und bestätigt gegebenenfalls mit [Enter]:
| |
| <pre>
| |
| BOARD=$(cat /var/sysinfo/board_name)
| |
| case "$BOARD" in
| |
| tl-wr1043nd)
| |
| BOARD=tl-wr1043nd-v1
| |
| ;;
| |
| tl-wr741nd)
| |
| grep "Atheros AR7240 rev 2" /proc/cpuinfo && BOARD=tl-wr741nd-v2 || BOARD=tl-wr741nd-v4
| |
| ;;
| |
| tl-wr741nd-v4)
| |
| grep 740 /var/sysinfo/model && BOARD=tl-wr740n-v4
| |
| ;;
| |
| tl-wr841n-v7)
| |
| BOARD=tl-wr841nd-v7
| |
| ;;
| |
| tl-wr841n-v9)
| |
| grep "v10" /var/sysinfo/model && BOARD=tl-wr841n-v10
| |
| ;;
| |
| nanostation-m)
| |
| BOARD=ubnt-nano-m
| |
| ;;
| |
| tl-wa860re)
| |
| BOARD=tl-wa860re-v1
| |
| ;;
| |
| tl-wdr3500)
| |
| BOARD=tl-wdr3500-v1
| |
| ;;
| |
| tl-wdr4300)
| |
| grep "3600" /var/sysinfo/model && BOARD=tl-wdr3600-v1
| |
| grep "4300" /var/sysinfo/model && BOARD=tl-wdr4300-v1
| |
| grep "4310" /var/sysinfo/model && BOARD=tl-wdr4310-v1
| |
| ;;
| |
| esac
| |
|
| |
|
| case $BOARD in
| | = Firmware-Installation = |
| tl-wdr4900-v1 )
| | == Firmware-Download == |
| SOC="mpc85xx" ;;
| | Die aktuelle Version findet man hier: |
| * )
| | * Node: https://dev.freifunk-franken.de/node/ |
| SOC="ar71xx" ;;
| | * Layer-3: https://dev.freifunk-franken.de/layer3/ |
| esac
| |
|
| |
|
| FILE="openwrt-${SOC}-generic-${BOARD}-squashfs-sysupgrade.bin"
| | Adrian Schmutzler stellte bis 2020 verschiedene alternative Firmwares auf seiner Seite zur Verfügung: https://freifunk.jubt.org/fff-firmware.php |
| echo "Loading $FILE"
| |
| cd /tmp/
| |
| 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.
| | Mehr Infos zu den Dateinamen der Firmware sind zu finden unter: [[Anleitungen#Aufbau_des_Dateinamens_der_Firmware|Anleitungen -> Aufbau_des_Dateinamens_der_Firmware]] |
| * Bei Ubiquiti Routern ggf. manuell vorgehen (siehe Möglichkeit 3).
| |
|
| |
|
| === Möglichkeit 3: manuelles Vorgehen === | | === Checksumme prüfen === |
| ==== unter Linux ====
| | Für jede Firmware-Datei gibt es eine Datei mit der SHA256-Prüfsumme, um den korrekten Download zu überprüfen. Früher gab es zusätzlich MD5-Prüfsummen. |
| * 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 ==== | | ==== Linux ==== |
| | christiand@christianpc:/tmp/fw$ ls |
| | fff-layer3-20200118-archer-c25-v1-factory.bin fff-layer3-20200118-archer-c25-v1-factory.bin.sha256 |
| | christiand@christianpc:/tmp/fw$ sha256sum -c fff-layer3-20200118-archer-c25-v1-factory.bin.sha256 |
| | fff-layer3-20200118-archer-c25-v1-factory.bin: OK |
|
| |
|
| * 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. | | Sollte beim Download was fehlgeschlagen sein (hier wurde zum Test händisch die *.bin manipuliert) kommt es zu folgender Ausgabe, die Firmware sollte dann keinesfalls geflasht 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:''' Nach dem Flashen sollte der Router-Hash im Netmon gelöscht werden, damit Router und Netmon einen neuen Hash aushandeln können. Dazu einfach im Netmon einloggen: "Router" (Liste der Router) –> "Routerbezeichnung" (Router ''Bezeichnung'') –> "Routeroptionen" -> "Konfig. bearbeiten" –> "Router auto assign Hash zurücksetzen".
| | christiand@christianpc:/tmp/fw$ sha256sum -c fff-layer3-20200118-archer-c25-v1-factory.bin.sha256 |
| | fff-layer3-20200118-archer-c25-v1-factory.bin: FEHLSCHLAG |
| | sha256sum: WARNUNG: die 1 berechnete Prüfsumme passte NICHT |
|
| |
|
| Der SSH-Fingerprint ändert sich beim Update.
| | ==== Windows ==== |
| | Unter Windows 10 und 11 kann über PowerShell mit dem Befehl <code>Get-FileHash</code> der Hash erzeugt und dann manuell mit dem Inhalt der .md5- und .sha256-Datei verglichen werden. |
|
| |
|
| === Besonderheiten beim Update ===
| | <pre> |
| ==== Besonderheiten beim Update von Ubiquiti Routern von 0.5.0 auf 0.5.1 ====
| | PS C:\> Get-FileHash -Path C:\Temp\fff-node-20230330-tplink_c2600-factory.bin -Algorithm MD5 |
| 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.
| | Algorithm Hash Path |
| | --------- ---- ---- |
| | MD5 F1D1F031B5EC7982648179D12D9915CB C:\Temp\fff-node-20230330-tplink_c2600-factory.bin |
|
| |
|
| ==== 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.
| | PS C:\> Get-FileHash -Path C:\Temp\fff-node-20230330-tplink_c2600-factory.bin -Algorithm SHA256 |
|
| |
|
| ==== Besonderheiten beim Update auf 0.3.999 ====
| | Algorithm Hash Path |
| 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.
| | --------- ---- ---- |
| | | SHA256 C6B9AEFA786E0BEE4B7CC065AE86DF9C3818E1DB33C3AA9D0F94B212F16B79A3 C:\Temp\fff-node-20230330-tplink_c2600-factory.bin |
| ==== Besonderheiten beim Update von einer Firmware vor 0.4.0rc4f ====
| | </pre> |
| 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>
| |
| #: <pre>scp '/pfad/zur/datei/openwrt-ar71xx-generic-tl-wr841nd-v7-squashfs-factory.bin' root@192.168.1.1:/tmp</pre>
| |
| # Im Telnet-Fenster (auf dem Router):
| |
| #: <pre>sysupgrade -n /tmp/openwrt-ar71xx-generic-tl-wr841nd-v7-squashfs-factory.bin</pre>
| |
| # Abwarten und den Router '''nicht''' ausschalten, er rebootet von alleine.
| |
|
| |
|
| Wenn das nicht geklappt hat, dann schau [http://wiki.openwrt.org/de/doc/howto/generic.debrick hier her].
| | ==== macOS ==== |
| | ;Öffne das Terminal |
| | ;um einen MD5 Hash zu generieren gebe |
| | : <code>md5</code> und den Dateipfad ein. (Einfach der Drag & Drop aus dem Finder)<br /> |
| | ;um einen SHA256 Hash zu generieren gebe |
| | : <code>shasum -a 256</code> und den Dateipfad ein. (Einfach der Drag & Drop aus dem Finder) |
|
| |
|
| Eine schrittweise Anleitungen zum Wiederbeleben eines defekten Routers, der nicht mehr durchstartet gibt es auch hier:
| | == Firmware-Installation == |
|
| |
|
| https://wiki.freifunk-franken.de/w/Unbricken_eines_TP-Link_1043ND
| | Die Installation ist je nach Modell sehr unterschiedlich, hier eine Liste diverser Modelle: |
|
| |
|
| === Reflash zur Orginal TP-Link Firmware ===
| | * [[Firmwareinstallation/edgerouterx|ER-X / ER-X-SFP / EP-R6]] |
| 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].
| | * [[Firmwareinstallation/Xiaomi Mi Router 4A|Xiaomi Mi Router 4A]] |
| == Versionierung ==
| | * [[Firmwareinstallation/Fritzbox_4040|Fritzbox 4040]] |
| 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.
| | * [[Firmwareinstallation/edgerouter4|Edgerouter 4]] |
| | * [[Firmwareinstallation/Ubiquiti|Ubiquiti (diverse Geräte)]] |
| | * [[Firmwareinstallation/GL-Inet_AR-150|GL AR150]] |
| | * [[Firmwareinstallation/UbiquitiUnifiACMesh|Ubiquiti AC Mesh]] |
| | * [[Firmwareinstallation/wr841|TP-Link WR841 und WR1043]] (gilt für viele TP-Link Geräte) |
| | * [[Firmwareinstallation/x86|x86 PC und VM]] |
|
| |
|
| === Begründung ===
| | Die Liste ist nicht abschließend und darf gerne erweitert werden. Allgemein ist es sehr hilfreich im [[OpenWrt]]-Wiki zu gucken, dort wird eigentlich für jedes Gerät eine Installationsanleitung angeboten. Da unsere Firmware auf OpenWrt basiert, ist ein Flashen nach dieser Anleitung immer möglich, erst ab der Einrichtung/Konfiguration unterscheidet sich die Freifunk Franken Firmware deutlich von OpenWrt. |
| 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 === | | == Firmware-Konfiguration == |
| Die Versionsnummer orientiert sich grundsätzlich am Datum des letzten Commits. Auf diesen Commit wird dann entsprechend das Git-Tag gesetzt.
| | === Node Firmware === |
| Daraus folgt folgendes Schema:
| | * [[Anleitungen/Node_Firmware|Node Firmware]] |
|
| |
|
| Build ohne release Tag: YYYYMMDD-[Anzahl commits seit vorherigem Release]-[Commit-ID]<br>
| | === Layer-3 === |
| Alpha: YYYYMMDD-alpha <br>
| | Dies ist aktuell hier beschrieben: |
| Beta: YYYYMMDD-beta <br>
| | * [[Layer3Firmware#Typischer_Ablauf_einer_Installation|Ablauf einer Installation]] |
| Release: YYYYMMDD<br>
| | * [[Anbindung#Anbindung_an_das_Layer-3_Netz|Schritt für Schritt Anleitung]] |
| | Zur Konfiguration gibt es hier eine Hilfe: |
| | * [[Layer3Firmware Config|Layer-3 Firmware Konfiguration]] |
|
| |
|
| === Sonderfall === | | == Probleme bei der Installation == |
| Für den seltenen Fall, das es mehrere Tags an einem Tag geben muss, wird der Präfix entsprechend angepasst. Daraus folgt folgendes Schema:
| | Melde dich auf unserer Mailingliste! Die Infos dazu gibt es unter [[Portal:Kommunikation|Kommunikation]]. Dort gibt es auch Hilfe und Support bei der Installation. |
|
| |
|
| Build ohne release Tag: YYYYMMDD.[1-n]-[Anzahl commits seit vorherigem Release]-[Commit-ID]<br>
| | == Nach der Installation == |
| Alpha: YYYYMMDD.[1-n]-alpha<br>
| | Lerne das Freifunknetz kennen. Beschäftige dich mit dem Netz und verbessere dein Setup laufend. Versuche dich mit Nachbarn zu verbinden, baue dazu [[Richtfunk|Richtfunkstrecken]] auf oder wirf einfach ein Kabel über den Gartenzaun zum Nachbarn |
| Beta: YYYYMMDD.[1-n]-beta <br>
| |
| Release: YYYYMMDD.[1-n] <br>
| |
|
| |
|
| === Beispiele === | | = Firmware-Update = |
| 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.
| |
|
| |
|
| 20160130-alpha<br>
| | Bitte haltet eure Router immer auf den aktuellsten Stand. Ein altes System kann Probleme verursachen und enthält u.U. Sicherheitslücken. Allgemein sollten alle Geräte die an das Internet angeschlossen sind (dazu zählen natürlich auch Freifunk Router) immer mit der aktuellsten Software betrieben werden. |
| 20160130-beta<br>
| |
| 20160130.1-beta<br>
| |
| 20160130.1<br>
| |
|
| |
|
| Das nächste Beispiel geht davon aus, das es auf dem selben Commit eine alpha, beta und stable gibt:
| | * [[Anleitung:FirmwareUpdate]] |
| | * [[KeyXchangeV2#Gefahren_eines_Updates_vom_alten_System|Gefahren beim Update von V1 auf V2]] |
|
| |
|
| 20160130-alpha<br>
| | Freifunk Franken hat keinen Autoupdater. Wir erwarten von jeden Freifunker der Freifunkrouter betreibt, dass er sich selbst um seine Router kümmert. Du bist für deine Router selbst verantwortlich. |
| 20160130-beta<br>
| |
| 20160130<br>
| |
|
| |
|
| == Noch eine Bitte == | | = Firmware selbst entwickeln = |
| Bitte melde dich bei unserer Mailingliste an! Die Infos dazu gibt es unter [[Portal:Kommunikation|Kommunikation]]. Dort gibt es auch Hilfe und Support bei der Installation. Danke!
| |
|
| |
|
| == Siehe auch ==
| | Eine Anleitung, wie die aktuelle Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann, gibt es auf der Seite [[FirmwareEntwicklung]]. |
| [http://wiki.freifunk.net/Kommandos Kommandoliste auf den Freifunk-Routern]
| |
| [[Kategorie:Technik]] | |
Der wichtigste Hinweis zuerst
Einen Freifunkrouter stellt man nicht einfach hin und überlässt ihn sich selbst – wie es eigentlich für sämtliche am Internet angeschlossene Geräte gilt, wenn es auch oft genug nicht beachtet wird –, sondern man übernimmt langfristig Verantwortung, v. a. was regelmäßige Updates und Übernahme größerer Änderungen im Netzwerk angeht. Diese werden mit hinreichend großem Vorlauf angekündigt. Wenn diese trotzdem nicht beachtet werden, läuft man Gefahr, dass der Router irgendwann nicht mehr funktioniert oder, wenn er Störungen im Netz produziert, gesperrt wird. Das gilt gerade auch für Freifunkrouter, wo eigene Modifikationen – die wir explizit unterstützen, solange sie das Netz nicht stören und kompatibel zu unseren Netz sind – vorgenommen wurden.
Der Routeraufsteller/Betreiber ist für seinen Router verantwortlich. Dies gilt auch für die Einstellungen wie z. B. Sendeleistung.
Auch sollte man Netzwerkkenntnisse mitbringen. Aber keine Panik: Freifunkrouter sind im Allgemeinen nicht pflegeintensiv.
Durch das Betreiben eines Freifunkrouters stimmt man dem Pico Peering Agreement (PPA) zu.
Die richtige Hardware auswählen
Das Portal Hardware enthält eine Liste unserer unterstützten Geräte.
Im Zweifel nimm Kontakt mit der Community auf, hier wird dir weitergeholfen wenn du Probleme hast.
Die richtige Firmware Variante auswählen
Seit dem Release im Dezember 2019 gibt es zwei verschiedene Varianten der Firmware:
- die Node Firmware, die mit dem zentralen KeyXchange-V2 laufen. (Empfohlen für Anfänger mit dem ersten Freifunk-Router.)
- die neue Layer3-Firmware für ein dezentrales Netz. Mehr unter Layer3Firmware und Layer_3_Firmware. (Aufwändiger, dafür dezentral.)
Der Vorteil der "dezentralen Firmware" wird unter Layer_3_Firmware -> Redundanz beschrieben.
Firmware-Installation
Firmware-Download
Die aktuelle Version findet man hier:
Adrian Schmutzler stellte bis 2020 verschiedene alternative Firmwares auf seiner Seite zur Verfügung: https://freifunk.jubt.org/fff-firmware.php
Mehr Infos zu den Dateinamen der Firmware sind zu finden unter: Anleitungen -> Aufbau_des_Dateinamens_der_Firmware
Checksumme prüfen
Für jede Firmware-Datei gibt es eine Datei mit der SHA256-Prüfsumme, um den korrekten Download zu überprüfen. Früher gab es zusätzlich MD5-Prüfsummen.
Linux
christiand@christianpc:/tmp/fw$ ls
fff-layer3-20200118-archer-c25-v1-factory.bin fff-layer3-20200118-archer-c25-v1-factory.bin.sha256
christiand@christianpc:/tmp/fw$ sha256sum -c fff-layer3-20200118-archer-c25-v1-factory.bin.sha256
fff-layer3-20200118-archer-c25-v1-factory.bin: OK
Sollte beim Download was fehlgeschlagen sein (hier wurde zum Test händisch die *.bin manipuliert) kommt es zu folgender Ausgabe, die Firmware sollte dann keinesfalls geflasht werden:
christiand@christianpc:/tmp/fw$ sha256sum -c fff-layer3-20200118-archer-c25-v1-factory.bin.sha256
fff-layer3-20200118-archer-c25-v1-factory.bin: FEHLSCHLAG
sha256sum: WARNUNG: die 1 berechnete Prüfsumme passte NICHT
Windows
Unter Windows 10 und 11 kann über PowerShell mit dem Befehl Get-FileHash der Hash erzeugt und dann manuell mit dem Inhalt der .md5- und .sha256-Datei verglichen werden.
PS C:\> Get-FileHash -Path C:\Temp\fff-node-20230330-tplink_c2600-factory.bin -Algorithm MD5
Algorithm Hash Path
--------- ---- ----
MD5 F1D1F031B5EC7982648179D12D9915CB C:\Temp\fff-node-20230330-tplink_c2600-factory.bin
PS C:\> Get-FileHash -Path C:\Temp\fff-node-20230330-tplink_c2600-factory.bin -Algorithm SHA256
Algorithm Hash Path
--------- ---- ----
SHA256 C6B9AEFA786E0BEE4B7CC065AE86DF9C3818E1DB33C3AA9D0F94B212F16B79A3 C:\Temp\fff-node-20230330-tplink_c2600-factory.bin
macOS
- Öffne das Terminal
- um einen MD5 Hash zu generieren gebe
md5 und den Dateipfad ein. (Einfach der Drag & Drop aus dem Finder)
- um einen SHA256 Hash zu generieren gebe
shasum -a 256 und den Dateipfad ein. (Einfach der Drag & Drop aus dem Finder)
Firmware-Installation
Die Installation ist je nach Modell sehr unterschiedlich, hier eine Liste diverser Modelle:
Die Liste ist nicht abschließend und darf gerne erweitert werden. Allgemein ist es sehr hilfreich im OpenWrt-Wiki zu gucken, dort wird eigentlich für jedes Gerät eine Installationsanleitung angeboten. Da unsere Firmware auf OpenWrt basiert, ist ein Flashen nach dieser Anleitung immer möglich, erst ab der Einrichtung/Konfiguration unterscheidet sich die Freifunk Franken Firmware deutlich von OpenWrt.
Firmware-Konfiguration
Node Firmware
Layer-3
Dies ist aktuell hier beschrieben:
Zur Konfiguration gibt es hier eine Hilfe:
Probleme bei der Installation
Melde dich auf unserer Mailingliste! Die Infos dazu gibt es unter Kommunikation. Dort gibt es auch Hilfe und Support bei der Installation.
Nach der Installation
Lerne das Freifunknetz kennen. Beschäftige dich mit dem Netz und verbessere dein Setup laufend. Versuche dich mit Nachbarn zu verbinden, baue dazu Richtfunkstrecken auf oder wirf einfach ein Kabel über den Gartenzaun zum Nachbarn
Firmware-Update
Bitte haltet eure Router immer auf den aktuellsten Stand. Ein altes System kann Probleme verursachen und enthält u.U. Sicherheitslücken. Allgemein sollten alle Geräte die an das Internet angeschlossen sind (dazu zählen natürlich auch Freifunk Router) immer mit der aktuellsten Software betrieben werden.
Freifunk Franken hat keinen Autoupdater. Wir erwarten von jeden Freifunker der Freifunkrouter betreibt, dass er sich selbst um seine Router kümmert. Du bist für deine Router selbst verantwortlich.
Firmware selbst entwickeln
Eine Anleitung, wie die aktuelle Firmware gebaut wird oder an der Entwicklung teilgenommen werden kann, gibt es auf der Seite FirmwareEntwicklung.
