OpenWRT Kamikaze: Unterschied zwischen den Versionen

Aus FunkFeuer Wiki
Wechseln zu: Navigation, Suche
K
(4. Netzwerk)
 
(17 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
<google>WIKI</google>
 
<google>WIKI</google>
  
<font style="color:#E00000; font-size:2em">Achtung, diese Seite ist noch im Aufbau</font>
+
<font style="color:#E00000; font-size:1em">Achtung, diese Seite wird in naher Zukunft durch '''[[0xFF-Backfire Vienna]]''' ersetzt (JoeSemler)</font>
= Allgemeines =
+
  
'''[http://www.openwrt.org openWRT Kamikaze]''' ist eine Linux-Distribution für handelsübliche Wireless-Router und der Nachfolger von openWRT Whiterussian, auf dem die [[Freifunk Firmware]] basiert.
 
  
= Warum eine neue Firmware? =
+
= Allgemeines =
 
+
'''[[OpenWrt]]''' ist eine Linux-Distribution für handelsübliche Wireless-Router. Es gibt mehrere Releases:
OpenWRT Whiterussian basierte zu einem großen Teil auf den originalen Quelltexten des Linksys WRT54G, womit die Firmware für diese Routerhardware und den darin verwendeten Chip des Herstellers Broadcom zugeschnitten war. In Geräten der neueren Generation werden jedoch auch Chips des Herstellers Atheros verwendet, die durch diese Firmware nicht unterstützt werden.
+
* OpenWrt Whiterussian  
  
Die primäre Motivation hinter der Kamikaze-Entwicklung besteht darin, eine Plattform zu schaffen, bei der die Konfiguration der Devices hardwareunabhängig ist. Es also egal ist, welches der unterstützten Geräte verwendet wird - es läuft immer die gleiche Software mit einem vergleichbaren Set der Konfiguration und dem gleichen "Look & Feel".   
+
OpenWrt Whiterussian basierte zu einem großen Teil auf den originalen Quelltexten des Linksys WRT54G, womit die Firmware für diese Routerhardware und den darin verwendeten Chip des Herstellers Broadcom zugeschnitten war. In Geräten der neueren Generation werden jedoch auch Chips des Herstellers Atheros verwendet, die durch diese Firmware nicht unterstützt werden.
 +
* OpenWrt Kamikaze
 +
Die primäre Motivation hinter der Kamikaze-Entwicklung besteht darin, eine Plattform zu schaffen, bei der die Konfiguration der Devices hardwareunabhängig ist. Es also egal ist, welches der unterstützten Geräte verwendet wird - es läuft immer die gleiche Software mit einem vergleichbaren Set der Konfiguration und dem gleichen "Look & Feel".  Die [[Freifunk Firmware]] basiert auf Kamikaze.
 +
* OpenWrt Backfire
 +
Backfire macht einfach dort weiter, wo Kamikaze aufgehört hat. Backfire basiert auf Linux Kernel 2.6.32
  
  
Zeile 17: Zeile 19:
  
 
= Installation =
 
= Installation =
Bis zum Rollout der geplanten 0xFF-Kamikaze Images ist es ratsam, auf bereits vorhandene Distributionen unserer deutschen Freifunk-Kollegen aus Halle oder Leipzig zuzugreifen, da dort bereits auch alle nötigen Freifunk-Pakete inkludiert sind.
+
Bis zum endgültigen Rollout der geplanten 0xFF-Backfire Images können die Release-Candidates direkt aus dem [ftp://oe1xrw.ozw.wien.funkfeuer.at/contrib 0xFF-Buildroot] gezogen werden.  
Abhängig von der verwendeten Gerätehardware gibt es bei [http://dev.luci.freifunk-halle.net/freifunk-snapshots/ Freifunk Halle] oder [http://firmware.leipzig.freifunk.net/kamikaze/ Freifunk Leipzig] die passenden Snapshots. Wer jedoch lieber mit den Originalpaketen von openWRT arbeiten möchte oder bei Freifunk Halle seine Hardware nicht finden kann, findet [http://downloads.openwrt.org/snapshots/trunk/ openWRT Snapsots] die passenden Snapshots aller derzeit unterstützten Devices.
+
Die Snapshots sind derzeit für die Plattformen brcm2.4 (Linksys WRT54gl, Buffalo WHR HP54g), Atheros (Bullet2, Bullet5) sowie AR71xx (Bullet 2M) getestet und laufen einwandfrei. Selbstverständlich tragen die Images die Funkfer-spezifischen Grundeinstellungen.  
Bei Firmware aus dieser Quelle ist jedoch zu bedenken, dass es sich um die openWRT Basisinstallation handelt und die nötigen/gewünschten Freifunk-Pakete erst nach der Installation zugefügt werden müssen. Wie das geht, wird zu einem späteren Zeitpunkt erklärt.
+
Wer jedoch lieber mit den Originalpaketen von openWRT arbeiten möchte oder im Buildroot seine Hardware nicht finden kann, findet unter [http://downloads.openwrt.org/snapshots/trunk/ openWRT Snapsots] die passenden Snapshots aller derzeit unterstützten Devices.
 +
Bei Firmware aus dieser Quelle ist jedoch zu bedenken, dass es sich um die openWRT Basisinstallation handelt und die nötigen/gewünschten Freifunk-Pakete erst nach der Installation zugefügt werden müssen.  
 
== Webinterface ==
 
== Webinterface ==
  
 
= Konfiguration =
 
= Konfiguration =
  
Wie bereits erwähnt verwendet OpenWRT-Kamikaze Konfigurationsdateien, in die alle allgemein gültigen Grundeinstellungen bereits bei der Installation vorgenommen werden. Für die individuelle Anpassung der Devices können diese Dateien händisch editiert oder sehr einfach über ein Webinterface mit der Bezeichnung LuCI angepasst werden.
+
Wie bereits erwähnt verwendet OpenWRT-Backfire Konfigurationsdateien, in die alle allgemein gültigen Grundeinstellungen bereits bei der Installation vorgenommen werden. Für die individuelle Anpassung der Devices können diese Dateien händisch editiert oder sehr einfach über ein Webinterface mit der Bezeichnung LuCI angepasst werden.
  
In dieser Anleitung werden wir uns vorerst der Konfiguration über LuCI widmen und im Anschluss die einzelnen Konfigurationsfiles der 0xFF-Basisinstallation vorstellen.  
+
Da 0xFF-Backfire Vienna auch das automatische Konfigurieren von Nodes für bestimmte Anwendungsfälle erlaubt, werde ich hier später auch die entsprechenden Files samt Anleitung hinterlegen. Bitte jedoch noch um ein wenig Geduld, erst müssen die Images mit allen erforderlichen Funktionen vollinhaltlich getestet werden. (JoeSemler)
  
== Über das Webinterface ==
+
 
 +
== Konfiguration über das Webinterface ==
  
 
=== Allgemeines ===
 
=== Allgemeines ===
  
 
==== Login ====
 
==== Login ====
Nach der Installation von 0xFF-Kamikaze ist der Router unter [http://192.168.1.1 http://192.168.1.1] erreichbar und vergibt über DHCP interne Adressen.
+
Nach der Installation von 0xFF-Backfire Vienna ist der Router unter [http://192.168.1.1 http://192.168.1.1] erreichbar und vergibt über DHCP interne Adressen.
 +
 
 +
Da zu diesem Zeitpunkt noch kein Passwort gesetzt ist, ist egal, was im Passwortfenster steht. Bitte jetzt aber SOFORT ein sicheres Passwort setzen, damit der Router aus dem Internet nicht übernommen werden kann.  
  
Da zu diesem Zeitpunkt noch kein Passwort gesetzt ist, muss beim Anmelden als "root"-User das Passwortfeld leer gelassen werden. Bitte jetzt SOFORT ein sicheres Passwort setzen, damit der Router aus dem Internet nicht übernommen werden kann.
+
Sichere Passwörter bestehen aus mindestens 8 Zeichen und beinhalten mindestens einen Groß- und einen Kleinbuchstaben, eine Ziffer sowie auch Sonderzeichen.
  
  
Zeile 46: Zeile 52:
 
==== Speichern/Übernehmen von Änderungen ====
 
==== Speichern/Übernehmen von Änderungen ====
  
Bei LuCI ist es nicht mehr notwendig nach den Änderungen den Router neu zu starten, es wird erkannt welche Dienste neu gestartet werden müssen.
+
Bei LuCI ist es nicht mehr notwendig nach den Änderungen den Router neu zu starten, es wird erkannt welche Dienste neu gestartet werden müssen. Jedoch besagt eine alte IT-Regel: "EIn Reboot tut immer gut" :-)
  
 
Einstellungen können entweder  
 
Einstellungen können entweder  
Zeile 57: Zeile 63:
  
 
* ''Hostname'': Name des Geräts im Format '''''devicename''.''knotenname''''', zum Beispiel ''v1.ab01''
 
* ''Hostname'': Name des Geräts im Format '''''devicename''.''knotenname''''', zum Beispiel ''v1.ab01''
 
* ''Zeitzone'': '''Europe/Vienna'''
 
  
  
Zeile 66: Zeile 70:
  
 
* ''Pseudonym''
 
* ''Pseudonym''
 +
* ''Eine Kontaktinformation''
 
* ''Standort'' (Knotenname)
 
* ''Standort'' (Knotenname)
 
* ''Notiz'' (z.B. Antennentyp, Ausrichtung, etc.)
 
* ''Notiz'' (z.B. Antennentyp, Ausrichtung, etc.)
  
GPS Position muss nicht eingetragen werden.
 
  
 
=== 3. WLAN-Einstellungen ===
 
=== 3. WLAN-Einstellungen ===
Zeile 87: Zeile 91:
 
* ''Empfangsantenne'': '''1'''
 
* ''Empfangsantenne'': '''1'''
 
* ''Distanzoptimierung'': '''10000''' bis '''18000'''  
 
* ''Distanzoptimierung'': '''10000''' bis '''18000'''  
* ''Ländercode'': '''40'''
+
* ''Ländercode'': '''AT'''
  
 
Folgende Einstellung in der Sektion '''Schnittstellen''':
 
Folgende Einstellung in der Sektion '''Schnittstellen''':
Zeile 96: Zeile 100:
 
* ''BSSID'': [[Kanalwahl#Unsere_ssid_und_bssid|laut Liste]]
 
* ''BSSID'': [[Kanalwahl#Unsere_ssid_und_bssid|laut Liste]]
 
* ''Verschlüsselung'': '''No Encryption'''
 
* ''Verschlüsselung'': '''No Encryption'''
 +
  
 
=== 4. Netzwerk ===
 
=== 4. Netzwerk ===
Zeile 111: Zeile 116:
 
** bei einer IP-Adresse zwischen ''78.41.112.0'' und ''78.41.113.254'': &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'''255.255.25''5''.0''' <- Achtung
 
** bei einer IP-Adresse zwischen ''78.41.112.0'' und ''78.41.113.254'': &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'''255.255.25''5''.0''' <- Achtung
 
* ''IPv4-Gateway'': '''LEER lassen!'''
 
* ''IPv4-Gateway'': '''LEER lassen!'''
* ''DNS-Server'': '''193.238.157.16'''
+
* ''DNS-Server'': '''193.238.157.5 193.238.156.225 208.67.220.220'''
  
 
=== 5. Firewall ===
 
=== 5. Firewall ===
  
Unter '''Netzwerk->Firewall->Zonen''' sind folgende Werte anzupassen:
+
ist vom jeweiligen Anwendungsfall abhängig.
 +
Bei Geräten, die ausschließlich Funkfeuer-Netze verwenden hat sich das "Zulassen" aller Basissettings und das Löschen aller Zonen als beste Variante erwiesen.
  
In der Sektion '''Zonen''', Zone '''wan''':
+
Soll das Device eine Adresskonvertierung vornehmen (von privatem LAN in (öffentliches) Funkfeuer WLAN-Netz) ist im öffentliechen Bereich das "Masq"-Flag zu setzen.
  
* ''wan''
 
** ''Eingehender Verkehr'': '''annehmen'''
 
** ''Ausgehender Verkehr'': '''annehmen'''
 
** ''Weitergeleiteter Verkehr'': '''annehmen'''
 
** ''MASQ'': '''aktiviert'''
 
  
 
=== 6. OLSR ===
 
=== 6. OLSR ===
Zeile 129: Zeile 130:
 
==== Plugins anpassen ====
 
==== Plugins anpassen ====
  
Unter '''Dienste->OLSR->Plugins''' folgende Plugins aktivieren/deaktivieren falls vorhanden:
+
Unter '''Dienste->OLSR->Plugins''' muss nichts angepasst werden.
 
+
Als Plugins verwenden wir bei 0xFF-Funkfeuer Vienna arprefresh, textinfo und den watchdog.
* ''olsrd_dyn_gw_plain.so.0.4'': '''deaktiviert''' '''''WICHTIG!!'''''
+
* ''olsrd_nameservice.so.0.3'': '''aktiviert''' kann auch deaktiviert werden.
+
* ''olsrd_txtinfo.so.0.1'': '''aktiviert'''
+
  
 
==== OLSR Daemon ====
 
==== OLSR Daemon ====
Zeile 139: Zeile 137:
 
Unter '''Dienste->OLSR''' sind folgende Schritte anzupassen:
 
Unter '''Dienste->OLSR''' sind folgende Schritte anzupassen:
  
'''Allgemeines'''
 
 
* ''Internet Protokoll'': '''IPv4'''
 
* ''VQ-Algorithmus'': '''Freifunk'''
 
* ''FIB-Metrik'': '''flat'''
 
  
 
'''Schnittstellen'''
 
'''Schnittstellen'''
Zeile 153: Zeile 146:
 
* ''Netzwerk'': '''olsrwifi0''', bzw. an den jeweiligen OLSR Schnittstellennamen anpassen
 
* ''Netzwerk'': '''olsrwifi0''', bzw. an den jeweiligen OLSR Schnittstellennamen anpassen
 
* ''IPv4 Broadcast'': '''255.255.255.255'''
 
* ''IPv4 Broadcast'': '''255.255.255.255'''
* ''Hello-Intervall'': '''5.0'''
 
* ''Hello-Gültigkeit'': '''125.0'''
 
* ''TC-Intervall'': '''3.0'''
 
* ''TC-Gültigkeit'': '''500.0'''
 
* ''MID-Intervall'': '''25.0'''
 
* ''MID-Gültigkeit'': '''500.0'''
 
 
Falls HNAs konfiguriert wurden, auch folgende:
 
 
* ''HNA-Intervall'': '''25.0'''
 
* ''HNA-Gültigkeit'': '''500.0'''
 
 
== Über die Kommandozeile ==
 
todo
 
  
 +
Alle anderen Settings wurden bereits in der Konfiguration entsprechend angepasst. (Dies gilt nicht für Images, die direkt aus dem OpenWRT-Trunk gezogen werden!)
 
----
 
----
 
[[Category:Dokumentation]]
 
[[Category:Dokumentation]]
 
[[Category:Software]]
 
[[Category:Software]]

Aktuelle Version vom 24. August 2015, 08:14 Uhr

<google>WIKI</google>

Achtung, diese Seite wird in naher Zukunft durch 0xFF-Backfire Vienna ersetzt (JoeSemler)


Allgemeines

OpenWrt ist eine Linux-Distribution für handelsübliche Wireless-Router. Es gibt mehrere Releases:

  • OpenWrt Whiterussian

OpenWrt Whiterussian basierte zu einem großen Teil auf den originalen Quelltexten des Linksys WRT54G, womit die Firmware für diese Routerhardware und den darin verwendeten Chip des Herstellers Broadcom zugeschnitten war. In Geräten der neueren Generation werden jedoch auch Chips des Herstellers Atheros verwendet, die durch diese Firmware nicht unterstützt werden.

  • OpenWrt Kamikaze

Die primäre Motivation hinter der Kamikaze-Entwicklung besteht darin, eine Plattform zu schaffen, bei der die Konfiguration der Devices hardwareunabhängig ist. Es also egal ist, welches der unterstützten Geräte verwendet wird - es läuft immer die gleiche Software mit einem vergleichbaren Set der Konfiguration und dem gleichen "Look & Feel". Die Freifunk Firmware basiert auf Kamikaze.

  • OpenWrt Backfire

Backfire macht einfach dort weiter, wo Kamikaze aufgehört hat. Backfire basiert auf Linux Kernel 2.6.32


Unterschiede zur Freifunk Firmware

Eines der gravierendsten Unterschiede zur Vorgängerversion ist, dass die Einstellungen nicht mehr wie bei Broadcom-Geräten in der NVRAM-Partition sondern in einzelne Konfigurationsdateien gespeichert werden und somit von jedem Programm, dass auf dem Router läuft, verwendet werden kann. Dadurch wird erreicht, dass die Konfiguration des Devices einheitlich gehalten wird.

Installation

Bis zum endgültigen Rollout der geplanten 0xFF-Backfire Images können die Release-Candidates direkt aus dem 0xFF-Buildroot gezogen werden. Die Snapshots sind derzeit für die Plattformen brcm2.4 (Linksys WRT54gl, Buffalo WHR HP54g), Atheros (Bullet2, Bullet5) sowie AR71xx (Bullet 2M) getestet und laufen einwandfrei. Selbstverständlich tragen die Images die Funkfer-spezifischen Grundeinstellungen. Wer jedoch lieber mit den Originalpaketen von openWRT arbeiten möchte oder im Buildroot seine Hardware nicht finden kann, findet unter openWRT Snapsots die passenden Snapshots aller derzeit unterstützten Devices. Bei Firmware aus dieser Quelle ist jedoch zu bedenken, dass es sich um die openWRT Basisinstallation handelt und die nötigen/gewünschten Freifunk-Pakete erst nach der Installation zugefügt werden müssen.

Webinterface

Konfiguration

Wie bereits erwähnt verwendet OpenWRT-Backfire Konfigurationsdateien, in die alle allgemein gültigen Grundeinstellungen bereits bei der Installation vorgenommen werden. Für die individuelle Anpassung der Devices können diese Dateien händisch editiert oder sehr einfach über ein Webinterface mit der Bezeichnung LuCI angepasst werden.

Da 0xFF-Backfire Vienna auch das automatische Konfigurieren von Nodes für bestimmte Anwendungsfälle erlaubt, werde ich hier später auch die entsprechenden Files samt Anleitung hinterlegen. Bitte jedoch noch um ein wenig Geduld, erst müssen die Images mit allen erforderlichen Funktionen vollinhaltlich getestet werden. (JoeSemler)


Konfiguration über das Webinterface

Allgemeines

Login

Nach der Installation von 0xFF-Backfire Vienna ist der Router unter http://192.168.1.1 erreichbar und vergibt über DHCP interne Adressen.

Da zu diesem Zeitpunkt noch kein Passwort gesetzt ist, ist egal, was im Passwortfenster steht. Bitte jetzt aber SOFORT ein sicheres Passwort setzen, damit der Router aus dem Internet nicht übernommen werden kann.

Sichere Passwörter bestehen aus mindestens 8 Zeichen und beinhalten mindestens einen Groß- und einen Kleinbuchstaben, eine Ziffer sowie auch Sonderzeichen.


Bei Firmware von downloads.openwrt.org ist darauf zu achten, dass zusätzlich zum Administrationsinterface (Administration) ein minimales Webinterface (Essential) vorhanden ist, welches nicht die vollen Fähigkeiten bietet, die wir zur Konfiguration benötigen.

Hinzufügen von Optionen

LuCI ist so aufgebaut, dass es nicht verwendete Konfigurationsoptionen automatisch ausblendet und links unten eine Auswahl bietet, diese hinzuzufügen.

Speichern/Übernehmen von Änderungen

Bei LuCI ist es nicht mehr notwendig nach den Änderungen den Router neu zu starten, es wird erkannt welche Dienste neu gestartet werden müssen. Jedoch besagt eine alte IT-Regel: "EIn Reboot tut immer gut" :-)

Einstellungen können entweder

  • gespeichert und sofort übernommen werden (Speichern & Anwenden), falls man nur Änderungen auf dieser Seite macht
  • oder nur gespeichert und später angewendet werden (Speichern), rechts oben können dann alle Änderungen auf einmal fest gespeichert und übernommen werden.


1. Passwort und System

Unter System->System ist folgendes zu ändern:

  • Hostname: Name des Geräts im Format devicename.knotenname, zum Beispiel v1.ab01


2. Kontaktinfos

Unter Freifunk->Kontakt sollte zumindest folgendes eingetragen werden:

  • Pseudonym
  • Eine Kontaktinformation
  • Standort (Knotenname)
  • Notiz (z.B. Antennentyp, Ausrichtung, etc.)


3. WLAN-Einstellungen

Die Konfiguration von WLAN-Schnittstellen bei OpenWRT Kamikaze ist so aufgebaut, dass jedes physikalische WLAN-Gerät mehrere WLAN-Schnittstellen haben kann. Da diese Funktion allerdings vom Treiber des WLAN-Geräts abhängig ist und diese nur ein ADHOC-Signal ausstrahlen können wird bei uns meist nur eine erstellt werden.


Netzwerk->Drahtlos->WIFI0:

Folgende Einstellung in der Sektion Gerät:

  • Funkkanal: laut Liste    (Wenn der Kanal noch nicht anwählbar ist, manuell eintragen. Dies passiert, wenn der Ländercode noch nicht übernommen ist)
  • Modus : Auto
  • Diversität : deaktiviert
  • Sendeantenne: 1
  • Empfangsantenne: 1
  • Distanzoptimierung: 10000 bis 18000
  • Ländercode: AT

Folgende Einstellung in der Sektion Schnittstellen:

  • ESSID: laut Liste, z.B. v1.freiesnetz.www.funkfeuer.at
  • Netzwerk: z.B. olsrwifi0 (Verbindet Netzwerkeinstellungen mit WLAN-Einstellungen.)
  • Modus: Ad-Hoc
  • BSSID: laut Liste
  • Verschlüsselung: No Encryption


4. Netzwerk

Netzwerk->Schnittstellen->olsrwifi0 (olsrwifi0 Gegebenfalls durch den Namen, der in den WLAN-Einstellungen gewählt wurde, ersetzen.)

  • Protokoll: statisch
  • Netzwerkbrücke: deaktiviert
  • Schnittstelle: Normal ath0, bei mehreren Geräten/Schnittstellen ath1, ath2, etc., bei Broadcom-Geräten wl0
  • Zone: wan
  • IPv4-Adresse: die IP-Adresse dieses Devices, abzulesen in der Redeemer Device Übersicht
  • IPv4-Netzmaske:
    • bei einer IP-Adresse zwischen 193.238.156.0 und 193.238.159.254:  255.255.252.0 <- Achtung
    • bei einer IP-Adresse zwischen 78.41.112.0 und 78.41.113.254:        255.255.255.0 <- Achtung
  • IPv4-Gateway: LEER lassen!
  • DNS-Server: 193.238.157.5 193.238.156.225 208.67.220.220

5. Firewall

ist vom jeweiligen Anwendungsfall abhängig. Bei Geräten, die ausschließlich Funkfeuer-Netze verwenden hat sich das "Zulassen" aller Basissettings und das Löschen aller Zonen als beste Variante erwiesen.

Soll das Device eine Adresskonvertierung vornehmen (von privatem LAN in (öffentliches) Funkfeuer WLAN-Netz) ist im öffentliechen Bereich das "Masq"-Flag zu setzen.


6. OLSR

Plugins anpassen

Unter Dienste->OLSR->Plugins muss nichts angepasst werden. Als Plugins verwenden wir bei 0xFF-Funkfeuer Vienna arprefresh, textinfo und den watchdog.

OLSR Daemon

Unter Dienste->OLSR sind folgende Schritte anzupassen:


Schnittstellen

Es muss für jede Schnittstelle, auf der OLSR lauschen soll (normal nur WLAN und eventuell WAN), eine Sektion mit folgenden Einstellungen erstellt werden: (VORSICHT!!! Zahlen müssen mit einer Nachkommastelle angegeben werden.)

  • Enable: aktiviert
  • Netzwerk: olsrwifi0, bzw. an den jeweiligen OLSR Schnittstellennamen anpassen
  • IPv4 Broadcast: 255.255.255.255

Alle anderen Settings wurden bereits in der Konfiguration entsprechend angepasst. (Dies gilt nicht für Images, die direkt aus dem OpenWRT-Trunk gezogen werden!)