Penguin
Note: You are viewing an old revision of this page. View the current version.

This describes how to set up the "HEAD" branch of the Etud/wand code. This code may break at any time, so be warned.

Follow the instructions in MetaNet on getting an IP range. Use the following instructions for compiling and setting up Etud and wand, and use the instructions in MetaNet related to zebra and ospfd, and DNS and other issues.

Repeat: this document only describes how to set up the "HEAD" branch of the Etud/wand code. Its not a complete HOWTO for connecting to the MetaNet.

To check out the codebase
cvs -d:pserver:anonymous@cvs.wand.sourceforge.net:/cvsroot/wand login

when prompted for a password press enter.

Now type

cvs -z3 -d:pserver:anonymous@cvs.wand.sourceforge.net:/cvsroot/wand co -r HEAD wand

cd wand make make install

Yeah, it is that easy. This should have compiled cleanly. If it hasn't, ask on the meta-admin mailing list, or find someone who knows about this on IRC to ask about why its not working. It's probably a broken CVS commit, so it should be fixed fairly quickly.

check the config files - they are placed in /usr/local/etc by default.

/usr/local/etc/etud.conf:

daemonise true module "/usr/local/lib/wand/drivers/tuntap.so" macaddr "00:01:02:03:04:05" udpport 22222

the macaddr is IMPORTANT. Make sure you pick one that you know wont conflict with anything else on the metanet. We typically use the MAC of an ethernet card on the machine we run Etud on - eg, eth0. udpport is probably not needed any more, but keep it there. The only other driver you can use is 'ethertap.so' instead of 'tuntap.so' but I recommend using tuntap.so.

/usr/local/etc/wand.conf

udpport 44444 server "some.server.name"

udpport isn't needed - it defaults to 44444 anyway. you need to get the right server entry in there - get hold of one of the metanet admins for that.

Notes:

Again, you need a 2.4.x series kernel. We've not tried it under 2.5.x, and we know if wont work under 2.2.

Having netlink_dev and ethertap compiled (modules) into your kernel is still perhaps a good thing to do, however you really want to use the new TUN/TAP support CONFIG_TUN is the option to look for. Again, modules are good.

You might still need /sbin/ip (see iproute(8)??), this usually comes in a package called iproute (eg Debian) or iproute2 depending on your distribution.

The CVS tree contains some debian-style init scripts that will start things up nicely. They are placed in misc/debian/etc/init.d/ . If you are running debian, feel free to copy these to /etc/init.d and use update-rc.d to get debian to run them on startup. I put Etud at level 19, and wand at level 20. These scripts rely on having an entry in /etc/network/interfaces for your Etud device - typically wan0

noauto wan0 iface wan0 inet static

address <your 192.168 ip address> netmask 255.255.0.0 network 192.168.0.0 broadcast 192.168.255.255

The init scripts then call 'ifup wan0'

Alternatively, you can ignore the init scripts and run Etud/wand simply, assuming you have good config files as mentioned earlier, by doing
/usr/local/sbin/Etud ifconfig wan0 <192.168 ip address> netmask 255.255.0.0 broadcast 192.168.255.255 mtu 1280 /usr/local/sbin/wand

NOTE: the mtu is IMPORTANT if you want zebra/ospfd to work.