Statistics
| Branch: | Tag: | Revision:

mininet / INSTALL @ 4ff6243f

History | View | Annotate | Download (2.47 KB)

1

    
2
Mininet Installation/Configuration Notes
3

    
4
Mininet 2.0.0d3
5

    
6
---
7

    
8
The supported installation methods for Mininet are 1) using
9
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
(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
The easiest way to get Mininet running is to start with one of our pre-built 
18
virtual machine images from http://openflow.org/mininet
19

    
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
your native OS installation or damage it in any way.
24

    
25
2. Native installation on Ubuntu
26

    
27
If you're reading this, you've probably already done it, but the command to
28
download the Mininet source code is;
29
   
30
  git clone git://openflow.org/mininet.git
31

    
32
If you are running Ubuntu, you may be able to use our handy install.sh script,
33
which is in mininet/util.
34

    
35
WARNING: USE AT YOUR OWN RISK!
36

    
37
install.sh is a bit intrusive and may possibly damage your OS and/or
38
home directory, by creating/modifying several directories such as
39
mininet, openflow, openvswitch and noxcore. Although we hope it won't
40
do anything completely terrible, you may want to look at the script
41
before you run it, and you should make sure your system and home
42
directory are backed up just in case!
43

    
44
To install Mininet itself, the OpenFlow reference implementation, and
45
Open vSwitch, you may use:
46

    
47
$ mininet/util/install.sh -fnv
48

    
49
This should be reasonably quick and the following command should work
50
after the installation:
51

    
52
$ sudo mn --test pingall
53

    
54
To install ALL of the software which we use for OpenFlow tutorials,
55
including NOX classic, the OpenFlow WireShark dissector, the oftest
56
framework, and other potentially useful software (and to add some stuff
57
to /etc/sysctl.conf which may or may not be useful) you may use
58

    
59
$ mininet/util/install.sh -a
60

    
61
This takes about 20 minutes on our test system.
62

    
63
3. Creating your own Mininet/OpenFlow tutorial VM
64

    
65
Creating your own Ubuntu Mininet VM for use with the OpenFlow tutorial
66
is easy! First, create a new Ubuntu VM. Then, run
67

    
68
$ wget https://raw.github.com/mininet/mininet/util/vm/install-mininet-vm.sh
69
$ time install-mininet-vm.sh
70

    
71
Good luck!
72

    
73
p.s. Note that only one instance of Mininet is currently supported on a single
74
machine - that's one reason we recommend using a VM to run it.
75

    
76
---
77

    
78
  
79