Please ensure you've read the MetaNet page and understand what exactly you're doing before you follow these instructions.
Currently, we are up to WanDaemon version REL2 (release two) -- you might want to check with someone to see if we've released a more recent version. If you want cutting edge, the head of the CVS tree might suit your needs - see WanDaemonHeadHowto for information on how to set "HEAD" up. At the moment, HEAD is the same as REL2, but the WanDaemon contributors are soon likely to make major changes.
To get on the MetaNet, you first should subscribe to meta-admin@lists.meta.net.nz. This is a MailMan? MailingList. The best way to subscribe is to go here: 
https://lists.meta.net.nz/cgi-bin/mailman/listinfo/meta-admin.
Then you'll need renumber to an internal IP address range that is unique, so you contact someone on the list (MetaNetAssignments) to allocate you some space. They can allocate you address space by going to 
http://www.tla/maint/. (This is a !MetaNet address, and isn't actually a Catch-22 situation.)
This guide assumes you're running Linux. If you aren't, all hope is not lost. See 1?.
You need a 2.4 series kernel.
$ uname -a
If you don't have one, go get one now. You'll thank yourself later. You might have to upgrade your firewalling from ipchains to iptables; check FirewallNotes for information.
Your kernel has to support TUN/TAP. If you're configuring with make menuconfig select "Network device support" and then "Universal TUN/TAP device driver support". For information on Ethertap, see 2?.
Note: The module for TUN/TAP is 'tun', not 'tuntap.' Many an hour of head banging has occured due to trying to modprobe the wrong module!
You will also need /sbin/ip (see iproute(8)?). This usually comes in a package called iproute (eg Debian) or iproute2 depending on your distribution.
TUN/TAP needs a device file created. 3?
mkdir /dev/net mknod /dev/net/tun c 10 200
http://sheridan.meta.net.nz/debian metanet contrib
deb-src http://sheridan.meta.net.nz/debian metanet contribthen issue
apt-get update apt-get install wandclients
Answer the questions, and you're done for the install.
There is no RPM for wand yet, however you should really go and make one.
When prompted for a password press enter
cvs -z3 -d:pserver:anonymous@cvs.wand.sourceforge.net:/cvsroot/wand co -r REL2 wand
You can download tarballs from
Then you need to compile and install it
cd wand make make install
If you get an ld error on make (e.g. /usr/bin/ld cannot find -lconfig) check you are running make from the top level directory and you have bison & flex installed.
If you are running GCC 3.3, you'll get a screenful of errors. To work around these, you can comment out the usage lines and add in a #include "assert.h" to the .cc files that complain about an assert error.
After that, you will need to configure it:
If you installed from the Sheridan Debian archive, you should check the files in /etc/wandclients/, but this step will be mostly done for you.
There are two config files: etud.conf and wand.conf.
cp /usr/local/etc/etud.conf{.sample,} $EDITOR /usr/local/etc/etud.conf
If you're an Ethertap user (see footnotes 2? and 3?), change 'tuntap.so' to read 'ethertap.so'. Set the MTU to 1280. Set macaddr to the MAC address of one of the NIC's in your machine. eth0 is the normal one to use. If you don't know your MAC address, ifconfig(8) will tell you: try
/sbin/ifconfig eth0 | grep HWaddr | cut -c 39-
cp /usr/local/etc/wand.conf{.sample,} $EDITOR /usr/local/etc/wand.conf
(N.B. make install may create /usr/local/etc/wand.$HOSTNAME.conf.original: in this case use: cp /usr/local/etc/wand.$HOSTNAME.conf{.original,} )
You will need to talk to the person who allocated your address space, or #wlug on UnderNet, to get the IP address of a server to go in this config.
/usr/local/etc# Etud
tuntap_setup () entered... Failed to initialise interface. Aborting...
/usr/local/etc#
noauto wan0 iface wan0 inet static
address 192.168.x.y netmask 255.255.0.0 network 192.168.0.0 broadcast 192.168.255.255 mtu 1280
The GATEWAY value is your normal gateway (Same as in ifcfg-eth0). This is needed because RedHat likes overwriting your default route each time you bring up an interface.
There are init scripts that work fine under Debian. They are /etc/init.d/Etud and /etc/init.d/wand. Etud needs to be started before wand does. If you installed from the Debian packages, they are at startup levels 19 and 20 in your /etc/rc?.d/ directories.
Take a look at RedHatMetaNetScripts for some Redhat scripts
Make sure that your FireWall allows UDP traffic on ports 22222 and 44444 UDP. Also make sure that traffic to/from wan0/tap is not blocked (wan0 for TUN/TAP, tap0 for ethertap 2?).
Now, you should be able to ping 192.168.66.10 after a few seconds. This is the MetaIX address of Hydrogen, the current !MetaNet server.
You may wish to add a
killall -USR1 wand
to your ip-up scripts if your internet connection terminates on your linux machine and you have a dynamic IP.
Congratulations, at this point you should have WanDaemon running on your machine.
Next you have to configure and start zebra(8)?.
The next step is to enable all the useful stuff: proceed on to MetaNetConfiguration.
1? Not Running Linux?
PerryLorier about it if you're interested.GRE Tunnels are supported now, although you have to talk nicely to be allowed on via one. In the general case, point-to-point tunnels like ipsec/gre/pptp aren't preferred, as they require all your !MetaNet traffic to go through one host. Talk to DanielLawson if you want a GRE or PPTP tunnel onto the MetaNet. Look at GRETunnel for more information on GRE Tunnels.
2? Ethertap support has been deprecated as it has been deprecated in the kernel. Note that if your kernel is already configured for ethertap, you can keep using it - just change etud.conf to point at ethertap.so for its driver, not tuntap.so. However, look at compiling TUN/TAP in next time you change your kernel.
3 pages link to MetaNetInstallation:
