HOWTO

How to use Ana4:

  • Download the source tarball from the sourceforge ananas page:

http://prdownloads.sourceforge.net/ananas/Ananas-v1.0-beta2.tgz?download

  • Extract it

tar xvfz Ananas-v1.0-beta2.tgz

  • A directory named Ananas containing the sources is created

From this point, you have to be root on your system.

Compile Ana4 module and tools

  • Go into the Linux directory

cd Ananas/Linux

  • Launch the configure script

./configure

  • You have to answer several questions
    • Enter the source location directory (usually in /usr/src/linux-2.X.X or /lib/modules/2.X.X/build)
    • Give the prefix to install tools and documentation (by default, man pages will installed in /usr/share/man/man8, tools in /sbin)
    • Say whether you want to compile the vizualisation tool (you can compile it afterwards going to Ananas/Linux/utils and typing "make x")
  • Compile the sources

make all

  • Install the module and utilities

make install

Insert the kernel module

  • Insert the module into the kernel

modprobe ananas

  • A new interface adh0 should be visible

ifconfig -a

IP configure your Ana4 interface (adh0)

  • Bind the physical interfaces you want to use below ananas:

adhconfig add <ifname>

  • Repeat this command for each interface.
  • Configure the IP address of the adh interface (ifconfig adh0 <IP>) or use a DHCP client (e.g. dhclient adh0) on your adh interface if a DHCP server is available in the Ana4 network.
  • The Ana4 interface is now up and reachable.

Launch the routing daemon

  • If you wish to use a routing daemon on your network (in this case, unicast routes will be used instead of network broadcast), launch the routing daemon for the concerned Ana4 interface

"nrlolsrd [-lq] -i adh0"

  • The -lq switch activates the link quality routing capability.

Launch the vizualisation agent

  • If you wish to use the network vizualisation tool, the routing daemon (nrlosrd) and the vizualisation agent (olsragent) should be running on each node of the network
  • Launch the vizualisation agent (olsragent)

Use of the vizualisation tool

  • In order to build this tool, you must have gtk+-2.0 and glib development packages installed
  • Go to the Ananas/Linux/utils directory

cd Ananas/Linux/utils

  • Compile the vizualisation tool

make x

  • The vizualisation tool can be launched

./xolsrclient

Duplication of Ana4 interface

  • It is is possible to declare several Ana4 interface on the same host. The new Ana4 interfaces are named adhX, where X is the number of the interface.
  • To declare a new interface, type

adhconfig dup <NetId>

  • NetId is the Ana4 subnet Id attributed to your new interface.
  • This interface can only communicate with interfaces declared with the same Ana4 subnet Id.
  • NetId is independant from the interface number.
  • A new Ana4 interface is now available.
  • To IP configure it, or launch a routing daemon above it, follow the same steps as described above, replacing "adh0" by "adhX"