80 lines
2.5 KiB
Plaintext
80 lines
2.5 KiB
Plaintext
|
|
Mininet Installation/Configuration Notes
|
|
|
|
Mininet 2.0.0d3
|
|
|
|
---
|
|
|
|
The supported installation methods for Mininet are 1) using
|
|
a pre-built VM image, and 2) native installation on Ubuntu. You
|
|
can also easily create your own Mininet VM image (3).
|
|
|
|
(Other distributions may be supported in the future - if you would
|
|
like to contribute an installation script, we would welcome it!)
|
|
|
|
1. Easiest "install" - use our pre-built VM image!
|
|
|
|
The easiest way to get Mininet running is to start with one of our pre-built
|
|
virtual machine images from http://openflow.org/mininet
|
|
|
|
Boot up the VM image, log in, and follow the instructions on the wiki page.
|
|
|
|
An additional advantage of using the VM image is that it doesn't mess with
|
|
your native OS installation or damage it in any way.
|
|
|
|
2. Native installation on Ubuntu
|
|
|
|
If you're reading this, you've probably already done it, but the command to
|
|
download the Mininet source code is;
|
|
|
|
git clone git://openflow.org/mininet.git
|
|
|
|
If you are running Ubuntu, you may be able to use our handy install.sh script,
|
|
which is in mininet/util.
|
|
|
|
WARNING: USE AT YOUR OWN RISK!
|
|
|
|
install.sh is a bit intrusive and may possibly damage your OS and/or
|
|
home directory, by creating/modifying several directories such as
|
|
mininet, openflow, openvswitch and noxcore. Although we hope it won't
|
|
do anything completely terrible, you may want to look at the script
|
|
before you run it, and you should make sure your system and home
|
|
directory are backed up just in case!
|
|
|
|
To install Mininet itself, the OpenFlow reference implementation, and
|
|
Open vSwitch, you may use:
|
|
|
|
$ mininet/util/install.sh -fnv
|
|
|
|
This should be reasonably quick and the following command should work
|
|
after the installation:
|
|
|
|
$ sudo mn --test pingall
|
|
|
|
To install ALL of the software which we use for OpenFlow tutorials,
|
|
including NOX classic, the OpenFlow WireShark dissector, the oftest
|
|
framework, and other potentially useful software (and to add some stuff
|
|
to /etc/sysctl.conf which may or may not be useful) you may use
|
|
|
|
$ mininet/util/install.sh -a
|
|
|
|
This takes about 20 minutes on our test system.
|
|
|
|
3. Creating your own Mininet/OpenFlow tutorial VM
|
|
|
|
Creating your own Ubuntu Mininet VM for use with the OpenFlow tutorial
|
|
is easy! First, create a new Ubuntu VM. Then, run
|
|
|
|
$ wget https://raw.github.com/mininet/mininet/util/vm/install-mininet-vm.sh
|
|
$ time install-mininet-vm.sh
|
|
|
|
Good luck!
|
|
|
|
p.s. Note that only one instance of Mininet is currently supported on a single
|
|
machine - that's one reason we recommend using a VM to run it.
|
|
|
|
---
|
|
|
|
|
|
|