<google>OLSR</google>

= NEWS =

We have released our first set of improvements to the olsrd SPF calculation module.

== SPF implementation ==
When executing the [http://en.wikipedia.org/wiki/Dijkstra%27s_algorithm SPF calculation]
upon every iteration the least cost path needs to be extracted and put on the result list.
For that purpose olsrd-current does keep a linear list which has O(N) [http://en.wikipedia.org/wiki/Asymptotic_complexity asymptotic_complexity] to traverse.
Every node needs to be visited, which
has again O(N) [http://en.wikipedia.org/wiki/Asymptotic_complexity asymptotic_complexity]. This results in a total behavior of O(N^2) which can eat a lot
of CPU where N is large (for example when there are hundreds of olsrd nodes in a network).

== speed by efficient sorting ==
modern SPF implementations use data structures which are efficient at sorting the preliminary path costs like
[http://en.wikipedia.org/wiki/Min_heap min_heaps] or [http://en.wikipedia.org/wiki/AVL_tree AVL_trees]. Since olsrd already
had a nice and efficient AVL tree implementation, the two SPF related data structures (the candidate and path tree) are implemented using
AVL trees with the path etx metric as the key. Determining the minimal path cost in an AVL tree comes at a cost of O(log(N)) which results
in a total [http://en.wikipedia.org/wiki/Asymptotic_complexity asymptotic_complexity] of O(N * log(N)), which scales much nicer now in large networks.

== Results ==
In the [http://www.funkfeuer.at funkfeuer.at] network topology of 190 nodes the raw SPF execution was reduced by 45%. Note that the raw SPF execution represents only about 20% of the CPU cost in a running olsrd. At funkfeuer.at we have observed an overall decrease in the CPU load of about 12% on the embedded routers.

== Outlook ==
10-20% (depending on network size) in the route-handling module is admittedly not exciting. During refactoring the SPF implementation the olsrd-ng development team, has spotted further bottlenecks in the existing implementation. We are tackling this one by one, and would need active participation of the wireless communities to test our improvements and verify if we have added any undesired regressions. so stay tuned and report bugs to the [mailto:olsr-dev@lists.olsr.org olsrd-dev] mailing list.
<hr>
please check out the [http://tema.lo-res.org/~aaron/spf-refactoring.diff.gz patch]

= sponsor =

[[Bild:netideelogo.png|200px|supported by IPA]] made possible by a grant from [http://www.netidee.at IPA]. Thanks we really appreciate your help and your courage to support us!

= main links =

Main OLSR-NG project blog: http://olsr.funkfeuer.at

Slides from the OLSR-NG kickoff presentation: http://outpost.funkfeuer.at/~aaron/olsr-ng.pdf

We communicate on the olsr-dev mailinglist: https://www.olsr.org/mailman/listinfo/olsr-dev . All commit messages can be seen on the olsr-cvs list

= Goals =

# Clean up the code of OLSR (http://www.olsr.org),
# improve the algorithms of OLSR and make it more scalable.
# Furthermore, produce a new RFC for a (potential) new mesh routing protocol which is based on the experiences of OLSR coding (at the moment the most promising candidate for this RFC is [http://open-mesh.net/batman B.A.T.M.A.N])

OLSR-NG is a open source project. Meaning everybody is invited to join in and help.
We do have some bounties for the best solutions. If you want to participate, drop us an email: mailto:aaron@lo-res.org and mailto:bernd@firmix.at

One of the main goals is to make OLSR more scalable '''in practice'''.
[[Bild:O-Dijkstra.gif|350px|right|Complexity for n=1000 nodes of different data structures in the Dijkstra shortest path (SPF) algorithm. ]]

In the this picture you can see the different complexity graphs for the SPF under the assumption that every node has 10 edges . As you can see, the red line has O(n^2) complexity. This conforms to the current implementation of OLSR from www.olsr.org. OLSR-NG plans to reduce the complexity to the green or even the yellow level. This will allow the mesh network clouds to become larger by a factor ~ 1000 (on the routing layer / layer 3).

= Current Status =

* olsrd 0.5 was released! Thx everybody a lot!
* UML test server is being worked on. This will allow the B.A.T.M.A.N team to test their protocol and us to test our scalability ideas with 1000nd of olsr instances.
* Ongoing code cleanups
* AVL tree optimizations

== [http://www.user-mode-linux.org UML] test server ==

current load and statistics: http://texas.funkfeuer.at

[[Bild:Texas.funkfeuer.at.png|right|300px|our UML server]]

[[Bild:Topology-1-small.png|center|600px|topo map 1500 UML instances running in parallel. Note the packetloss!]]
(check out the [[TopologyPics archive]] also)

topo map 1500 UML instances running in parallel. Note the packetloss!

We have already been running 2000 instances and there was still plenty of RAM left. So 1000 is a very safe bet. However according to the UML docu we can probably safely assume that we can scale up miuch higher because UML will only take the RAM that each instance actually needs.
UML actually has other shortcomings: high CPU overhead, lots of context swiches. Trying to increase the performance at the moment...

=== current open todos UML server ===
Next important (*) things to do:
* DONE(aka) update texas's BIOS - FIXED
* add the packet loss tc rules (zethix already prepared it)
* create random netowkrs (easy)
* create network topologies based on a power law distribution ( a bit harder, but realistic for the internet)
* DONE(zethix) create scripts to find out which olsrd instances crashed
* create scripts to find out if a UML instance is not responsive anymore
* find better measurement tools . Look into sar
* DONE(aka) recompile host kernel and get rid of the "BUG: soft lockup detected on CPU#0!" messages
* DONE(aka) recompile host kernel and enable the preemtion patch
* DONE(zethix,aka) make hostfs so that developers can easily upload a new olsrd version to all uml instances. They should see the difference easily. Look into hostfs
* DONE(ake) increase performance of the UML simulator itself (decrease HZ, look into SKAS3 patch again, 32 bit recompile, talk with jeff etc)
* find more meaningful topology visualization tools (http://www.caida.org)
* add b.a.t.m.a.n to the root filesystem. (?)
* compare the scheduling / scalability of the test with [http://openvz.org/ OpenVZ] and [http://www.olsr.org/docs/README-Olsr-Switch.html olsr_switch]

=== User HOWTO ===

NOTE! You are root on the system. Effectively we need lots of sudo privs. So... use it wisely.

# log in
# make clean
# edit common.sh and adapt the parameters to your needs
#!/bin/sh
#
# VARS
#
MAX_INSTANCES=1500
ROOT_FS=root_fs
NICELVL="-n 5"
u=$USER
#SINGLE=1
We supply you with a good working root filesystem (root_fs) so no need to change that. The SINGLE parameter just says that you want to start a single instance and be logged in (needed for debugging purposes)
# the UML instance can read files and programs from
$HOME/public_uml/share
This is where you can put your programs or your version of olsrd (and its libs) or the B.A.T.M.A.N. binaries.

N.B. This directory is shared between all UML instances that you will
start in your simulation, so, they all have read-only access to it.
It will appear inside each UML as /mnt/share/. There is also another,
per-instance, read-write directory that you can use to save data for
later analysis (e.g. redirect olsrd stdout to a file and print some
debugging info there). This second directory will be under
$HOME/public_uml/exp/<UML IP> (where UML IP is the ip address of each
UML instance). It will also appear as /mnt/exp inside UML's environment.

# put your special rcS file into $HOME/public_uml/share/etc/init.d/ . This rcS file will be called from the UML instances /etc/init.d/rcS startup script. Starting olsrd etc must be done from this user supplied rcS. In case there is no user supplied rcS, then the standard olsrd with the standard settings of the root_fs (/etc/olsrd.conf) us started.

# make

This will start the simulation.

N.B. When the simulation is started, an olsrd instance is started on
the host as well. You can use it if you need to interact with the
olsrd network - for instance, topology maps are generated through this
instance (see below).

# Issuing commands inside UML manually - the 'make' command creates a screen session for every UML process it creates, and redirects its input and output there. You can use screen to attach to a particular session. Use
screen -ls (as root)
to list all available sessions, and
screen -S blabla.10.0.x.y -d -RR
to attach to a session. This will give you shell access to the system.

N.B. All modifications to the root filesystem will be preserved only
for the duration of the simulation! Once it is stopped, changes will
be lost!

# observe the success on http://texas.funkfeuer.at or create a new topo map via ( cd /var/www/topo; ./doit.sh ). If you see a [http://en.wikipedia.org/wiki/Complete_graph complete graph], then your version has little packetloss!

# stop it via
make clean
or
make stop

Please make sure (by looking at http://texas.funkfeuer.at) if you are the only person running a simulation at the moment!

'''Some things to note'''

* the topology visualisation scripts run with nice level +5
the UML instances with nicelevel +10 (see run.sh)
-> Never ever go higher than nicelevel 0 because then you will disturb the system monitoring (munin) tools and we will not be able to see what the seimulation is doing.
*

=== Open questions/bug reports? ===

= Who wants to contribute? =

{| width="80%" class="events" cellpadding="5" cellspacing="0" border="1"
!align="left" | Who is willing to work on something
!align="left" | Contact info
|-
| Aaron Kaplan
| mailto:aaron@lo-res.org
|-
| Roman Steiner
| mailto:roman.steiner@gmx.at
|-
| Bernd Petrovitsch
| mailto:bernd@firmix.at
|-
| Andrej Rursev (zethix)
| mailto:zethix@gmail.com
|-
| Hannes Gredler
| mailto:hannes@gredler.at
|}

= Who is working on what? =

{| width="80%" class="events" cellpadding="5" cellspacing="0" border="1"
!align="left" | Who
!align="left" | What
!align="left" | Status
|- class="oeffentlich"
| Bernd Petrovitsch, Thomas Lopatic, Hannes Gredler
| release 0.5
| DONE
|-
| ???
| release 0.5 make packages for freifunk FW, DD-WRT, etc, windows (XP, Vista), ... and test them
| OPEN
|-
| ???
| analyze IP autoconfig mechanisms and find the best one
| OPEN
|-
| Hannes Gredler
| tcpdump parses olsr packets,
| DONE
|-
| Hannes Gredler
| SPF improvments
| DONE
|-
| Hannes Gredler
| reduce malloc thrashing during SPF computation
| not yet started
|-
| Hannes Gredler
| improve post-SPF handling (route table conciliation)
| DONE
|-
| Hannes Gredler
| spurious neighbor loss on nodes with high neighbor count
| OPEN/investigating
|-
| Aaron Kaplan,Bernd Petrovitsch
| olsr-ng test server
| DONE
|-
| Aaron Kaplan
| theory, complexity analysis. Goal: find the best complexity on the algorithmic side.
| DONE
|-
| Zethix, Aaron Kaplan
| UML cluster setup
| WIP, currently we can start around 2000 UML instances. But the uml_switch software still drops packets between virtual interfaces. http://www.openvz.org seems also like a promising solution
|}

<mm>[[olsr-ng.mm|flash]]</mm>

contact mailto:aaron@lo-res.org or Bernd if you are interested in participating!

= Next Steps =

* TU Wien lecture [http://tuwis.tuwien.ac.at/lva/tuwien/384090 "Verteilte systeme"], 20.4.2007 will present our ideas about optimizing complexity. Aaron also wants to adress more students from the TU to participate. DONE. Let's see if new participants want to join.
* finalize the UML test server
* try out the optimization ideas and document the speedup
* more cleanups
** olsrd is doing '''lots of''' <tt>malloc()</tt>s and <tt>free()</tt>s - use </tt>ltrace</tt> to see this.
*** review <tt>malloc()</tt>/<tt>free()</tt> if it theys are superflous and can be implemented with buffers on the stack or just moving pointers around
*** are there very frequently <tt>malloc()</tt>ed and </tt>free()<tt>d ''struct''? Perhaps a free list can help to avoid lots of <tt>malloc()</tt>/<tt>free()</tt> handling
** we have several coding styles in there
** add wrappers to hide type casts for Windows (and perhaps others). Reserve some prefix (e.g. ''x'' is used for this often as in <tt>xmalloc()</tt>, ''olsr_'' is IMHO quite long)
** fixup error reporting/logging
** add synchronization and make the daemon multi-threading (e.g. the httpinfo plugin could benefit from such a thing)
** make the parameter parsing of the plugins more consistent (some are case-sensitive, some are not, most do not check syntax errors)
** merge quagga-svn and svan-ola quagga-patch and test it
** ....

= Bounties =

please take a look at the slides and get in contact with us directly at the moment!

= Source code =
* CVS repos:
(as user "ipo23" )
export CVS_RSH=ssh
cvs -z3 -d:ext:ipo23@olsrd.cvs.sourceforge.net:/cvsroot/olsrd co -P olsrd-current
as anonymous user)
cvs -d:pserver:anonymous@olsrd.cvs.sourceforge.net:/cvsroot/olsrd login
cvs -z3 -d:pserver:anonymous@olsrd.cvs.sourceforge.net:/cvsroot/olsrd co -P olsrd-current

= Theory section =

== data structures ==
* [[Wikipedia:Heap (data_structure)|Heap]] ... We need good heaps/priority queues for A*-Search / Dijkstra
* especially the [[Wikipedia:Fibonacci_heap|Fibonacci Heap]] has a to my knowledge the very best asymptotic complexity of O(1) almost everywhere.
Currently as of 0.51pre we use a AVL tree which has complexity O(log(n)).

The following complexities<ref>
Thomas H. Cormen, Charles E. Leiserson, Ronald L. Rivest (1990): Introduction to algorithms.
MIT Press / McGraw-Hill.
</ref> are worst-case for binary and binomial heaps and [[Wikipedia:Amortized analysis|amortized complexity]] for Fibonacci heap. O(f) gives asymptotic upper bound and Θ(f) is asymptotically tight bound (see [[Wikipedia:Big O notation]]). Function names assume a min-heap.

{| class="toccolours" border="1" cellpadding="4" style="border-collapse:collapse"
|- style="background-color:#e9e9e9" |
! Operation
! [[Wikipedia:Binary heap|Binary]]
! [[Wikipedia:Binomial heap|Binomial]]
! [[Wikipedia:Fibonacci heap|Fibonacci]]
|-
| createHeap
|| Θ(1)
|| Θ(1)
|| Θ(1)
|-
| findMin
|| Θ(1)
|| O(lg ''n'') or Θ(1)
|| Θ(1)
|-
| deleteMin
|| Θ(lg ''n'')
|| Θ(lg ''n'')
|| O(lg ''n'')
|-
| insert
|| Θ(lg ''n'')
|| O(lg ''n'')
|| Θ(1)
|-
| decreaseKey
|| Θ(lg ''n'')
|| Θ(lg ''n'')
|| Θ(1)
|-
| merge
|| Θ(''n'')
|| O(lg ''n'')
|| Θ(1)
|}

== other interesting data structures not directly related ==
* [[Wikipedia:Data_Structures]] general overview. Good entry point for trees: [[Wikipedia:Binary_tree]]
* [http://www.nist.gov/dads/ NIST Directory of Data Structures] has a very extensive overview
* [http://www.google.com/search?client=safari&rls=en&q=Optimal+Worst-Case+Operations+for+Implicit+Cache-Oblivious+Search+Trees&ie=UTF-8&oe=UTF-8 succinct datastructures (trees)]
* [http://blogs.msdn.com/devdev/archive/2005/12/05/500171.aspx succinct datastructures overview]
* [http://en.wikipedia.org/wiki/Trie Tries]
* [http://www-users.cs.umn.edu/~saad/PS/iter1.pdf sparse matrices]
* look at [http://users.footprints.net/~kaz/kazlib.html kazlib] from IS-IS ??

==See also==
*[[Wikibooks:Data Structures/Min and Max Heaps|Heaps at wikibooks]]

==Notes==
<references/>

= Links =
== Papers, Theory ==
* [http://ietfreport.isoc.org/idref/rfc3626/ RFC-3626]: the "OLSR RFC"
* [http://www.lix.polytechnique.fr/hipercom/index.php?option=com_content&task=view&id=152&Itemid=1 Workshop at Hipercom Oct 2006]
* [http://www.lix.polytechnique.fr/hipercom/index.php?option=com_content&task=view&id=60&Itemid=50 OLSR-v2 Draft 01 at hipercom]
** http://www.ietf.org/internet-drafts/draft-ietf-manet-olsrv2-02.txt
** http://www.ietf.org/internet-drafts/draft-ietf-manet-packetbb-02.txt
** http://olsrv2.online.fr/blog/ OLSRv2 Development Blog
* http://www.adhocsys.org/
AdHocSys is a two-year European project to provide reliable broadband services in rural and mountain regions. This objective
will be achieved by means of the creation of a wireless ad hoc broadband network, with special enhancements to reliability
and availability. The network consists of one or several gateways connecting to the global Internet and several intermediate
nodes which provide multihop connections between the gateways and end users.
* [http://folk.uio.no/kenneho/index.php?page=studies&subpage=wospf WOSPF-OR] Uni Oslo Wireless OSPF with Overlapping Relays
* [http://hipserver.mct.phantomworks.org/ietf/ospf/ W-OSPF] INRA/Boing Wireless OSPF

== misc ==
* Homepage: http://www.olsr.org/
* NATO C3 Agency (NC3A) Radio Protocols Lab https://elayne.nc3a.nato.int/
* commercial INRIA HIPERCOM spin-off http://www.luceor.com/
* commercial MIT Roofnet spin-off http://www.meraki.net/

OLSR-NG

2007-06-23T19:39:14Z

Bernd: /* Next Steps */

OLSR-NG

2007-06-23T19:34:49Z

Bernd: /* Next Steps */

OLSR-NG

2007-06-23T19:34:13Z

Bernd: /* Who wants to contribute? */

2006-10-11T21:20:54Z

Bernd:

{{olsrd_Navigation}}

== olsrd ==

=== Papers, Theorie ===
* [http://ietfreport.isoc.org/idref/rfc3626/ RFC-3626]
* [http://www.lix.polytechnique.fr/hipercom/index.php?option=com_content&task=view&id=152&Itemid=1 Workshop at Hipercom Oct 2006]
* [http://www.lix.polytechnique.fr/hipercom/index.php?option=com_content&task=view&id=60&Itemid=50 OLSR-v2 Draft 01 at hipercom]
* http://www.adhocsys.org/
--[[Benutzer:Bernd|Bernd]] 23:20, 11. Okt 2006 (CEST)
AdHocSys is a two-year European project to provide reliable broadband services in rural and mountain regions. This objective will be achieved by means of the creation of a wireless ad hoc broadband network, with special enhancements to reliability and availability. The network consists of one or several gateways connecting to the global Internet and several intermediate nodes which provide multihop connections between the gateways and end users.
--[[Benutzer:Bernd|Bernd]] 23:20, 11. Okt 2006 (CEST)

=== Sonstiges===
* Homepage: http://www.olsr.org/

Olsrd

2006-10-09T09:06:38Z

Bernd:

Olsrd

2006-10-09T09:06:05Z

Bernd:

Olsrd

2006-10-09T09:02:57Z

Bernd:

2006-09-06T21:53:34Z

Bernd: /* FAQs */

Wie setz' ich eine Tunnel auf?

== Grundlegendes ==

* Wozu ein Tunnel?
** Primär um anders nicht erreichbare Teile des Netzes über das Internet anzubinden, z.B. funkmäßig nicht erreichbare Inseln.
** Aber auch um redundante Verbindungen zu schaffen.

* Was wird eingesetzt?
** [http://www.openvpn.net/ OpenVPN] ist die Implementierung der Wahl. Es kann alles, was man brauchen kann, ist leidlich einfach aufgesetzt und es existieren Implementierungen für alle relevante Betriebssysteme.
** Als Routing-Deamon wird [http://www.olsr.org/ olsrd] eingesetzt. Das hat mit [http://www.openvpn.net/ OpenVPN] nur insoweit etwas zu tun, als daß wir "tap" Interfaces verwenden (müssen), damit der [http://www.olsr.org/ olsrd] drüber broadcasten kann.

* Wie funktioniert das?
** Ein Tunnelendpunkt ist konkret am <code>sandwich.funkfeuer.at</code> (genauer: 193.239.188.20), der andere auf einem beliebigen lokalen Host. Die einzige Voraussetzung ist eine "normale" Internet-Verbindung vom Host zu <code>sandwich.funkfeuer.at</code> (bzw. eigentlich 193.239.188.20). Dabei sind ppp, Masquerading/NAT und ähnliche Besonderheiten kein Problem oder besondere Einschränkung.

* Sonstiges
** Der Tunnel ist ein unverschlüsselter IP-Tunnel, d.h. man kann drüber alles mitsniffen. Das liegt daran, daß
*** am <code>sandwich.funkfeuer.at</code> nicht genug Rechenpower für viele bis alle verschlüsselte Tunnels zur Verfügung steht und
*** auf einem typischen LinkSys nicht genug Rechenpower für einen verschlüsselten Tunnel zur Verfügung steht (wenn man auf nennenswerte Bandbreite nicht verzichten will) und
*** ein verschlüsselter Tunnel ein falsches Gefühl der Sicherheit erzeugen könnte: Der Tunnel terminiert am anderen Tunnelendpunkt und nicht erst am Zielserver, zu dem man eigentlich will. D.h. man muß sowieso zusätzlich sichere/verschlüsselte Protokolle verwenden oder einen sicheren IP-Tunnel vom eigenen Desktop bis zum Zielserver legen. Für beides bringt ein weiterer "teilweiser" Tunnel drunter nur mehr Latenz (jedes Paket will einmal zusätzlich verschlüsselt und entschlüsselt werden) und verbrauchte CPU-Leistung, aber ansonsten (insbesondere Security-mäßig) gar nichts.

== Installation ==

* Auf beiden Enden des Tunnels muß [http://www.openvpn.net/ OpenVPN] installiert sein. Am <code>sandwich.funkfeuer.at</code> ist das trivialerweise längst der Fall, am lokalen Host (egal welcher Bauart) muß das der Node-Owner sicherstellen.

* Am [http://outpost.funkfeuer.at/frontend/ Frontend] legt man sich einen "Tunnel" an. Dem werden 2 Geräte-IP-Adressen zugeteilt - eine für jede Seite. Analog zu den Richtantennen kann man die auch zweckmäßig-nett benennen, also z.B. <code>sandwichtodig8</code> und <code>dig8tosandwich</code> und kann auch gleich jede Seite eindeutig adressieren.

* Wir verwenden ''tap'' Devices von [http://www.openvpn.org/ OpenVPN]. Diese tunneln am Layer 2 (d.h. a la Ethernet) und sind daher broadcast-fähig. Außerdem sollte der Tunnel UDP benutzen (und v.a. nicht TCP), da wir auch TCP-Connections drüber haben, die ja automatisch neu zu senden versuchen, wenn es gerade nicht geht. Wenn jetzt die normale Internetverbindung zusammenbricht, versuchen permanent 2 Schichten an TCP-Verbindungen durch Retries etwas zu erreichen und es schaukelt sich auf (d.h. es bringt nichts und erzeugt nur noch mehr sinnlosen Traffic).

=== Netz-seitig ===
* Am <code>sandwich.funkfeuer.at</code> muß jemand mit dortigen "root"-Rechten den Tunnelendpunkt (und [http://www.olsr.org/ olsrd]) konfigurieren. Diese Leute erreicht man besten über die Mailingliste [https://lists.funkfeuer.at/mailman/listinfo/discuss/ discuss@lists.funkfeuer.at].
** Dabei gibst du eine der erhaltenden IP-Adressen (<code>sandwichtodig8</code> wäre das im obigen Beispiel) bekannt, damit sie am <code>sandwich.funkfuer.at</code> am Tunnelendpunkt konfiguriert werden kann.
** Du bekommst dabei die zu verwendende Portnummer mitgeteilt. Nachdem am <code>sandwich.funkfeuer.at</code> einige Tunnelendpoints sind, kann man nicht einfach irgendwas verwenden. Außerdem sind die verwendeten Portnummern alle in einer geschlossenen Range - das erleichtert die Verwaltung. Im Prinzip kann man am Node eine beliebige andere Portnummer verwenden, aber dem Autor fällt kein besonderer Grund, warum man dieses tun wollte.
** Dann ist die eine Tunnelseite soweit fertig.

=== Node-seitig ===

Am lokalen Host muß man jetzt [http://www.openvpn.org/ OpenVPN] starten sowie die geeigneten Routing-Rahmenbedingungen schaffen. Bei allen Varianten braucht man folgendes:

* Der [http://www.openvpn.net/ OpenVPN] Tunnel geht direkt zum ''sandwich.funkfeuer.at'' über die normale (bzw. sonstige) Internet-Verbindung. Um diese Verbindung durch spätere Routen nicht zu gefährden, setzen wir eine explizite Hostroute:

/sbin/ip route add 193.239.188.20 via 1.2.3.4 dev eth0

''193.239.188.20'' ist die IP-Adresse, über die netz-seitig die [http://www.openvpn.net/ OpenVPN] Deamons arbeiten. Die IP-Adresse ist '''nicht''' aus dem eigentlichen 0xFF-Netz, weil es sonst Routingprobleme gibt. <code>eth0</code> ist dabei das Netzwerk-Device, über das die Default-Route geht und ''1.2.3.4'' ist das normale Default Gateway/Next Hop. Die Default-Route(n) kann man mit <code>/sbin/ip route show | fgrep default</code> sehen. Normalerweise sieht man genau eine, wenn der [http://www.olsr.org/ olsrd] bereits läuft, sieht man mehrere.

Insbesondere darf es keine explizite Hostroute (nur eine automatische über den [http://www.olsr.org/ olsrd]) zu ''193.238.156.2'' (''sandwich.funkfeuer.at'') oder ''193.238.157.5'' (''tema.lo-res.org'') geben: Auf dem Server läuft auch ein Nameserver, den aus dem 0xFF-Netz jeder benutzen kann (und soll) und dazu muß der Request über den Tunnel kommen - der Nameserver verweigert [http://www.zytrax.com/books/dns/ch2/index.html#recursive rekursive Anfragen] (wie sie normale Resolver machen) aus dem (restlichen) Internet.

==== Low-Level/Barebones/Step-by-step/The old Method ====

ist auf [[Alte Konfigurationsmethode]] zu finden.

Der Autor dieser Seite findet sie mühsamer und fehlerträchtiger wie die folgenden Konfigurationsfilemethode.

==== Mit einem [http://www.openvpn.org/ OpenVPN] Konfigurationsfile ====
Obige Schritte kann [http://www.openvpn.org/ OpenVPN] auch alle selber machen. Entweder man spezifiert eine lange Liste korrekter Optionen oder man packt die Optionen in ein Konfigurationsfile unter <code>/etc/openvpn</code>, wo es die meisten Linuxdistributionen auch finden werden.
Am sandwich.funkfeuer.at heißen die per Konvention <code>tap<n>-<node>.conf</code>. <code>.conf</code> am Ende brauchen die Startup-Scripts und mit den Namen davor finden sich die Admins leichter zurecht. Das Node-seitige Konfigurationsfiles des Autors dieser Seite enthält folgende Zeilen:

#
# dig8 tunnel
#
# '#' or ';' may be used to delimit comments.
#
dev tap0
proto udp
remote 193.239.188.20
port 5011
ifconfig 193.238.156.57 255.255.252.0
route-up /etc/openvpn/kill-route.sh
daemon
#secret /etc/openvpn/dig8-priv.secret
#auth sha1
#cipher none

Die meisten erklären sich von selbst bzw. haben dieselbe Bedeutung wie die Optionen weiter oben. Die letzten 3 Zeilen sind der 1. Schritt zu autentifizierten (aber nicht verschlüsselten) Verbindungen, damit nicht irgendwer den eigenen Tunnel "übernehmen" kann.
Um es an die eigenen Bedürfnisse anzupassen, muß man nur den Devicenamen, die Portnummer und IP-Adressen geeignet anpassen.

Das Script <code>kill-route.sh</code> schaut folgendermaßen aus:

#!/bin/sh
#
# Kill the useless openvpn route
#
/sbin/ip route del "193.238.156.0/22" dev "$dev"

==== Authentifizierte Tunnels ====
Obig konfigurierte Tunnels verlassen sich auf die Korrektheit der beteiligten IP-Addressen. Sollte jemand ein passende IP-Adresse konfigurieren und der eigene Tunnel deaktiviert sein, könnte dieser jemand den Tunnel "übernehmen", indem er die passende Konfiguration einstellt.

Das läßt sich durch (kryptographisch sichere) einfache Authentifizierung mittels eines "Shared Secrets" verhindern.

* Zuerst stellt man den eigenen Tunnel auf obige "Konfigurationsfilevariante" um.

* Dann generieren wir (d.h. eigentlich nur der Nodeowner) einen Shared Key mit

openvpn --genkey --secret /etc/openvpn/tap0-dig8.secret

Der Filename sollte dabei einen passenderen Namen wie oben bekommen (so heißt das File am dig8 Knoten).

* Dann schickt der Nodeowner eine Email mit passendem Text und dem erzeugten File als Attachment an [mailto:bernd@firmix.at bernd@firmix.at].

* Das Problem bei der Installation ist, daß man das auf beiden Seiten zugleich aktivieren muß, weil sonst die jeweils nicht-authentifizierte Seite nicht mehr verbinden kann/darf. D.h. es wird ausgemacht, wann das passiert und [mailto:bernd@firmix.at bernd@firmix.at] stellt das server-seitig um (indem er obige 3 Zeilen am Ende des .conf Files auskommentiert). Gleichzeitig muß auch auf der Node-seite die entsprechenden Zeilen eingefügt werden.

Der Verkehr selber ist unverschlüsselt - eben aus den viel weiter oben angeführten Gründen. Und das ganze basiert natürlich darauf, daß [mailto:bernd@firmix.at bernd@firmix.at] sowie alle andere "root"s am <code>sandwich.funkfeuer.at</code> auch vertrauenswürdig sind.

==== Abschluß ====
* Als letzten Schritt brauchen wir noch einen laufenden [http://www.olsr.org/ olsrd], der die Routen alle richtig verwaltet.
siehe [http:... leider ein b0rken link]

== FAQs ==

* Frage:
Ich benutze die FreifunkFirmware ab 1.23 und bekomme
<blockquote><tt>
The ifconfig command is replaced with the ip command. 
For link layer settings refer to "ip link help"; For 
ip adress settings refer to "ip addr help". Examples: 
ip link set dev tap0 up 
ip link set dev tap0 down 
ip link set dev tap0 mtu 1500 
ip link set dev tap0 address 00:01:02:03:04:05
</tt></blockquote>
* Antwort:
Ab der Version 1.23 von Freifunk fehlt ifconfig, route usw, da
sie Speicherplatz sparen wollten. Ich habe das schlicht und einfach nicht
bemerkt, da ich ja jedesmal eine Rückmeldung erhalten habe wenn ich ifconfig
eingegeben habe.

Mit
<tt>ipkg install freifunk-openwrt-compat</tt>
können die nachinstalliert werden.

* Frage:
Ich habe durch meinen normalen Internetanschluß bereits ein Default-Route. Muß ich die löschen, wenn ich einen Funkfeuer-openvpn-Tunnel habe?
* Antwort:
Nein. Am entsprechenden Host des Autors sieht das so aus:
<blockquote><tt>
1#/sbin/ip route show | egrep -w '^default' 
default via 62.178.36.1 dev eth1 
default via 193.238.156.50 dev tap0 metric 1
</tt></blockquote>
Damit sind 2 Default-Routen mit verschiedenen "Metriken" vorhanden ("metric 1" und die nicht angezeigte "metric 0"). De facto wird die Route mit der Metrik 1 nie verwendet, weil die Hostrouten durch die schmälerer Netzmaske präferiert und die "normale" Default-Route durch die kleinere Metrik bevorzugt werden. Nur wenn es keine Hostroute zu einem Funkfeuer-Host gibt, wird der Weg über das Internet (ohne Tunnel) gewählt. Das sollte zum einen sowieso nicht sein und zum anderen sollte es nach Meinung des Autors (nachdem er es nicht ausprobiert hat) nicht signifikant schaden.

* Frage:
Kann ich dann alles machen?
* Antwort:
Node-seitig geht alles. Das einzige im Moment noch ungelöste Problem ist: Wenn man von außerhalb des 0xFF-Netzes eine 0xFF-IP-Adresse am Node erreichen will, kommen die IP-Pakete zwar an und die Antwortpakete zurück, aber die werden verworfen, weil - durch das Masquerading über die Default-Route - die Source-IP-Adresse verändert wird. Und damit verweigert der sendende Host die Annahme der Pakete.

Die Lösung ist: Man verwendet mehrere Routing-Tabellen, um auf Grund der Source-Adresse die Antwortpakete über den Tunnel zu Routen. Das kann der <code>olsrd</code> im Moment nicht.