Penguin
Blame: FreeBSDMetaNetInstallation
EditPageHistoryDiffInfoLikePages
Annotated edit history of FreeBSDMetaNetInstallation version 3, including all changes. View license author blame.
Rev Author # Line
1 PhilMurray 1 I haven't finished, leave me alone.
2
3 !!How do I get on the MetaNet?
4
5 Please ensure you've read the MetaNet page and understand what exactly you're doing before you follow these instructions.
6
7 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.
8
9
10 !!Before You Touch The Software
11
12 !Subscribe to the mailing list
13
14 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.
15
16 !Renumber your network
17
18 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.)
19
20 !!Install the wandclients software
21
22 !FreeBSD 5.x Users:
3 PhilMurray 23 pkg_add http://stardust.nevada.net.nz/~pmurray/wand-1.3.tbz
1 PhilMurray 24
25 !FreeBSD 4.x Users:
3 PhilMurray 26 I haven't created a binary package, and probably never will.
1 PhilMurray 27
28 !!Configure the software
29
30 There are two config files: etud.conf and wand.conf.
31
32 !etud.conf
33
34 cp /usr/local/etc/etud.conf{.sample,}
35 $EDITOR /usr/local/etc/etud.conf
36
37 On FreeBSD we use the ethertap driver, change 'tuntap.so' to read 'ethertap.so'.
38 Set the [MTU] to 1280.
39 Set macaddr to the MAC address of one of the NIC's in your machine. Your internal ethernet NIC is the normal one to use (eg. fxp0 or rl0). If you don't know your [MAC] address, ifconfig(8) will tell you: try
40 /sbin/ifconfig fxp0 | grep ether | cut -d\ -f 2
41
42 !wand.conf
43
44 cp /usr/local/etc/wand.conf{.sample,}
45 $EDITOR /usr/local/etc/wand.conf
46
47 (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,} )
48
49 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.
50
51 ! tap0 interface
52 You also need to provide the tun driver with network settings for the interface, otherwise you get an error message like:
53 /usr/local/etc# Etud
54 tuntap_setup () entered...
55 Failed to initialise interface.
56 Aborting...
57 /usr/local/etc#
58
59 !!Starting the !MetaNet daemons
60
61 I haven't made proper FreeBSD (ie, RCng) init scripts yet. Will do so when I understand them.
62
63 For now, you can add to /etc/rc.local something like:
64
65 killall Etud wand
66 /usr/local/sbin/Etud
67 ifconfig tap0 inet 192.168.x.y netmask 255.255.0.0 mtu 1280
68 /usr/local/sbin/wand
69 /usr/local/sbin/zebra -d
70 /usr/local/sbin/bgpd -d
71
72 Make sure that your FireWall allows [UDP] traffic on ports 22222 and 44444 UDP. Also make sure that traffic to/from tap is not blocked.
2 AndersGreen 73
74 If you use FreeBSD 5x you must also run this ifconfig tap0 -staticarp -monitor -link1 -link2
75
1 PhilMurray 76
77 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.
78
79 !!Onwards and upwards.
80 Congratulations, at this point you should have WanDaemon running on your machine.
81
82 Next you have to configure and start zebra(8).
83
84 The next step is to enable all the useful stuff: proceed on to MetaNetConfiguration.