Installation

Hinweis

Dieser Artikel beschriebt die Installation der auf fastd-Basierten Firmware. Wichtiger Unterschiede zu Release-Builds:

• In der Beta-Firmware können Bugs auftreten, die nur über SSH oder den OpenWRT failsave-mode behoben werden können.
• Updates sind "Handarbeit" - es kann während der Entwicklung Änderungen geben, die nicht durch das Einspielen neuer Firmware-Images übernommen werden können.

Installation

Abbildung 1.

1. Lade die letzt Beta herunter (http://jenkins.kbu.freifunk.net/files/beta)
2. Lan-Port des Routers mit PC verbinden - alle anderen Verbindungen trennen.
3. Adresse http://192.168.1.1 im Webbowser aufrufen - Benutzer ist admin, dass Kennwort ist ebenfalls admin (falls nicht zuvor geändert)
4. Den Menüpunkt System Tools auf der linken Seite auswählen - danach Firmware-Upgrade anklicken.
5. Die Freifunk-Firmware zum Hochladen auswählen (siehe Abbildung 1) und danach "Upgrade" anclicken.
6. Das Flashing dauert ca 5 Minuten. Schalte den Router nicht aus. Der Prozess ist abgeschlossen, wenn der Router neu startet und anschliessend die Sys-Lampe dauerhaft leuchtet.

Der Router versucht nun am WAN-Port per DHCP eine IP Adresse zu beziehen und erzeugt automatisch ein "kbu.freifunk.net" WLAN-Netwerk.
Eine weitere Konfiguration ist nicht nötig, kann aber über den config-mode vorgenommen werden. Dieser wird erreicht indem die QSS-Taste mindestens 3 Sekunden gedrückt wird (oder bis die LEDs einmal gemeinsam aufleuchten).

Wichtige Änderungen im Vergleich zu vorher

1. Es wird der config-Modus verwendet. Abweichend zur Doku ist er anfangs nicht aktiv (zeroconf-Ansatz.)Doku siehe: http://freifunk.in-kiel.de/wiki/Firmware#Konfigurations-Modus
2. Durch Änderungen in batman-adv können neue und alte Router keine gemeinsame Mesh-Wolke aufbauen.

Known Issues / Workrounds

Aktuell sind keine Probleme mit der Beta-Firmware bekannt.

Image auf Vollständigkeit und Integrität prüfen

Wir empfehlen bei jedem Download eines Firmware Images, die Vollständigkeit des Downloads und die Integrität des Images zu überprüfen.

Download

Zunächst lädst du dir das Firmware Image, die Checksummen und die Signatur der Checksummen herunter:

wget http://jenkins.kbu.freifunk.net/files/beta/ff-kbu-1beta5/SHA256SUMS
wget http://jenkins.kbu.freifunk.net/files/beta/ff-kbu-1beta5/SHA256SUMS.sign
wget http://jenkins.kbu.freifunk.net/files/beta/ff-kbu-1beta5/openwrt-ar71xx-generic-tl-wr741nd-v1-squashfs-factory.bin

Achte darauf, dass sich alle Dateien im gleichen Verzeichnis befinden.

Anschließend importierst du dir den Freifunk-KBU Release Signing Key in deinen gpg-Keystore:

gpg --keyserver pgpkeys.mit.edu --recv-key FA27C6E4

(Fingerabdruck: E3B3 AF2B 6B54 149B 9313 4EC0 E782 EAC7 FA27 C6E4)

Checksumme und Integrität prüfen

Beginnen solltest du mit dem Prüfen der Signatur:

gpg -u FA27C6E4 --verify SHA256SUMS.sign SHA256SUMS

Wenn alles gut aussieht dann kannst du prüfen, ob du das Firmware Image auch komplett heruntergeladen hast:

sha256sum -c SHA256SUMS

Beispiel Ausgaben

Wenn alles in Ordnung ist, sieht der Aufruf der einzelnen Schritte ungefähr so aus:

$ ls 
openwrt-ar71xx-generic-tl-wr741nd-v1-squashfs-factory.bin  SHA256SUMS  SHA256SUMS.sign

$ gpg --keyserver pgpkeys.mit.edu --recv-key FA27C6E4
gpg: requesting key FA27C6E4 from hkp server pgpkeys.mit.edu
gpg: key FA27C6E4: public key "Freifunk-KBU Release Signing Key (Used by jenkins.kbu.freifunk.net) <info@kbu.freifunk.net>" imported
gpg: public key A4F00ECF is 3346 seconds newer than the signature
gpg: 3 marginal(s) needed, 1 complete(s) needed, PGP trust model
gpg: depth: 0  valid:   2  signed:  10  trust: 0-, 0q, 0n, 0m, 0f, 2u
gpg: depth: 1  valid:  10  signed:   0  trust: 2-, 2q, 0n, 1m, 5f, 0u
gpg: next trustdb check due at 2013-02-14
gpg: Total number processed: 1
gpg:               imported: 1  (RSA: 1)

$ gpg -u FA27C6E4 --verify SHA256SUMS.sign SHA256SUMS
gpg: Signature made Tue 08 Jan 2013 01:02:14 CET using RSA key ID FA27C6E4
gpg: Good signature from "Freifunk-KBU Release Signing Key (Used by jenkins.kbu.freifunk.net) <info@kbu.freifunk.net>"

$ sha256sum -c SHA256SUMS
openwrt-ar71xx-generic-tl-wr741nd-v1-squashfs-factory.bin: OK

Optionale Erweiterungen

Statistiken

Es besteht die Möglichkeit, dass wir statistische Daten deines Nodes zentral von deinem Node geschickt bekommen und dann graphisch darstellen. Damit wir die Daten von deinem Node erhalten können benötigst du ssh Zugriff auf deinen Node, sowie die Pakete collectd, collectd-mod-interface und collectd-mod-network.

• Installation der Pakete:

 root@node # opkg update
 root@node # opkg install collectd collectd-mod-interface collectd-mod-network

• Kopiere folgende Datei nach /tmp/collectd.conf.sh und führe sie mit sh /tmp/collectd.conf.sh aus:

#!/bin/sh

ipv6_linklocal=`ifconfig br-freifunk | grep -oe 'fe80:[a-f0-9:]*'` 

cat > /etc/collectd <<EOF
Hostname   "$ipv6_linklocal"
BaseDir     "/var/lib/collectd"
PIDFile     "/var/run/collectd.pid"
Interval    120
ReadThreads 2

LoadPlugin network
LoadPlugin interface

<Plugin interface>
        Interface "br-freifunk"
        Interface "br-wan"
        IgnoreSelected false
</Plugin>

<Plugin network>
        Server "collectd.kbu.freifunk.net" "25827"
</Plugin>
EOF
  

 Anschließend starte deinen Node neu.