Statistics
| Branch: | Tag: | Revision:

mininet / INSTALL @ 21b2c2c4

History | View | Annotate | Download (2.81 KB)

1 35341142 Bob Lantz
2 d2f9aea2 Bob Lantz
Mininet Installation/Configuration Notes
3 af8f0b61 Bob Lantz
4 21b2c2c4 Bob Lantz
Mininet 2.0.0rc1
5 35341142 Bob Lantz
6 219f9de7 Bob Lantz
---
7 8125370d Bob Lantz
8 219f9de7 Bob Lantz
The supported installation methods for Mininet are 1) using
9 e04c207c Bob Lantz
a pre-built VM image, and 2) native installation on Ubuntu. You
10
can also easily create your own Mininet VM image (3).
11
12 40beaabc Bob Lantz
(Other distributions may be supported in the future - if you would
13
like to contribute an installation script, we would welcome it!)
14
15
1. Easiest "install" - use our pre-built VM image!
16
17 52c700ff Bob Lantz
The easiest way to get Mininet running is to start with one of our pre-built 
18 219f9de7 Bob Lantz
virtual machine images from http://openflow.org/mininet
19 40beaabc Bob Lantz
20
Boot up the VM image, log in, and follow the instructions on the wiki page.
21
22
An additional advantage of using the VM image is that it doesn't mess with
23 219f9de7 Bob Lantz
your native OS installation or damage it in any way.
24 40beaabc Bob Lantz
25 600dad24 Bob Lantz
2. Next-easiest install: use our Ubuntu package!
26
27
To install Mininet itself (i.e. mn and the Python API) on Ubuntu 12.10+
28
29
  sudo apt-get install mininet
30
31 c04ef88e Bob Lantz
Note: if you are upgrading from an older version of Mininet, make sure you
32
remove the old OVS from /usr/local:
33
34
  sudo rm /usr/local/bin/ovs*
35
  sudo rm /usr/local/sbin/ovs*
36
37 600dad24 Bob Lantz
3. Native installation from source on Ubuntu 11.10+
38 40beaabc Bob Lantz
39 e04c207c Bob Lantz
If you're reading this, you've probably already done it, but the command to
40
download the Mininet source code is;
41
   
42
  git clone git://openflow.org/mininet.git
43
44
If you are running Ubuntu, you may be able to use our handy install.sh script,
45
which is in mininet/util.
46 40beaabc Bob Lantz
47 219f9de7 Bob Lantz
WARNING: USE AT YOUR OWN RISK!
48
49 d2f9aea2 Bob Lantz
install.sh is a bit intrusive and may possibly damage your OS and/or
50
home directory, by creating/modifying several directories such as
51
mininet, openflow, openvswitch and noxcore. Although we hope it won't
52
do anything completely terrible, you may want to look at the script
53
before you run it, and you should make sure your system and home
54
directory are backed up just in case!
55 40beaabc Bob Lantz
56 e04c207c Bob Lantz
To install Mininet itself, the OpenFlow reference implementation, and
57
Open vSwitch, you may use:
58 40beaabc Bob Lantz
59 e04c207c Bob Lantz
$ mininet/util/install.sh -fnv
60 40beaabc Bob Lantz
61 e04c207c Bob Lantz
This should be reasonably quick and the following command should work
62
after the installation:
63 40beaabc Bob Lantz
64 e04c207c Bob Lantz
$ sudo mn --test pingall
65 40beaabc Bob Lantz
66 e04c207c Bob Lantz
To install ALL of the software which we use for OpenFlow tutorials,
67
including NOX classic, the OpenFlow WireShark dissector, the oftest
68
framework, and other potentially useful software (and to add some stuff
69
to /etc/sysctl.conf which may or may not be useful) you may use
70 8125370d Bob Lantz
71 e04c207c Bob Lantz
$ mininet/util/install.sh -a
72 ec226c9b Bob Lantz
73 e04c207c Bob Lantz
This takes about 20 minutes on our test system.
74 8eae2550 Bob Lantz
75 600dad24 Bob Lantz
4. Creating your own Mininet/OpenFlow tutorial VM
76 8eae2550 Bob Lantz
77 e04c207c Bob Lantz
Creating your own Ubuntu Mininet VM for use with the OpenFlow tutorial
78
is easy! First, create a new Ubuntu VM. Then, run
79 8eae2550 Bob Lantz
80 e04c207c Bob Lantz
$ wget https://raw.github.com/mininet/mininet/util/vm/install-mininet-vm.sh
81
$ time install-mininet-vm.sh
82 d2f9aea2 Bob Lantz
83 e04c207c Bob Lantz
Good luck!
84 8eae2550 Bob Lantz
85 40beaabc Bob Lantz
p.s. Note that only one instance of Mininet is currently supported on a single
86
machine - that's one reason we recommend using a VM to run it.
87 8eae2550 Bob Lantz
88
---
89
90 52c700ff Bob Lantz
  
91