Kathleen: Unterschied zwischen den Versionen

3.274 Bytes hinzugefügt ,  3. November 2018
Info-Box zu Hedy vorangestellt.
K (Statusupdates Zeilenfehler)
(Info-Box zu Hedy vorangestellt.)
(23 dazwischenliegende Versionen von 8 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
==Kathleen==
{| style="float:right" |
Ab Kathleen 0.1.2 werden folgende Router unterstützt:<br />
| __TOC__
TP-Link: WDR3500, WDR3600, WDR4300, WDR4900, CPE210,220,510,520, WR740N+ND, WR741N+ND, WR743N+ND, WR841N+ND, WR842ND, WR1043ND<br />
|}
Ubiquiti: Nanostation M2 und M5 (auch Loco mit Nanobridge Image), Nanobridge M2 und M5<br />
<table style="border:1px solid #336699; padding:6px; background-color:#fef0aa"><tr><td><strong>Die Firmware Kathleen wurde 2018 durch [[Hedy]] abgelöst.</strong></table>
 
 
'''"Kathleen" ist der Name der Software, mit der Router für den Freifunk eingesetzt werden können. Diese Software wird auch Firmware genannt. "Kathleen" ist nach der Programmiererin [https://en.wikipedia.org/wiki/Kathleen_Booth Kathleen Booth] benannt, die 1948 die Assembler-Sprache für den ''Automatic Relay Computer'' ARC entwickelte. Die Firmware basiert auf [https://de.wikipedia.org/wiki/OpenWrt OpenWRT]. Auf der Seite [[Freifunkhardware|Freifunkhardware]] steht, welche Router unterstützt werden.'''
 
Am [[Kathleen#Video_zur_Installation|Ende dieser Seite]] findest du ein Video zur Konfiguration. Das Video soll dir nur einen schnellen Überblick geben. Halte dich bei der Konfiguration an die nachfolgende schriftliche Anleitung:


==Vorbereitung==
==Vorbereitung==
===IP-Adressen===
===IP-Adressen===
'''Mesh-IP'''<br>
'''Mesh-IP'''<br>
Eine IP für deinen Router wählst du im [[IP-Adressen#vergebene_IP-Adressen|IP-Bereich]] aus oder fragst über die [mailto:info@freifunk-potsdam.de Mailingliste] nach einer IP-Adresse.
Eine IP für deinen Router wählst du im [[IP-Adressen#vergebene_IP-Adressen|IP-Bereich]] aus oder fragst über die [mailto:info@freifunk-potsdam.de Mailingliste] nach einer IP-Adresse. Dies ist die IP des Routers über die der Router mit anderen Routern kommuniziert.


'''DHCP-Bereich'''<br>
'''DHCP-Bereich'''<br>
Für die Geräte, die sich mit dem Router verbinden brauchst du auch noch einen IP-Adressbereich für den DHCP, den du auch über den [[IP-Adressen#DHCP_-_Netze|IP-Bereich]] erhälst. Die Größe des Adressbereichs wählst du anhand des Aufstellungsorts.
Für die Geräte, die sich mit dem Router verbinden, brauchst du auch noch einen IP-Adressbereich für den DHCP, den du auch über den [[IP-Adressen#DHCP_-_Netze|IP-Bereich]] erhälst. Die Größe des Adressbereichs wählst du anhand des Aufstellungsorts. In der Regel reicht ein kleines Netz mit 32 IP-Adressen.


Router zu Hause: 32er Netz<br>
Router zu Hause: 32er Netz<br>
Zeile 17: Zeile 22:


===VPN-Key===
===VPN-Key===
Wenn du deinen Internetanschluss teilen willst, brauchst du einen VPN-Key, um deinen Anschluss sicher zu teilen. Dafür fülle das Formular auf http://ca.berlin.freifunk.net aus. In der Mail gibst du einen Verbindungsnamen (frei wählbar) und eine Kümmerermail (deine) an.
Wenn du deinen Internetanschluss teilen willst, brauchst du einen VPN-Key (Schlüssel), um deinen Anschluss sicher zu teilen. Dafür fülle das Formular auf http://ca.berlin.freifunk.net aus. Der Verbindungsname ist frei wählbar, sollte aber zu deinem Router passen.
 
"Freifunk" wird automatisch voran gestellt, d.h. wenn du den Verbindungsnamen "deine-strasse-1" wählst, erhälst du eine Datei mit dem Namen "freifunk-deine-strassse-1".
 
Der VPN-Key wird durch einen Menschen erstellt und an die von dir angegebene E-Mail-Adresse geschickt. Das kann mehrere Tage dauern. Bitte sieh auch in dein SPAM-Verzeichnis. Wenn Du der Anleitung zur Einrichtung folgst, benötigst Du den Schlüssel im Abschnitt "VPN-Key".


===Firmware runterladen und aufspielen===
===Firmware runterladen und aufspielen===
Wenn du deinen Router gerade frisch aus der Verpackung geholt hast, ist noch die originale Firmware des Herstellers drauf. Dafür nutze die Erstinstallation. Wenn auf deinem Router schon eine Freifunkfirmware oder ein OpenWRT (nicht DDwrt) drauf ist, wähle Aktualisierung.
Wenn du deinen Router gerade frisch aus der Verpackung geholt hast, ist noch die originale Firmware des Herstellers drauf. Dafür nutze die Erstinstallation (*-factory.bin). Wenn auf deinem Router schon eine Freifunkfirmware oder ein OpenWRT (nicht DDwrt) drauf ist, wähle Aktualisierung (*-sysupgrade.bin).


Die Firmware kannst du dir [http://berlin.freifunk.net/downloads/ hier] runterladen.
Die Firmware kannst du dir [http://berlin.freifunk.net/downloads/ hier] oder vom [http://buildbot.berlin.freifunk.net/buildbot/ Buildbot]runterladen. Auf dem Buildbot ist die Firmware schon kompiliert und du findest allerdings auch die unstable builds.


Wenn noch die Originalfirmware auf deinem Router drauf ist, siehe in die Anleitung des Herstellers, nach Firmware aktualisieren, um die Freifunkfirmware auf den Router zu laden.<br />
Wenn noch die Originalfirmware auf deinem Router drauf ist, siehe in die Anleitung des Herstellers, nach Firmware aktualisieren, um die Freifunkfirmware auf den Router zu laden.<br />
'''ACHTUNG:''' Ab dem Punkt, an dem du die Firmware auf den Router lädst, solltest du mit einem Netzwerkkabel mit dem Router verbunden sein.
'''ACHTUNG:''' Ab dem Punkt, an dem du die Firmware auf den Router lädst, solltest du mit einem Netzwerkkabel an einem der LAN-Ports mit dem Router verbunden sein.


==Einrichtung==
==Einrichtung==
Der Router ist nach dem Hochladen der Firmware über http://192.168.42.1 erreichbar.
Der Router ist nach dem Hochladen der Freifunk-Firmware über http://192.168.42.1 erreichbar.
 
===Passwort vergeben===
===Passwort vergeben===
Hier gib ein frei Wählbares Passwort ein aber merke es dir gut. Dies ist für den Administartionsbereich nötig. Hierbei handelt es sich '''nicht''' um ein WLAN-Passwort.
Hier gib ein frei Wählbares Passwort ein aber merke es dir gut. Dies ist für den Administartionsbereich nötig. Hierbei handelt es sich '''nicht''' um ein WLAN-Passwort.
Zeile 34: Zeile 44:


===Grunddaten===
===Grunddaten===
'''Knotenname:''' Die ersten beiden Zahlen, sind die letzten beiden Stellen deiner Mesh-IP. So wird aus 10.22.254.91 -> 254-91-xxx. Für "xxx" trage etwas zuordbares ein, wie dein Name oder einen Ort.<br />
'''Knotenname:''' Die ersten beiden Zahlen, sind die letzten beiden Stellen deiner Mesh-IP. So wird aus 10.22.254.91 -> 254-91-xxx. Für "xxx" trage etwas zuordbares ein, wie einen Ort.<br />
'''Standort:''' Straße oder Platz, wo dein Router steht.<br />
'''Standort:''' Straße oder Platz, wo dein Router steht.<br />
Wenn du deinen Router während der Einrichtung über den WAN-Port mit deinem Heimnetzwerk verbunden hast, kannst du auf der Karte den Standort anklicken und die Geokoordinaten stehen in den beiden Feldern. Dieser Schritt kann später aber auch nachgeholt werden. Sollte es Probleme beim Aufrufen der Koordinaten geben, kannst du diese auch [https://wiki.opennet-initiative.de/wiki/Koordinaten_Bestimmung '''hier'''] herholen.
Wenn du deinen Router während der Einrichtung über den WAN-Port mit deinem Heimnetzwerk verbunden hast, kannst du auf der Karte den Standort anklicken und die Geokoordinaten stehen in den beiden Feldern. Dieser Schritt kann später aber auch nachgeholt werden. Sollte es Probleme beim Aufrufen der Koordinaten geben, kannst du diese auch [https://wiki.opennet-initiative.de/wiki/Koordinaten_Bestimmung '''hier'''] herholen.
Zeile 44: Zeile 54:


===VPN-Key===
===VPN-Key===
Du solltest eine Email mit einer '''.tgz''' Datei erhalten haben. Wenn du Windowsnutzer bist kannst du diese Archivdatei mit [[http://www.7-zip.org/ 7zip]] entpacken. Unter Windows fehlt die Endung "crt". Das ist die Datei ohne Endung und einem identischen Namen wie die .key Datei.
Du solltest eine Email mit einer '''.tgz''' Datei erhalten haben. Wenn du Windowsnutzer bist kannst du diese Archivdatei mit [[http://www.7-zip.org/ 7zip]] entpacken. Unter Windows wird die Endung "crt" ausgeblendet. Das ist die Datei ohne Endung und einem identischen Namen wie die .key Datei.
<br />[[Datei:4-vpn.png|500px]]<br />
<br />[[Datei:4-vpn.png|500px]]<br />
Über die Benutzerdefinierte Ansicht gibst du an, wieviel an Bandbreite du freigeben möchtest. Down und Uploadverhältniss sollten stimmen, da es sonst zu Problemen kommen kann.
Über die Benutzerdefinierte Ansicht gibst du an, wieviel an Bandbreite du freigeben möchtest. Down und Uploadverhältniss sollten stimmen, da es sonst zu Problemen kommen kann. Achte auf die Schreibweise und in welchen Feld du dich befindest. In dem Download-Feld sollte die größere Zahl stehen.


===Monitoring===
===Monitoring===
Monitoring sollte nur auf Routern der Serie WDR3000 und WDR4000 eingeschaltet werden, da das Monitoring sehr Resourcenlastig ist. Auf '''keinen''' Fall auf WR700er und WR800er einschalten. Auch auf den Geräten von Ubiquity empfiehlt sich das Monitoring nicht.
Da wir [[StatusUpdates|Grafana]] zum überwachen der Router nutzen brauchst du hier eigentlich kein Häkchen setzen.
 
Wenn du dennoch lokalesMonitoring einschalten willst, sollte es nur auf Routern der Serie ArcherC7/C5, WDR3000 und WDR4000 eingeschaltet werden, da das Monitoring sehr Resourcenlastig ist. Auf '''keinen''' Fall auf WR700er und WR800er einschalten. Auch auf den Geräten von Ubiquiti empfiehlt sich das Monitoring nicht.
<br />[[Datei:5-monitoring.png|500px]]
<br />[[Datei:5-monitoring.png|500px]]


===IPs===
===IPs===
Bei Radio0 (2,4 GHz) und Radio1 (5GHz) gibst du die Mesh-IP an (zwei mal die selbe), die du dir in der Vorbereitung geholt hast. Radio1 ändern wir später. In der Freifunk SSID steht "www.freifunk-potsdam.de". Da wir das später eh ändern müssten tun wir es gleich in "Freifunk-Potsdam-x-xx" (x wieder die letzten beiden Stellen der Mesh-IP).  
Bei Radio0 (2,4 GHz) und Radio1 (5GHz) gibst du die Mesh-IP an (zwei mal die selbe), die du dir in der [[Kathleen#IP-Adresse|Vorbereitung]] geholt hast. Radio1 ändern wir später. In der Freifunk SSID steht "www.freifunk-potsdam.de". Da wir das später eh ändern müssen tun wir es gleich und ändern es in "Freifunk-Potsdam-x-xx" (x wieder die letzten beiden Stellen der Mesh-IP).  


Der Adressraum ist das DHCP-Netz mit dem sich später die Endgeräte verbinden.<br>
Der Adressraum ist das DHCP-Netz mit dem sich später die Endgeräte verbinden.<br>
Zeile 59: Zeile 71:
<br />[[Datei:6-ipkonfig.png|500px]]
<br />[[Datei:6-ipkonfig.png|500px]]


Nun sollte der Router einen Neustart machen und danach über deine eingetragene IP erreichbar sein.
Nun sollte der Router einen Neustart machen und danach über deine eingetragene Mesh-IP erreichbar sein.


===Schnittstellen===
===Schnittstellen===
Zeile 67: Zeile 79:
*Achte darauf, dass die IPv4 Netzmaske für die entsprechende Netzgröße steht (z.Bsp: 32er Netz 255.255.255.224)
*Achte darauf, dass die IPv4 Netzmaske für die entsprechende Netzgröße steht (z.Bsp: 32er Netz 255.255.255.224)
**Beachte, dass die erste IP deines Adressbereichs die Netz-ID ist. Der Wizard hat deiner Schnittstelle die erste IP nach der Netz ID gegeben.
**Beachte, dass die erste IP deines Adressbereichs die Netz-ID ist. Der Wizard hat deiner Schnittstelle die erste IP nach der Netz ID gegeben.
*Wir bevorzugen die DNS-Server von der [[http://www.ccc.de/de/censorship/dns-howto CCC-Seite]]
*Wir bevorzugen zensurfreie DNS-Server:
**85.214.20.141 (FoeBud)
** 85.214.20.141 ( [https://digitalcourage.de/support/zensurfreier-dns-server Digitalcourage])
**194.150.168.168 (dns.as250.net; Berlin/Frankfurt)
** 194.150.168.168 (dns.as250.net, AS250)
**213.73.91.35 (dnscache.berlin.ccc.de)
** 89.233.43.71 (anycast.censurfridns.dk, [https://blog.uncensoreddns.org/ UncensoredDNS])
** Weitere empfhelenswerte DNS Server:
*** 46.182.19.48 ([https://digitalcourage.de/support/zensurfreier-dns-server Digitalcourage])
*** 194.150.168.169 (adblock.dns.as250.net, AS250)
*** 91.239.100.100 (unicast.censurfridns.dk, [https://blog.uncensoreddns.org/ UncensoredDNS])
*** 1.1.1.1 ([https://www.cloudflare.com/dns/ Cloudflare DNS] [https://1.1.1.1/ Weitere Infos])
*** 1.0.0.1 ([https://www.cloudflare.com/dns/ Cloudflare DNS] [https://1.1.1.1/ Weitere Infos])
*** 9.9.9.9 ([https://www.quad9.net/ Quad9])
*** 8.8.8.8 ([https://developers.google.com/speed/public-dns/ Google Public DNS])
*** 8.8.4.4 ([https://developers.google.com/speed/public-dns/ Google Public DNS])
*Setze IPv6 assignment lenght auf disable
*Setze IPv6 assignment lenght auf disable
<br />[[Datei:18-dhcp-netzwerk-konfig1.png|500px]]
<br />[[Datei:18-dhcp-netzwerk-konfig1.png|500px]]
*DHCP-Server aktivieren und als Start die DHCP-IP + 1 eingeben, Limit entsprechend einstellen (bei 32er Netz 29, bei 64er Netz 61 [quasie Netzgröße minus 3]) und  Laufzeit auf 15 Minuten  
*DHCP-Server aktivieren und als Start die DHCP-IP + 1 eingeben, Limit entsprechend einstellen (bei 32er Netz 29, bei 64er Netz 61 [quasie Netzgröße minus 3]) und  Laufzeit auf 15 Minuten  
*Unter IPv6 Settings alles auf disabled stellen
*Unter IPv6 Settings alles auf disabled stellen
*Speichern und Anwenden
<br />
<br />
{|
{|
Zeile 83: Zeile 105:
<br />[[Datei:10-wireless0.png|700px]]
<br />[[Datei:10-wireless0.png|700px]]
*Achte darauf, dass die IPv4 Netzmaske auf '''255.255.0.0''' steht
*Achte darauf, dass die IPv4 Netzmaske auf '''255.255.0.0''' steht
*Wir bevorzugen die DNS-Server von der [[http://www.ccc.de/de/censorship/dns-howto CCC-Seite]]
*Wir bevorzugen zensurfreie DNS-Server:
**85.214.20.141 (FoeBud)
** 85.214.20.141 ( [https://digitalcourage.de/support/zensurfreier-dns-server Digitalcourage])
**194.150.168.168 (dns.as250.net; Berlin/Frankfurt)
** 194.150.168.168 (dns.as250.net, AS250)
**213.73.91.35 (dnscache.berlin.ccc.de)
** 89.233.43.71 (anycast.censurfridns.dk, [https://blog.uncensoreddns.org/ UncensoredDNS])
** Weitere empfhelenswerte DNS Server:
*** 46.182.19.48 ([https://digitalcourage.de/support/zensurfreier-dns-server Digitalcourage])
*** 194.150.168.169 (adblock.dns.as250.net, AS250)
*** 91.239.100.100 (unicast.censurfridns.dk, [https://blog.uncensoreddns.org/ UncensoredDNS])
*** 1.1.1.1 ([https://www.cloudflare.com/dns/ Cloudflare DNS] [https://1.1.1.1/ Weitere Infos])
*** 1.0.0.1 ([https://www.cloudflare.com/dns/ Cloudflare DNS] [https://1.1.1.1/ Weitere Infos])
*** 9.9.9.9 ([https://www.quad9.net/ Quad9])
*** 8.8.8.8 ([https://developers.google.com/speed/public-dns/ Google Public DNS])
*** 8.8.4.4 ([https://developers.google.com/speed/public-dns/ Google Public DNS])
*Setze IPv6 assignment lenght auf disable
*Setze IPv6 assignment lenght auf disable
<br />[[Datei:11-wireless0-ip.png|500px]]
<br />[[Datei:11-wireless0-ip.png|500px]]
Zeile 97: Zeile 128:
* Auf Kanal '''5''' wechseln.
* Auf Kanal '''5''' wechseln.
* ESSID: Mesh23
* ESSID: Mesh23
* BSSID: 02:ca:ff:ee:ba:be<br>
* BSSID: 02:ca:ff:ee:ba:be
* Speichern und Anwenden<br>
Vergleich Abbildung.
Vergleich Abbildung.
<br />[[Datei:9-2,4ghz-mesh.png |400px]]
<br />[[Datei:9-2,4ghz-mesh.png |400px]]
Zeile 108: Zeile 140:
'''Nur''' bei Geräten mit 5 GHz Modul, wie z.Bsp. der WDR4300 und WDR3600.
'''Nur''' bei Geräten mit 5 GHz Modul, wie z.Bsp. der WDR4300 und WDR3600.


Als erstes wird das Mesh-Wlan bei Radio-0 unter Netzwerk -> Drahtlos gelöscht. Dann wird der Access Point Bearbeitet. Die ESSID ist identisch zu der ESSID vom 2,4Ghz Modul.
Als erstes wird das Mesh-Wlan bei Radio-1 unter Netzwerk -> Drahtlos gelöscht. Dann wird der Access Point Bearbeitet. Die ESSID ist identisch zu der ESSID vom 2,4Ghz Modul.


Bei der Schnittstellenkonfiguration muss das Häkchen bei dhcp sein.
Bei der Schnittstellenkonfiguration muss das Häkchen bei dhcp sein.
Zeile 114: Zeile 146:
<br />[[Datei:16-5ghz-dhcp.png|500px]]
<br />[[Datei:16-5ghz-dhcp.png|500px]]
<br />
<br />
Danach muss unter Services -> OLSR IPv4, ganz unten auf der Seite, die 5GHz-Meshschnittstelle entfernt werden, da auf 5GHz nicht gemeshed wird. Dazu die Schnittstelle ohne Network entfernen.
Danach muss unter Services -> OLSR IPv4, ganz unten auf der Seite, die 5GHz-Meshschnittstelle entfernt werden, da auf 5GHz nicht gemeshed wird. Dazu die Schnittstelle ohne Network entfernen. Speichern und Anwenden.
<br />[[Datei:20-5ghz-olsr.png|700px]]
<br />[[Datei:20-5ghz-olsr.png|700px]]
=== Smart Gateway abschalten ===
===OLSR===
==== LQ algorithm ====
Damit Kabelkopplungen (Mesh über LAN) nicht als ganzer Hop gezählt werden stellen wir auf etx_ffeth um. Dadurch wird sie nur noch als zehntel Hop gerechnet. Ohne diese Einstellung kann dein Router nicht mit den anderen Meshen.


Da es probleme mit der Smart Gateway (SGW) gibt ist hier eine kurze Anleitung, wie SGW abgeschalten wird und wie die Router übers FF-Netz ins Internet kommen.
Unter Services -> OLSRv4 -> Link Quality Settings -> LQ algorithm auf
"etx_ffeth" umstellen.


'''Via SSH mit dem Router verbinden.'''
==== Smart Gateway ====
Tunnelvorgaben für SGW aus '''/etc/config/olsrd''' entfernen. Folgende Zeilen löschen oder mit # auskommentieren.<br>
Smart Gateway verhindert, dass bei mehreren Uplinks mit ähnlichen ETX-Werten die Verbindung anfängt zu flackern. Mit flackern ist gemeint, dass der Router mehrmals den Uplink wechselt und dadurch Verbindungen abbrechen. Um dies zu verhindern baut Smart Gateway einen Tunnel durch das Mesh-Netz zum Router mit dem Uplink, um die Verbindung stabil zu halten. <strike>Da wir bisher nur negative Effekte erreicht haben, empfehlen wir derzeit, auf Routern ohne Uplink [[KathleenZusatz#Smart_Gateway_abschalten | Smart Gateway abzuschalten]]. Wir arbeiten bereits an einer Lösung, um Smart Gateway auch im Potsdamer Netz zu betreiben.</strike>
<pre>option RtTableTunnel '113'
option RtTableTunnelPriority '100000'</pre><br>
'''Und'''<br><br>
In '''/etc/config/freifunk-policyrouting''' bei fallback den Wert von '''0''' auf '''1''' setzen.<br><br>
'''Konsole offen lassen und in die Weboberfläche wechseln.'''<br>
Unter '''Dienste -> OLSRv4 -> SmartGateway''' SGW deaktivieren (Haken entfernen).<br>
"Speichern & Anwenden"


In der Konsole den Router neustarten.
==Video zur Installation==
<pre>exec reboot</pre>
<html><iframe width="560" height="315" src="https://www.youtube.com/embed/tLSUISydFvI" frameborder="0" allowfullscreen></iframe></html>
===Statusupdates mit ffp-apdb Skript===
* Das script von [[media:Ffp-apdb.zip|hier]] runterladen.
* Script auf den Router kopieren mit
<pre> scp ffp-apdb root@<IP des Routers>:/etc/init.d/</pre>
* auf dem Accesspoint einloggen
* Mit '''ifconfig''' nachschauen welches Interface die 10.22.254.x Adresse hat (Bei Kathleen wlan0-adhoc-2). Dann das Interface im Script in Zeile 13 und 25 bei wlan0 anpassen.
* Das Script ausführbar machen
chmod +x /etc/init.d/ffp-apdb
* das Script enablen
/etc/init.d/ffp-apdb enable
* das Script starten entweder reboot des Routers oder mit
/etc/init.d/ffp-apdb start


==Erweiterte Einstellungen==
==Erweiterte Einstellungen==
Zeile 153: Zeile 169:
* [[KathleenZusatz#Smart_Gateway_abschalten | Smart Gateway abschalten]]
* [[KathleenZusatz#Smart_Gateway_abschalten | Smart Gateway abschalten]]
* [[KathleenZusatz#PoE_Passthrough |PoE Passthrough]]
* [[KathleenZusatz#PoE_Passthrough |PoE Passthrough]]
* [[KathleenZusatz#QoS_(Traffic Shaping) | QoS (Traffic Shaping)]]
* [[StatusUpdates | Status Updates - Grafana Node Overview]]


[[Kategorie:Technik]]
[[Kategorie:Technik]]
32

Bearbeitungen