summaryrefslogtreecommitdiff
path: root/network/vde2/README
blob: d893cc50f0c75cc23c830c203e6d6d3752b5c1d7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
VDE is an ethernet compliant virtual network which includes tools such
as 'vde_switch' and 'vdeqemu'. VDE switch has several virtual ports
where virtual machines, applications, virtual interfaces and
connectivity tools can be virtually plugged in. VDE qemu works as a
wrapper for running qemu virtual machines that connects transparently
to a specified vde_switch

VDE is dependant upon TUN/TAP support in the Linux Kernel; this comes
enabled by default with Slackware 12's 'generic' kernel.  To enable
TUN/TAP support manually, you must set the following entry in your 
kernel's '.config' file and recompile:
	CONFIG_TUN=m

## Configuration
An init script has been provided in /etc/rc.d/rc.vde2 to use with 
vde_switch. Edit this script and provide the TAP inteface name as 
well as the subnet for your Virtual Switch to use.  Do NOT choose
a subnet which is already in use. More than likely, the default 
values will work fine.

## VDE + Qemu
A common usage for vde_switch is to be able to have emulated OS's 
via Qemu behave as if they were actually attached to a Local Network.
To enable this functionality with Qemu, replace any calls to 'qemu'
with the following command:

vdeqemu -net vde,vlan=0 -net nic,vlan=0,macaddr=AA:BB:CC:DD:EE:FF

Note that the 'macaddr' string is optional but can prove to be
quite useful when used in conjuction with a DHCP server (such as
dhcpd or dnsmasq) to assign IP's based upon MAC address.

Do not forget to include the options which point vdeqemu to your
ISO image to boot along with any other options you may have used
with 'qemu' such as -localtime, -nographic etc.

## Startup
To have this start upon each boot, add the following lines to
/etc/rc.d/rc.local and make sure rc.vde2 is executable.

	# Start vde_switch
	if [ -x /etc/rc.d/rc.vde2 ]; then
	   /etc/rc.d/rc.vde2 start
	fi