Statistics
| Branch: | Tag: | Revision:

mininet / INSTALL @ 5947e017

History | View | Annotate | Download (2.38 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
- A functional netns binary is required to run mininet, but currently you
14
  have to compile it and install it yourself from the included .c file:
15

    
16
  to make it: make netns (or cc -o netns netns.c)
17
  to test it: ./netns /sbin/ifconfig -a 
18
  to 'install' a link to it, you could do something like:
19
    sudo ln -s /home/openflow/mininet/netns /usr/local/bin/netns
20

    
21
  Installation is simplest with a distribution that includes a kernel
22
  which supports the CLONE_NETNS unshare flag by default. Debian 5.0+ does
23
  (e.g. current debian-testing release); Ubuntu doesn't. If your kernel
24
  doesn't support it, you will need to build and install a kernel that
25
  does!
26

    
27
- Mininet should probably be run either on a machine with
28
  no other important processes, or on a virtual machine.
29
  Multiple concurrent Mininet instances are not supported.
30

    
31
- To run the iperf test, you need to install iperf:
32

    
33
    sudo aptitude/yum install iperf
34

    
35
  We assume you already have ping installed. ;-)
36
  
37
- You may need other packages to run the examples, e.g.
38

    
39
    sudo aptitude/yum install sshd xterm screen
40
    
41
  Consult the appropriate example file for details.
42
  
43
- To switch to the most recent OpenFlow 0.8.9 release branch (the most
44
  recent one with full NOX support):
45

    
46
  git checkout -b release/0.8.9 remotes/origin/release/0.8.9
47

    
48
  If you want to automatically load the kernel modules required
49
  for OpenFlow, you could add something like the following to
50
  /etc/rc.local:
51

    
52
    insmod /home/openflow/openflow/datapath/linux-2.6/ofdatapath.ko 
53
    modprobe tun
54

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

    
65
    sudo su -c "cat sysctl_addon >> /etc/sysctl.conf"
66

    
67
  To save the config change, run:
68

    
69
    sudo sysctl -p
70

    
71
---
72

    
73