Statistics
| Branch: | Tag: | Revision:

mininet / INSTALL @ bca38c99

History | View | Annotate | Download (2.13 KB)

1
Preliminary Mininet Installation/Configuration Notes
2
---
3

    
4
- This is not (yet) a 'release'; things may be broken.
5

    
6
- To install mininet, with root privileges:
7

    
8
  python setup.py install
9

    
10
  This places the mininet package in /usr/lib/python-2.5/site-packages/,
11
  so that 'import mininet' will work.
12

    
13
- Installation is simplest with a distribution that includes a kernel
14
  which supports the CLONE_NETNS unshare flag by default. Debian 5.0+ does
15
  (e.g. current debian-testing release); Ubuntu doesn't. If your kernel
16
  doesn't support it, you will need to build and install a kernel that
17
  does! If you are using OpenVSwitch, 2.6.33 works best. For the reference
18
  kernel switch, 2.6.30 is compatible.
19

    
20
- Mininet should probably be run either on a machine with
21
  no other important processes, or on a virtual machine.
22
  Multiple concurrent Mininet instances are not supported.
23

    
24
- To run the iperf test, you need to install iperf:
25

    
26
    sudo aptitude/yum install iperf
27

    
28
  We assume you already have ping installed. ;-)
29
  
30
- You may need other packages to run the examples, e.g.
31

    
32
    sudo aptitude/yum install sshd xterm screen
33
    
34
  Consult the appropriate example file for details.
35
  
36
- To switch to the most recent OpenFlow 0.8.9 release branch (the most
37
  recent one with full NOX support):
38

    
39
  git checkout -b release/0.8.9 remotes/origin/release/0.8.9
40

    
41
  If you want to automatically load the kernel modules required
42
  for OpenFlow, you could add something like the following to
43
  /etc/rc.local:
44

    
45
    insmod /home/openflow/openflow/datapath/linux-2.6/ofdatapath.ko 
46
    modprobe tun
47

    
48
- The reference OpenFlow controller (controller(8)) only supports 16
49
  switches by default! If you wish to run a network with more than 16
50
  switches, please recompile controller(8) with larger limits, or use a
51
  different controller such as nox.
52
  
53
- For scalable configurations, you might need to increase some of your
54
  kernel limits. Sample params are in sysctl_addon, which can be appended to
55
  /etc/sysctl.conf (and modified as necessary for your desired
56
  configuration):
57

    
58
    sudo su -c "cat sysctl_addon >> /etc/sysctl.conf"
59

    
60
  To save the config change, run:
61

    
62
    sudo sysctl -p
63

    
64
---
65

    
66