Repository navigation
VM Creation Notes
These instructions cover the process of building a Mininet-capable VM from scratch, using Ubuntu 12.10. For setup instructions, see VM-Setup-Notes.
Note: If you need to build on a non-Ubuntu distro, you are currently on your own. The included shell scripts may work on your platform, but significant changes are likely (e.g. yum vs. apt-get and different package names for Fedora.)
First, create a new Ubuntu 12.10 VM (using VMware, VirtualBox, etc..) We use user: mininet and password: mininet in our default VM, but any user/password combo should work as long as it has admin/sudo privileges.
Next, log in to the new VM and do the following:
wget https://raw.github.com/mininet/mininet/master/util/vm/install-mininet-vm.sh
time bash install-mininet-vm.sh
After this completes (about 5 minutes), Mininet should work:
$ sudo mn --test pingall
That's it!
For historical reference, we have also preserved the Old VM Creation Notes.
In the future, these steps will be automated, but for now there are several manual steps.
-
Created a new VM
mininet-vmin VMware using the Ubuntu 12.10 server amd64 image with auto-install, andmininetfor all user information and passwords. -
Customized it by increasing the memory to 1536 MB.
-
Booted VM and let auto-install complete
-
Ran the following commands:
wget https://raw.github.com/mininet/mininet/master/util/vm/install-mininet-vm.shtime bash install-mininet-vm.sh(Less than 4 minutes to complete.)
-
Tested mininet
sudo mn --test pingall -
Shut down and exported OVF
time /Applications/VMware\ OVF\ Tool/ovftool mininet-vm.vmx mininet-vm.ovfCompleted in 1:51
-
Fixed OVF so it will load in VirtualBox
sed -i -e '/vmw:Config/d' mininet-vm.ovf -
Stored SHA1 checksums in mininet-vm.mf
openssl sha1 mininet-vm.ovf mininet-vm-disk1 > mininet-vm.mf(OS X command) -
Zipped and uploaded to GitHub
mkdir mininet-ovf
mv mininet-vm-disk1.vmdk mininet-vm.{mf,ovf} mininet-ovf
zip -r mininet-ovf mininet-ovf
mv mininet-ovf.zip mininet-2.0.0-113012-amd64-ovf.zip
I didn't do the following:
-
Removed dhcp leases
cd /var/lib/dhcp/
rm *lease* -
Shut down VM and added an additional private (host-only) network interface.