Freifunk MWU Wiki - Benutzerbeiträge [de]

Howto/GluonUpgrade

2014-12-14T15:48:56Z

Stefan: Terminal Ausgabe ergänzt

=Aktualisieren der alten Freifunk-Firmware=
→ Nötig wenn: Freifunk-Firmware vor Januar 2015 schon in Betrieb ging.

==Firmware besorgen==
Wir unterstützen eine ganze Reihe verschiedener Router.

Herauszufinden welche Gluon-Firmware du brauchst, ist ganz einfach:
:→ Der Router-Typ (1) und die Hardware-Version (2) stehen auf der Rückseite des Routers.

[[Datei:router-model-version.png]]
 

'''<big>Der passende Eintrag in unserer Dateiliste wäre dann dieser:''' </big>

[[Datei:FirmwareIndex.png]]

''Optional:'' Welche Router von GLUON unterstützt werden, kann man auch hier nachschlagen:
:→ [http://wiki.freifunk.net/Freifunk_Firmware_Gluon/Hardware Liste unterstützter Router]

Wir liefern hier die Gluon-Firmware für Mainz und Wiesbaden. Als Grenze haben wir uns an das jeweilige Bundesland gehalten.
:→ Wohnort?
::→ Mainz = Stadt, Umland Rheinhessen, Rheinland-Pfalz
::→ Wiesbaden = Stadt, Umland (auch AKK-Gemeinden) in Hessen
:→ Router hat schon ältere Freifunk-Software drauf > SysUpgrade-Image nötig

'''Lade dir hier jetzt deine passende Firmware:'''

{| class="wikitable" border="1"
|-
!style="color: #DFDF00; background: #{{Color|Blau}}; width: 100px; " | Wohnort
!style="color: #FFFFFF; background: #{{Color|Blau}}; width: 150px;" | SysUpgrade
|-
| '''Mainz'''
|→ [http://firmware.freifunk-mwu.de/mainz/stable/sysupgrade/ Download]
|-
| '''Wiesbaden'''
|→ [http://firmware.freifunk-mwu.de/wiesbaden/stable/sysupgrade/ Download]
|}

Speichere die Datei auf deinem Rechner zwischen bis wir sie wieder benötigen...

==Ausgangs-Szenarien==
Die folgende Beschreibung soll dir helfen, deinen bisherigen, schon im Freifunk-Netz benutzten (nicht-Gluon) Router, auf die neue Gluon-Firmware umzurüsten.

Hier sind die Ausgangs-Szenarios tabellarisch aufgelistet:

{| class="wikitable" border="1"
|-
!style="color: #FFFFFF; background: #{{Color|Blau}}; width: 150px; " | Router-Passwort
!style="color: #FFFFFF; background: #{{Color|Blau}}; width: 150px;" | Bekommt Freifunk-IP
!style="color: #DFDF00; background: #{{Color|Blau}}; width: 230px; " | Starte hier
|-
| unbekannt
| egal
| [[#Passwort_setzen_über_den_Failsafe-Modus|Neues Passwort setzen]]
|-
| bekannt
| Keine IP
| [[#Freifunk-IP_Adresse_setzen|Freifunk-IP Adresse setzen]]
|-
| bekannt
| OK
| [[#SSH_Verbindung_zum_Router_herstellen|SSH Verbindung zum Router herstellen]]
|}

==Passwort setzen über den Failsafe-Modus==
Wenn das Passwort für den "root"-User nicht (mehr) bekannt ist, müssen wir uns mit einem Trick wieder Zugriff verschaffen und ein neues Passwort setzen.

'''Folgende Schritte müssen dazu abgearbeitet werden:'''
* Setze deinen Rechner auf eine feste IP Adresse/Maske: z.B. 192.168.1.10 / 255.255.255.0
* Verbinde per Netzwerkkabel deinen Rechner mit einem LAN-Port deines Routers (bei WR841ND nimm den WAN-Port)
* Schalte den Router ein
**Power-Lampe leuchtet
**warte darauf das die "*" Lampe (daneben) zuckt
**Dann hurtig den '''Reset-Knopf''' auf der Rückseite ein paar mal drücken bis diese Lampe schnell flackert.
* ''Optional:'' Mit einem '''"ping 192.168.1.1"''' kannst du vom Rechner aus testen, ob der Router antwortet
* Mit '''"telnet 192.168.1.1"''' erfolgt der Zugriff (ohne Passwort)
* Verbindung ok, dann gib '''"mount_root"''' ein und warte auf die Bestätigung
* Nun mit '''"passwd"''' ein neues Passwort setzen und wiederholen. Hinschauen ob akzeptiert!
* Du kennst die Freifunk-IP Adresse nicht mehr? Dann nutze die Gelegenheit und lasse sie dir gleich anzeigen
** Gib ein: '''cat /etc/config/network|grep "10."'''
** Anzeige: ''' option ipaddr 10.37.xxx.xxx''' merken für SSH Zugriff
* Mit '''"reboot -f"''' neu booten lassen.
* Setze am Rechner deinen LAN-Port wieder auf DHCP zurück und stecke, wenn WR841ND, dort das Kabel vom WAN (blau) auf einen LAN-Port (gelb) zurück (wird gerne vergessen).
* Voraussetzungen für Zugriff per SSH mit neuem Passwort sind gegeben.

→ <big>Zurück zu [[#Voraussetzungen|Voraussetzungen]] gehen und Fragen neu bewerten</big>

==Freifunk-IP Adresse setzen==
Die Freifunk Adressen werden zentral vergeben. Steht das bisherige Netz nicht zur Verfügung, dann musst du deinen Rechner, mit dem du gleich per SSH darauf zugreifen willst, manuell eine Adresse setzen.

Benutze dazu eine Adresse aus dem Segment '''10.37.xxx.xxx''' mit der Netzwerkmaske '''255.255.0.0'''. Als Beispiel: '''10.37.88.99'''.

→ <big>Weiter machen mit nachfolgenden Schritten</big>

==SSH Verbindung zum Router herstellen==
Jetzt deinen Rechner mit einem LAN-Port deines Routers per Kabel verbinden.

Mit einem SSH Befehl (Unix) oder dem kostenlosen Programm PUTTY für Windows-PCs baust du eine Verbindung zu deinem Router auf. Deine Router-Adresse kennst du ja oder hast sie vorhin ausgelesen (siehe [[Passwort setzen über den Failsafe-Modus|Neues Passwort setzen]]).

Benutzer: '''root'''
Passwort: ''dein neu gesetztes oder bekanntes Passwort''

→ Mehr Informationen zum Bezug von Putty und dessen Nutzung findet man [[http://www.rfactory.org/OpenWRT/winscp.html#putty HIER]]

==Neue Firmware-Datei auf den Router übertragen==

Das Ziel ist es, die Firmware-Datei auf den Router in das Verzeichnis '''/tmp''' zu bringen.
Dazu gibt es mehrere Möglichkeiten (Experten kennen vermutlich noch mehr und brauchen dazu keine Anleitung):

=== Nutzen des SCP-Transfers===
*Auf dem Router ist ein Mini-FTP Server installiert (Dropbear) den wir ansprechen können.
*Dazu benötigen wir den entsprechenden Client.
::→ Für Windows-PCs kann man das kostenlose WinSCP laden. Eine Quelle und Beschreibung wie man damit umgeht: [[http://www.rfactory.org/OpenWRT/winscp.html Klick hier]]
*Verbindung aufbauen:
::→ Sie benötigen die Freifunk-IP Adresse des Routers
::→ Port: 22 (SSH)
::→ Benutzer: root
::→ Passwort: ''dein dir bekanntes root-Passwort''
::→ Verbindung herstellen
*Navigieren in das lokale Verzeichnis wo die Firmware-Datei liegt
*Navigieren in das Routerverzeichnis /tmp
*Per Drag&Drop die Datei auf den Router ziehen
*Kopiervorgang läuft nur ein paar Sekunden - kurz warten bis fertig
*Verbindung kann getrennt werden. Programm beenden

===Laden des Images aus dem Internet===
*Freifunk-Router hat einen funktionierenden VPN-Anschluß zum Freifunk-Gateway (hängt an deinem DSL-Router)
::→ Log dich mit SSH auf den Router ein
::→ Gib ein: '''cd /tmp'''
::→ Gib ein: '''sync'''
::→ Gib ein: '''echo 3 > /proc/sys/vm/drop_caches'''
::→ Mainz: Gib ein: '''<nowiki>wget http://firmware.freifunk-mwu.de/mainz/stable/sysupgrade/{SysUpgrade-Dateiname}.bin</nowiki>'''
::→ Wiesbaden: Gib ein: '''<nowiki>wget http://firmware.freifunk-mwu.de/wiesbaden/stable/sysupgrade/{SysUpgrade-Dateiname}.bin</nowiki>'''
::→ Transfer findet statt

==Neue Firmware-Datei im Router installieren==
*Die neue Firmware-Datei ist auf dem Router im /tmp Verzeichnis vorhanden
*Sie muß jetzt installiert werden
*Gib ein: '''sysupgrade -n /tmp/{SysUpgrade-Dateiname}.bin
** Tip: Wenn du die ersten Buchstaben des Firmware-Dateinamens getippt hast, kannst du mit der TAB-Taste den Rest ergänzen lassen.
*Der Router wird jetzt "geflasht" - bekommt also die neue Firmware fest eingebrannt.
'''JETZT AUF KEINEN FALL ABBRECHEN ODER AUSSCHALTEN'''

Im Terminal sieht das ganze so aus:

root@OpenWrt:/tmp# sysupgrade -n /tmp/{SysUpgrade-Dateiname}.bin
killall: watchdog: no process killed
Sending TERM to remaining processes ... ubusd askfirst netifd tincd ntpd
Sending KILL to remaining processes ... ubusd askfirst
Switching to ramdisk...
Performing system upgrade...
Unlocking firmware ...

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

Der Router startet automatisch neu, wenn der Vorgang beendet ist.
Er befindet sich dann im Konfigurationsmodus und möchte für das neue Netz konfiguriert werden.

<big>→ Weiter gehts mit dem Punkt: [[Howto/GluonKonfig#Router_konfigurieren_im_Wizard-Modus|Router einrichten]]</big>

Howto/GluonUpgrade

2014-12-14T15:40:22Z

Stefan: Link korrigiert

=Aktualisieren der alten Freifunk-Firmware=
→ Nötig wenn: Freifunk-Firmware vor Januar 2015 schon in Betrieb ging.

==Firmware besorgen==
Wir unterstützen eine ganze Reihe verschiedener Router.

Herauszufinden welche Gluon-Firmware du brauchst, ist ganz einfach:
:→ Der Router-Typ (1) und die Hardware-Version (2) stehen auf der Rückseite des Routers.

[[Datei:router-model-version.png]]
 

'''<big>Der passende Eintrag in unserer Dateiliste wäre dann dieser:''' </big>

[[Datei:FirmwareIndex.png]]

''Optional:'' Welche Router von GLUON unterstützt werden, kann man auch hier nachschlagen:
:→ [http://wiki.freifunk.net/Freifunk_Firmware_Gluon/Hardware Liste unterstützter Router]

Wir liefern hier die Gluon-Firmware für Mainz und Wiesbaden. Als Grenze haben wir uns an das jeweilige Bundesland gehalten.
:→ Wohnort?
::→ Mainz = Stadt, Umland Rheinhessen, Rheinland-Pfalz
::→ Wiesbaden = Stadt, Umland (auch AKK-Gemeinden) in Hessen
:→ Router hat schon ältere Freifunk-Software drauf > SysUpgrade-Image nötig

'''Lade dir hier jetzt deine passende Firmware:'''

{| class="wikitable" border="1"
|-
!style="color: #DFDF00; background: #{{Color|Blau}}; width: 100px; " | Wohnort
!style="color: #FFFFFF; background: #{{Color|Blau}}; width: 150px;" | SysUpgrade
|-
| '''Mainz'''
|→ [http://firmware.freifunk-mwu.de/mainz/stable/sysupgrade/ Download]
|-
| '''Wiesbaden'''
|→ [http://firmware.freifunk-mwu.de/wiesbaden/stable/sysupgrade/ Download]
|}

Speichere die Datei auf deinem Rechner zwischen bis wir sie wieder benötigen...

==Ausgangs-Szenarien==
Die folgende Beschreibung soll dir helfen, deinen bisherigen, schon im Freifunk-Netz benutzten (nicht-Gluon) Router, auf die neue Gluon-Firmware umzurüsten.

Hier sind die Ausgangs-Szenarios tabellarisch aufgelistet:

{| class="wikitable" border="1"
|-
!style="color: #FFFFFF; background: #{{Color|Blau}}; width: 150px; " | Router-Passwort
!style="color: #FFFFFF; background: #{{Color|Blau}}; width: 150px;" | Bekommt Freifunk-IP
!style="color: #DFDF00; background: #{{Color|Blau}}; width: 230px; " | Starte hier
|-
| unbekannt
| egal
| [[#Passwort_setzen_über_den_Failsafe-Modus|Neues Passwort setzen]]
|-
| bekannt
| Keine IP
| [[#Freifunk-IP_Adresse_setzen|Freifunk-IP Adresse setzen]]
|-
| bekannt
| OK
| [[#SSH_Verbindung_zum_Router_herstellen|SSH Verbindung zum Router herstellen]]
|}

==Passwort setzen über den Failsafe-Modus==
Wenn das Passwort für den "root"-User nicht (mehr) bekannt ist, müssen wir uns mit einem Trick wieder Zugriff verschaffen und ein neues Passwort setzen.

'''Folgende Schritte müssen dazu abgearbeitet werden:'''
* Setze deinen Rechner auf eine feste IP Adresse/Maske: z.B. 192.168.1.10 / 255.255.255.0
* Verbinde per Netzwerkkabel deinen Rechner mit einem LAN-Port deines Routers (bei WR841ND nimm den WAN-Port)
* Schalte den Router ein
**Power-Lampe leuchtet
**warte darauf das die "*" Lampe (daneben) zuckt
**Dann hurtig den '''Reset-Knopf''' auf der Rückseite ein paar mal drücken bis diese Lampe schnell flackert.
* ''Optional:'' Mit einem '''"ping 192.168.1.1"''' kannst du vom Rechner aus testen, ob der Router antwortet
* Mit '''"telnet 192.168.1.1"''' erfolgt der Zugriff (ohne Passwort)
* Verbindung ok, dann gib '''"mount_root"''' ein und warte auf die Bestätigung
* Nun mit '''"passwd"''' ein neues Passwort setzen und wiederholen. Hinschauen ob akzeptiert!
* Du kennst die Freifunk-IP Adresse nicht mehr? Dann nutze die Gelegenheit und lasse sie dir gleich anzeigen
** Gib ein: '''cat /etc/config/network|grep "10."'''
** Anzeige: ''' option ipaddr 10.37.xxx.xxx''' merken für SSH Zugriff
* Mit '''"reboot -f"''' neu booten lassen.
* Setze am Rechner deinen LAN-Port wieder auf DHCP zurück und stecke, wenn WR841ND, dort das Kabel vom WAN (blau) auf einen LAN-Port (gelb) zurück (wird gerne vergessen).
* Voraussetzungen für Zugriff per SSH mit neuem Passwort sind gegeben.

→ <big>Zurück zu [[#Voraussetzungen|Voraussetzungen]] gehen und Fragen neu bewerten</big>

==Freifunk-IP Adresse setzen==
Die Freifunk Adressen werden zentral vergeben. Steht das bisherige Netz nicht zur Verfügung, dann musst du deinen Rechner, mit dem du gleich per SSH darauf zugreifen willst, manuell eine Adresse setzen.

Benutze dazu eine Adresse aus dem Segment '''10.37.xxx.xxx''' mit der Netzwerkmaske '''255.255.0.0'''. Als Beispiel: '''10.37.88.99'''.

→ <big>Weiter machen mit nachfolgenden Schritten</big>

==SSH Verbindung zum Router herstellen==
Jetzt deinen Rechner mit einem LAN-Port deines Routers per Kabel verbinden.

Mit einem SSH Befehl (Unix) oder dem kostenlosen Programm PUTTY für Windows-PCs baust du eine Verbindung zu deinem Router auf. Deine Router-Adresse kennst du ja oder hast sie vorhin ausgelesen (siehe [[Passwort setzen über den Failsafe-Modus|Neues Passwort setzen]]).

Benutzer: '''root'''
Passwort: ''dein neu gesetztes oder bekanntes Passwort''

→ Mehr Informationen zum Bezug von Putty und dessen Nutzung findet man [[http://www.rfactory.org/OpenWRT/winscp.html#putty HIER]]

==Neue Firmware-Datei auf den Router übertragen==

Das Ziel ist es, die Firmware-Datei auf den Router in das Verzeichnis '''/tmp''' zu bringen.
Dazu gibt es mehrere Möglichkeiten (Experten kennen vermutlich noch mehr und brauchen dazu keine Anleitung):

=== Nutzen des SCP-Transfers===
*Auf dem Router ist ein Mini-FTP Server installiert (Dropbear) den wir ansprechen können.
*Dazu benötigen wir den entsprechenden Client.
::→ Für Windows-PCs kann man das kostenlose WinSCP laden. Eine Quelle und Beschreibung wie man damit umgeht: [[http://www.rfactory.org/OpenWRT/winscp.html Klick hier]]
*Verbindung aufbauen:
::→ Sie benötigen die Freifunk-IP Adresse des Routers
::→ Port: 22 (SSH)
::→ Benutzer: root
::→ Passwort: ''dein dir bekanntes root-Passwort''
::→ Verbindung herstellen
*Navigieren in das lokale Verzeichnis wo die Firmware-Datei liegt
*Navigieren in das Routerverzeichnis /tmp
*Per Drag&Drop die Datei auf den Router ziehen
*Kopiervorgang läuft nur ein paar Sekunden - kurz warten bis fertig
*Verbindung kann getrennt werden. Programm beenden

===Laden des Images aus dem Internet===
*Freifunk-Router hat einen funktionierenden VPN-Anschluß zum Freifunk-Gateway (hängt an deinem DSL-Router)
::→ Log dich mit SSH auf den Router ein
::→ Gib ein: '''cd /tmp'''
::→ Gib ein: '''sync'''
::→ Gib ein: '''echo 3 > /proc/sys/vm/drop_caches'''
::→ Mainz: Gib ein: '''<nowiki>wget http://firmware.freifunk-mwu.de/mainz/stable/sysupgrade/{SysUpgrade-Dateiname}.bin</nowiki>'''
::→ Wiesbaden: Gib ein: '''<nowiki>wget http://firmware.freifunk-mwu.de/wiesbaden/stable/sysupgrade/{SysUpgrade-Dateiname}.bin</nowiki>'''
::→ Transfer findet statt

==Neue Firmware-Datei im Router installieren==
{{todo|Wer mag kann hier noch ein paar Zeilen hinzufügen, die die Meldungen zeigen, die da ablaufen}}
*Die neue Firmware-Datei ist auf dem Router im /tmp Verzeichnis vorhanden
*Sie muß jetzt installiert werden
*Gib ein: '''sysupgrade -n /tmp/{SysUpgrade-Dateiname}.bin
** Tip: Wenn du die ersten Buchstaben des Firmware-Dateinamens getippt hast, kannst du mit der TAB-Taste den Rest ergänzen lassen.
*Der Router wird jetzt "geflasht" - bekommt also die neue Firmware fest eingebrannt.
JETZT AUF KEINEN FALL ABBRECHEN ODER AUSSCHALTEN
Der Router startet automatisch neu, wenn der Vorgang beendet ist.
Er befindet sich dann im Konfigurationsmodus und möchte für das neue Netz konfiguriert werden.

<big>→ Weiter gehts mit dem Punkt: [[Howto/GluonKonfig#Router_konfigurieren_im_Wizard-Modus|Router einrichten]]</big>

Howto/Freifunk-Knoten aufstellen

2014-09-09T07:53:37Z

Stefan: E-Mail-Adresse für Schlüssel ergänzt.

Dies ist eine allgemeine Anleitung zur Teilnahme am Netz von Freifunk Mainz. An dieser Stellen setzen wir voraus, dass du dir bereits einen geeigneten Router zugelegt hast.

'''[[Welchen_Router_kaufe_ich|Hier findest du eine Tabelle mit den von uns empfohlenen Geräten]].'''

Der Prozess der Installation und Konfiguration umfasst folgende Schritte:

__TOC__

= Router Flashen: OpenWrt installieren =
Der Router kommt von Haus aus mit einer Firmware des Herstellers. Damit können wir nicht arbeiten. Deswegen muss zunächst ein freies Betriebssystem namens [https://openwrt.org/ OpenWrt] als Firmware auf den Router aufgespielt werden. Diesen Schritt nennen wir "Flashen". Eine grobe Übersicht, wie das Flashen vor sich geht [[Howto/Flashen | findet man hier]].

Um den Prozess einfacher zu machen, und da der Speicherplatz auf den billigeren Routern sehr begrenzt ist, haben wir '''vorkompilierte Images''' im Angebot:
Die jeweils aktuelle Version für deinen Router liegt unter [http://images.freifunk-mainz.de images.freifunk-mainz.de].

'''Alternativ''' kann dem Router auch ein "normales" OpenWRT verpasst werden, dann muss man jedoch die benötigten Pakete folgendermaßen von Hand nachinstallieren:

Der Pfad in "/etc/opkg.conf" hat sich geändert!
Die erste Zeile muss nun "src/gz barrier_breaker http://downloads.openwrt.org/snapshots/trunk/ar71xx/packages/packages" lauten. (das letzte 'packages' ist neu)

opkg update
opkg install kmod-batman-adv tinc

(Hinweis: Wenn du nicht unser vorgefertigtes Image verwendest, musst du sicher stellen, dass du die richtige Version des Batman-Protokolls aus 2013 installierst, damit dein Knoten mit unserem Netz kompatibel ist (2013.4.0))

= Router konfigurieren =

Nachdem OpenWRT erfolgreich auf den Router geflasht ist, bezieht dieser zunächst automatisch die IP-Adresse <code>192.168.1.1</code>. Da bereits ein DHCP Server initial auf den Kisten läuft musst du dir keine eigene IP-Adresse setzen.

== Passwort setzen ==
Bei OpenWRT ist es üblich, dass das erste Einloggen per Telnet erfolgt, um das Root-Passwort zu ändern.
Windows-Benutzer haben eventuell kein Telnet zur Verfügung. Stattdessen kann hier Putty benutzt werden (darin als Protokoll dann Telnet wählen).

Folgende Befehle musst du auf der Kommandozeile eingeben:

telnet 192.168.1.1

passwd <enter>
Neues Passwort eingeben:
Neues Passwort wiederholen:

(Achtet darauf, das die Passwortänderung auch bestätigt wird und ihr euch nicht beim Wiederholen vertippt habt).

Danach ist Telnet auf Port 23 abgeschaltet und künftige Verbindungen nur noch per SSH möglich. Verbindung trennen und nun mit folgenden Möglichkeiten neu einloggen:

'''Unix-Benutzer: '''Die weiteren Einlogvorgänge erfolgen dann über SSH als Benutzer root:

$ ssh root@192.168.1.1

'''Windows-Benutzer: '''Mittels dem kostenlosen Tool PUTTY ([http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Download]) - Hier Login per IP Adresse und SSH (Port 22). Beim Verbindungsaufbau wird ein Vertrauensschlüssel angezeigt, den man speichern kann.

Benutzer eingeben: "root"
Passwort eingeben: was du oben mit passwd neu gesetzt hattest

[[Datei:Putty sample1.jpg]]

==Empfehlung: Sicherung der wichtigsten Dateien==

Die Praxis zeigt, dass es gut ist, später nochmal einen Blick in die Original-Dateien werfen zu können, wenn es um definierte Hardware Eigenschaften geht. Wer mag legt Kopien an von:

mkdir -p /etc/config/originals
cp /etc/config/* /etc/config/originals

Die Meldung "omitting directory originals" ignorieren.

* Alternativ: Für ein Backup ohne Fehlermeldung (dafür aber schlimm einzugeben ;)

mkdir -p /etc/config/originals/
cd /etc/config
cp -r `ls -A /etc/config/ | grep -v 'originals'` /etc/config/originals/

==Netzwerk konfigurieren==

===IP-Adresse benötigt?===

Die IP-Adresse für Deinen Router suchst Du Dir selbst aus und dokumentierst sie auf deiner Benutzerseite. Bitte beachte vor Auswahl der IP-Adresse die [[Systeme/Nodes|Nodeliste]], so dass die IP-Adresse tatsächlich noch frei ist. Du benötigest für einen Router nur eine IP-Adresse.

[[Spezial:Benutzerkonto_beantragen | Lege Dir hier im Wiki ein Konto]] an und dokumentiere Deinen neuen Router auf Deiner Benutzerseite. Für Letzteres gibt es eine Vorlage namens [[Vorlage:Node|"Node"]]. Wie diese benutzt wird, schaust Du Dir am einfachsten auf den Seiten [[Spezial:Benutzer|anderer Benutzer]] ab. Deine eigene Seite erreichst du, wenn du (im eingeloggten Zustand) oben auf deinen Namen klickst.
:Wenn du schonmal dabei bist, trage bitte auch auf deiner Benutzerseite deine E-Mail-Adresse ein, damit wir dich erreichen, falls irgendwas mit dem Router nicht stimmt oder wir eine neue Version der Firmware einsetzten. Nimm dazu einfach unsere [[Vorlage:Kontakt|Vorlage]] und trage die Daten ein, die du Preisgeben willst (wichtig ist, wie geschrieben, die Mailadresse).

===Verschiedene Interface-Namen bei Routern:===
Leider unterscheiden sich die Addressierungen der Netzwerkinterfaces der Router je nach Modell und Hardware-Revision.
Im folgenden der Anleitung werden die Interfaces als <WAN-IF> und <SWITCH-IF> bezeichnet.
{{Todo|Du hast einen Router, der nicht in der Tabelle ist? Dann bitte nachtragen.}}
{| class="wikitable sortable"
! Router-Modell
! HW-Revision
! style="background: #{{Color|Blau}}; " | WAN-Interface
! style="background: #{{Color|Gelb}};" | Switch-Interface
! 2,4 GHz
! 5 GHz
|-
| tl-wr741nd
| v2,v5
| eth1
| eth0
| Ja
| Nein
|-
| tl-wr841nd
| v5
| eth1
| eth0
| Ja
| Nein
|-
| tl-wr841nd
| v7 & v8
| eth0
| eth1
| Ja
| Nein
|-
| tl-wr1043nd
| v 1.x
| eth0.2
| eth0.1
| Ja
| Nein
|-
| tl-wr1043nd
| v 2.x
| eth0
| eth1
| Ja
| Nein
|-
| tl-wdr3500
| v1
| eth1
| eth0
| Ja
| Ja
|-
| tl-wdr3600
| v1
| eth1
| eth0
| Ja
| Ja
|-
| tl-wdr4300
| v1.x
| eth0.2
| eth0.1
| Ja
| Ja
|-
| wrt160nl
| v1
| eth1
| eth0
| Ja
| Nein
|-
| nanostation M5
| keine Markierung
| eth0
| n.v.
| nein
| ja
|}

===Datei NETWORK bearbeiten===
Laden der Datei ''network'' in den Editor. Eine Hilfe gibt es:
[http://www.linux-fuer-alle.de/doc_show.php?docid=29 hier]

vi /etc/config/network

Wenn du dich mit den wichtigsten VI-Befehlen bekannt gemacht hast, solltest du '''zuerst den wichtigen BEFEHL ":set noai" eingeben.''' Dieser verhindert, dass eingefügte Blöcke nicht zeilenweise nach rechts verschoben werden.

Einige Teile der Datei müssen jetzt ausgetauscht, andere ergänzt werden.

Gehen wir die Blöcke einfach mal durch:

{{Config-Block
|Zeile=config interface 'loopback'
|Aktion=Der ganze Block bleibt erhalten
|}}

{{Config-Block
|Zeile=config globals 'globals'
|Aktion=Der ganze Block (2 Zeilen) fliegt raus!
|strike=true
|}}

An dieser Stelle fügen wir ein: (Bei Putty-Nutzern = Shift-Einfg)

config interface 'vpn'
option ifname 'freifunk_vpn'
option mtu '1500'
option proto 'batadv'
option mesh 'bat0'

config interface 'mesh'
option ifname 'adhoc0'
option mtu '1528'
option proto 'batadv'
option mesh 'bat0'

{{Config-Block
|Zeile=config interface 'lan'
|Aktion=Dieser Block wird gleich entfernt, vorher jedoch die Zeile '''option ifname''' suchen und den Namen des Interfaces mit der Angabe in der Tabelle oben vergleichen. Dieser Name ist das <SWITCH-IF>. '''Block danach löschen'''.
|strike=true
|}}
'''Hinweis für Leute mit Vorbildung:''' 
Das LAN Interface wird nicht vernichtet, sondern durch den neuen Block umbenannt in "freifunk".

An dieser Stelle einsetzen:
Für Router '''nur''' mit 2,4 GHz ...

config interface 'freifunk'
option ifname '<SWITCH-IF> bat0 freifunk_wlan'
option type 'bridge'
option proto 'static'
# Eure IP-Addresse aus dem bei ipaddr ersetzen (IP-Adresse bekommt ihr über hallo@freifunk-mainz.de)
option ipaddr '10.37.X.X'
option netmask '255.255.0.0'
option dns '10.37.4.1'

Für Router mit 2,4 GHz '''und''' 5 GHz ...

config interface 'freifunk'
option ifname '<SWITCH-IF> bat0 freifunk_wlan freifunk_wlan2'
option type 'bridge'
option proto 'static'
# Eure IP-Addresse aus dem WIKI bei ipaddr ersetzen (IP-Adresse bekommt ihr über hallo@freifunk-mainz.de)
option ipaddr '10.37.X.X'
option netmask '255.255.0.0'
option dns '10.37.4.1'

{{Config-Block
|Zeile=config interface 'wan'
|Aktion=Dieser Block bleibt erhalten
|}}

{{Config-Block
|Zeile=config interface 'wan6'
|Aktion=Der ganze Block (3 Zeilen) fliegt raus!
|strike=true
|}}

{{Config-Block
|Zeile=config switch...
|Aktion=Diese (beiden) Blöcke bleiben erhalten
|}}

Speichern und raus: Bei 'vi' mit ESC :wq

==DNS Ausschalten==

DNS und DHCP muss immer (für die lokale Vergabe durch den FF-Router) abgeschaltet sein. Diese Aufgabe übernimmt das [[FAQ#Mitmachen|Gateway]].

Du kannst DNS und DHCP abschalten durch einmaliges Absetzen des folgenden Befehls, damit keine IP-Adressen vom Router selbst verteilt werden:

/etc/init.d/dnsmasq disable

==WLAN konfigurieren==

Laden der Datei ''wireless'' in den Editor. Eine Hilfe für den vi-editor gibt es:
[http://www.linux-fuer-alle.de/doc_show.php?docid=29 hier ]

vi /etc/config/wireless

Der Inhalt wird modifiziert und ergänzt. Gehen wir wieder die Blöcke durch

{{Config-Block
|Zeile=config wifi-device radio0
|Aktion=Dieser Block bleibt erhalten. Bei dieser Zeile prüfen, ob Kanal 11 eingestellt ist: '''option channel 11'''.
|}}

Danach das WLAN einschalten (im selben Block '''config wifi-device radio0'''):

{{Config-Block
|Zeile=option disabled 1
|Aktion=diese Zeile entfernen
|strike=true
|}}

In der Original-Datei gibt es dahinter nun einen Block:

{{Config-Block
|Zeile=config wifi-iface
|Aktion=Dieser ganze Block wird entfernt und statt dessen durch gleich zwei Blöcke ersetzt!
|strike=true
|}}

Einfügen an dieser Stelle:

config wifi-iface
option device 'radio0'
option encryption 'none'
option ssid 'mesh'
option ifname 'adhoc0'
option mode 'adhoc'
option bssid '02:ca:ff:ee:ba:be'

config wifi-iface
option device 'radio0'
option mode 'ap'
option encryption 'none'
option ifname 'freifunk_wlan'
option ssid 'Freifunk Mainz'
option network 'freifunk'
option isolate '1'

Nur bei einem Dualband Router mit 2,4 und 5 GHz geht es in der Originaldatei weiter. Alle anderen speichern jetzt und sind fertig mit der Bearbeitung dieser Datei.

Bei Routern mit zusätzlichem 5 GHz-Band gibt es jetzt noch einmal die gleichen Blöcke für "radio1".

{{Config-Block
|Zeile=config wifi-device radio1
|Aktion=Dieser Block bleibt erhalten.
|}}

Danach das WLAN einschalten (im selben Block '''config wifi-device radio1'''):

{{Config-Block
|Zeile=option disabled 1
|Aktion=diese Zeile entfernen
|strike=true
|}}

In der Original-Datei gibt es dahinter wieder nur einen Block:

{{Config-Block
|Zeile=config wifi-iface
|Aktion=Dieser ganze Block wird entfernt und statt dessen durch gleich zwei Blöcke ersetzt!
|strike=true
|}}

Der letzte Block wird wieder entfernt und durch diese Blöcke ersetzt:

config wifi-iface
option device 'radio1'
option mode 'adhoc'
option encryption 'none'
option ifname 'adhoc0'
option ssid 'mesh'
option bssid '02:ca:ff:ee:ba:be'

config wifi-iface
option device 'radio1'
option mode 'ap'
option encryption 'none'
option ifname 'freifunk_wlan2'
option ssid 'Freifunk Mainz'
option network 'freifunk'
option isolate '1'

Wir speichern wieder mit ESC :wq

==Tinc konfigurieren==

===Reiner Mesh-Node?===
Auch wenn der Router nur als Mesh-Node, also ohne DSL Zugang, nur mit reiner Funkverbindung zu Nachbar-Knoten dienen soll, lohnt es sich die folgenden Schritte trotzdem durchzuführen. Das Melden des öffentlichen Schlüssels kann dann aber entfallen. Man ist gut vorbereitet, falls der Node dann später doch mal an einen DSL-Anschluss angeschlossen werden soll.

Tinc auszuschalten ist zwar nicht unbedingt nötig, hilft dem Router dann allerdings Resourcen zu sparen. Wie das Aus- und Einschalten von Tinc geht, steht am Ende unter [weitere Handgriffe].

===Datei TINC bearbeiten===
Laden der Datei ''tinc'' in den Editor. Eine Hilfe für den VI-Editor gibt es:
[http://www.linux-fuer-alle.de/doc_show.php?docid=29 hier]

vi /etc/config/tinc

Der komplette Inhalt wird gelöscht und mit folgendem Inhalt gefüllt (NODENAME bitte austauschen):


Man kann vor dem öffnen komfortabel die Datei leeren
echo > /etc/config/tinc
Sicher hast du ja das obige Backup aller Dateien gemacht, oder? Wirklich? Ganz sicher?


config tinc-net 'ffmz'
option enabled '1'
option generate_keys '1'
# NODENAME ersetzen. Wird aus der IP im Wiki erstellt durch Entfernung der Punkte
# z.B. 10.37.1.100 wird zu 10371100. Es kann zu Doppeldeutigkeiten kommen.
option Name 'NODENAME'
option key_size '2048'
option logfile '/tmp/log/tinc.ffmz.log'
option debug '0'
# gate2 ist derzeit das einzig existierende Gateway
list ConnectTo 'gate2'
option DirectOnly '1'
option Forwarding 'off'
option Interface 'freifunk_vpn'
option Mode 'switch'
option Compression '10'

Der NODENAME muss hier eingesetzt werden. Dazu gerade mal ein Wort, warum es bei der Namensbildung zu Doppeldeutigkeiten kommen kann und was man dagegen tun kann. Wir benutzen dazu die IP-Adresse des Gerätes, die du in der NETWORK Datei eingetragen hast und entfernen einfach alle Punkte.

'''Beispiel: '''die IP 10.37.11.60 würde zu 10371160 wenn man nur die Punkte entfernt. Jetzt ergibt aber 10.37.1.160 den gleichen Nodenamen. Soweit klar?. Um den Namen wieder eindeutig zu bekommen sollte man den 3.+4. Block der Adresse mit linksbündigen Nullen auffüllen. Das sieht dann so aus: 10.37.11.60 wird dann zu 1037011060 - Leuchtet ein? Der Nodename wird benutzt um den Dateinamen von TINC erstellen zu lassen, der den privaten Schlüssel enthält. Einfach weiterlesen...

'''TINC-Key und Nodenamen schon mal früher erstellt?''' 
Du hattest schon mal für das Gerät einen Nodenamen und TINC Keys gemeldet zum Eintragen am Server, dann BEHALTE die Daten bei. Verwende den Nodenamen weiter. Lasse mit dem nächsten Kommando die Schlüssel erzeugen und setze die TINC-Keys, die du von früher gesichert hattest wieder ein. Hast du die alten Schlüssel nicht mehr oder einen anderen Nodenamen benutzt, musst du den öffentlichen Schlüssel samt NODENAMEN neu melden.

Speicher und verlassen des Editors wieder mit ESC :wq

Tinc neu starten damit einmalig die Schlüssel generiert werden (Achtung: zum erneuten Generieren von Schlüsseln muss das Verzeichnis "/etc/tinc/ffmz" gelöscht oder verschoben werden!)

/etc/init.d/tinc restart

Durch "......." wird eine Tätigkeit angezeigt. Danach finden wir ein neues Verzeichnis mit neuen Dateien.

cd /etc/tinc/ffmz

Zeigt eine '''rsa_key.priv''' und ein weiteres Unterverzeichnis '''hosts'''. Die '''rsa_key.priv''' beinhaltet den privaten Schlüssel der nicht herausgegeben, aber extern als Sicherheitskopie aufbewahrt werden sollte. Genau so verhält es sich mit dem öffentlichen Schlüssel den wir im hosts Unterverzeichnis finden.

cd /etc/tinc/ffmz/hosts

Der öffentliche Schlüssel hat den Namen den wir in der TINC Datei eben unter '''option Name 'NODENAME'''' eingetragen haben.

Dessen Inhalt auflisten (cat 1037.....) und per Mail an {{nospam|keys|freifunk-mainz|de}} zusammen mit dem NODENAMEN senden. Dieser Schlüssel muss im gate2 eingetragen werden.

Datei '''gate2''' im Verzeichnis hosts anlegen:

vi /etc/tinc/ffmz/hosts/gate2

Befüllen mit dem Inhalt aus der unten angezeigten Tabelle - GATE2 - (Gate1 ist offline)

{{#ask: [[Freifunk-Gateway::+]]
|?Node-Tinc-Key = Tinc-Key
|?Node-Kommentar = Kommentar
| mainlabel=Gateway
| intro=In dieser Tabelle werden unsere Gateways mitsamt den dazugehörigen Tinc-Schlüsseln gelistet
|}}

Wir speichern wieder mit ESC :wq

=====MAC-Adresse für Karte anpassen=====
Damit unsere schicke [http://map.freifunk-mainz.de/ Freifunk Karte] korrekt funktionieren kann müssen die MAC-Adressen vom VPN-Interface eindeutig und konsistent sein, damit die [http://oldwiki.freifunk-mainz.de/doku.php?id=systeme:nodes hinterlegten Geo Koordinaten] zugeordnet werden können, und somit ein (grüner-)Punkt auf die Karte gezeichnet werden kann.
Leider vergibt OpenWRT die MAC-Adressen pro Start vom Tinc-Interface per Zufall, sodass man ständig das Wiki nach jedem Neustart anpassen müsste.

:(NB: Sollte Dein Node ''kein'' tinc verwenden, so wird auch ''nicht'' die MAC-Adresse des VPN-Interface für die Karte genutzt. Für die Karte ist immer die MAC-Adresse relevant, die mittels "<code>batctl o | head -1</code>" angezeigt wird - ggfs. ''nach'' der im Folgenden beschriebenen Anpassung.)

Um den manuellen Änderungsbedarf im Wiki zu vermeiden, wird ein Start-Script für Tinc angelegt, das die MAC-Adresse immer fest setzt. Diese feste MAC-Adresse lässt sich anhand der IP-Adresse des Knotens [http://freifunk-mainz.de/mac.html mit unserem Generator ermitteln] und wird im Skript unter "<MAC-ADRESSE>" eingetragen.

Neue leere Datei für Skript anlegen:

vi /etc/tinc/ffmz/tinc-up

Dort Folgendes reinkopieren und Adresse aus Generator einsetzen:

#!/bin/sh
ifconfig $INTERFACE hw ether <MAC-ADRESSE>

Danach machen wir das Script noch ausführbar:

chmod +x /etc/tinc/ffmz/tinc-up

Nach einem '''/etc/init.d/tinc restart''' lässt sich mittels '''ifconfig freifunk_vpn''' überprüfen, ob die MAC-Adresse korrekt gesetzt wurde.

==Firewall Datei befüllen ==

Die Firewall Datei muss neuen Inhalt bekommen.

vi /etc/config/firewall

Alles muss raus. Neu rein der folgende Inhalt:


Man kann vor dem öffnen komfortabel die Datei leeren
echo > /etc/config/firewall
Bitte '''vorher''' ein Backup machen!


config defaults
option syn_flood 1
option input ACCEPT
option output ACCEPT
option forward REJECT

config zone
option name wan
option network 'wan'
option input ACCEPT
option output ACCEPT
option forward REJECT

config zone
option name freifunk
option network 'freifunk'
option input ACCEPT
option output ACCEPT
option forward REJECT

config rule
option name Reject-Telnet
option src freifunk
option proto tcp
option dest_port 23
option target REJECT

Wir speichern wieder mit ESC :wq

==Weitere Handgriffe==

Diesen Befehl noch absetzen. Für Nodename wieder den in der TINC Datei angegebenen verwenden:

uci set system.@system[0].hostname=NODENAME

WOW - fast fertig: jetzt kommt ein Reboot. Dann heißt es "Daumen drücken" - Viel Glück

reboot -f

PS: Am Freifunk-Router muss jetzt vom WAN Port aus ein Kabel zum privaten Router führen, damit TINC eine VPN Verbindung herstellen kann, oder ein anderer Freifunk-Router in Funkreichweite sein, damit das eben erzeugte Gerät sich damit vermeshen kann. Sonst gibt es nach dem Boot-Vorgang keine IP-Adresse vom neuen FF-Router. Ist eine VPN Verbindung notwendig, funktioniert die natürlich erst, wenn dein öffentlicher Schlüssel, den du über die E-Mail Adresse gesendet hast zusammen mit deinem NODENAME am Gateway von einem unserer Admins eingetragen ist. Geduld bitte.
Das folgende Bild stellt die Verkabelung (falls sie gewünsch ist) symbolisch dar.
[[Datei:physical.png|Bild]]

----

===Tinc ausschalten===
Wird der Node nicht an einem DSL-Anschluss angeschlossen, kann man den TINC Prozess anhalten

/etc/init.d/tinc disable
/etc/init.d/tinc stop

Schaut man dann mit "ps" nach, müsste der "tincd" Service verschwunden sein.

===Tinc einschalten===
Wird der Node später doch an einem DSL-Anschluss betrieben, dann sollten folgende Befehle einmalig abgesetzt werden (Vorausgesetzt tinc wurde wie oben in der Anleitung beschrieben schon eingerichtet und die Schlüssel generiert).

/etc/init.d/tinc enable
/etc/init.d/tinc start

Schaut man dann mit "ps" nach, müsste der "tincd" Service wieder erscheinen.

Nicht vergessen den öffentlichen Schlüssel an unsere Gateway-Betreiber unter Angabe des NODENAME zu senden. Erst wenn der Schlüssel am Gateway eingetragen ist, funktioniert der VPN Tunnel über den DSL-Anschluss.

= Konfiguration testen =
Einen Überblick findet man unter [[Howto/Funktionstests | Funktionstests]].

=Router aufstellen=

Siehe dazu:
[[Datei:Wohin mit den Freifunk-Router.pdf|miniatur]]

Benutzer:Stefan

2014-09-08T20:59:06Z

Stefan: MAC-Adresse ergänzt

{{Node
|Adresse= 10.37.11.207
|Name= MZ-Lauterenstr [11.207]
|Standort= Mainz, Lauterenstraße 8
|Position= 49.99714, 8.27991
|Modell= TL-WDR3600 V1.5
|Gluon= nein
|Antenne= 2 ext. Rundstrahler (max 3dBi)
|VPN= ja
|MAC= 02:00:0a:25:0b:cf
|Dienste=
|Kommentar=
|}}

Benutzer:Stefan

2014-09-06T21:53:42Z

Stefan: IP-Adresse ausgesucht und hier Dokumentiert.