= Using UML for ORBIT Node virtualization =
The goal of this web page is to provide a brief overview 
of how the ORBIT grid could be used to evaluate the performance
of UML based virtualization with frequency division multiplexing.

 == Outline ==

1. Load the concerned ORBIT nodes with the image "uml_orbit.ndz" using the 
omf load command.

2. Once the image is loaded, create the desired tun/tap devices using the command 
tunctl
{{{
tunctl -u devname
}}}

3. Setup appropriate IP addresses for the tap interface.

4. Ensure IP forwarding is enabled on the host. This can be done by:
{{{
host# echo 1> /proc/sys/net/ipv4/ip_forward
}}}

5. Also set proxy_arp by:
{{{
host#ech0 1 > /proc/sys/net/ipv4/conf/tap0/proxy_arp
}}}

6. Configure the wireless cards by using appropriate 
commands as per the madwifi device driver guideliness
which are available [http://madwifi-project.org/wiki/UserDocs/FirstTimeHowTo here].

7. Make appropriate changes to the kernel routing table to ensure
packets can be sent to and from the interface.

8. Start the UML instance 

9. Traffic can be generated using the iperf traffic generator.
Run a Iperf server and a client on the two ends of the link.
Details on running iperf are available [http://www.noc.ucf.edu/Tools/Iperf/ here].

10. Result logs can be parsed and interpreted using simple awk scripts.


 == Additional Notes ==
Additional information on setting up and using UML is
provided here: http://user-mode-linux.sourceforge.net/

Results based on evaluation of UML on ORBIT are discussed
in [http://ieeexplore.ieee.org/xpls/abs_all.jsp?isnumber=4510772&arnumber=4510809&count=50&index=36 this paper].

 == Relevant Publications ==

1. Singhal, S.; Hadjichristofi, G.; Seskar, I.; Raychaudhri, D., "Evaluation of UML Based Wireless Network Virtualization," Next Generation Internet Networks, 2008. NGI 2008 , vol., no., pp.223-230, 28-30 April 2008