aboutsummaryrefslogtreecommitdiff
path: root/network/vde2/README
diff options
context:
space:
mode:
Diffstat (limited to 'network/vde2/README')
-rw-r--r--network/vde2/README48
1 files changed, 48 insertions, 0 deletions
diff --git a/network/vde2/README b/network/vde2/README
new file mode 100644
index 0000000000000..c5595558df17c
--- /dev/null
+++ b/network/vde2/README
@@ -0,0 +1,48 @@
+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 13'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/kvm
+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
+
+## For more information you can check:
+http://wiki.virtualsquare.org
+http://alien.slackbook.org/dokuwiki/doku.php?id=slackware:vde&s=qemu