How to install the Mininet SDN Network Simulator

admin

December 3, 2014
Most people who use the Mininet network simulator will download and set up the Mininet virtual machine image. However, there are times when we may want to use a different version of Mininet than the one already installed in the Mininet VM.

For example, we may want to use the newest features of Mininet currently being developed. The Mininet project releases beta-quality source code that user can download and install themselves.
. d( N* K1 H; D* d, z( X
1 g# {8 L9 I) f* d3 @4 }. tThis post will show how to install Mininet 2.2 Beta on a virtual machine image running Ubuntu Server. The steps described below should work for any version of Mininet that the user wants to install.

. n  A* O+ U5 E  x) S! _
Do not install Mininet on your host computer
Warning: Do not install Mininet on your host computer. Install in in a virtual machine.

; n. q5 H( p* H+ W: W8 nThe Mininet install script may overwrite files in your home directory (depending on what you already have installed)1. If Mininet makes changes that cause problems on an existing virtual machine, you can just delete the VM and try again with a fresh Ubuntu Server image. But, if you install Mininet directly on your host computer you may cause problems.
0 k4 M! }1 P  v
* `- R" d1 ~  M$ W* RIn my own experience, I tried installing Mininet on my host computer to see what would happen. After the installation was complete, I encountered system error messages and my current installation of Open vSwitch stopped working on my computer.
; }1 ?. T! `9 b9 b' A+ V5 x
# E1 {* m9 m# _! M, L* lUnless you are a Linux expert, ensure that you install Mininet only on a VM.

Installation Procedure
2 ]6 \5 t; \( {0 P6 q" [1 jThe Mininet documentation provides installation instructions. In this post we describe the procedure we followed and add a few details we think are helpful. The Mininet documentation also provides information about how to uninstall Mininet, how to install Mininet in other Linux distributions, and other details that we do not cover in this post.
$ v" J$ H/ n6 _. C# @+ y) t% C
& N  T5 j5 A5 H4 N' XTo install Mininet 2.2 Beta on a new virtual machine, we will execute the following steps:

Install Ubuntu Server 14.04 on a new VirtualBox virtual machine image
* N- |. l+ l1 Q, s2 u9 C5 B. sUpdate the Ubuntu Server system and install required software
Install Mininet 2.2 on the Ubuntu Server virtual machine
4 b: U+ Q  ]. v% ^Set up the virtual machine to work with the host computer
, j/ A: l" A2 P4 B2 ^9 fLogin to the Ubuntu Server VM and enable X11 forwarding using SSH
# \8 e) i! N/ E1 rInstall Ubuntu Server on a VM
% K% E3 s, d9 e. K; f  t) t% l9 N
Download the Ubuntu Server 14.04 ISO image from ubuntu.com.
4 a* ?4 c! ^  K
Create a new virtual machine in VirtualBox and install Ubuntu Server on it. Use the steps described in my previous post about installing Debian in a VirtualBox VM. The procedure is the same.

When installing Ubuntu Server, you can use all the default configurations and choose setting specific to your needs that will be obvious to you (like country, keyboard layout, and time zone).

2 X+ n9 P5 b" Q# gIn our example, I chose to name the server mininet-2-2 and to create a userid brian so all the following examples will use these names. You may choose different names.
1 W8 |: t2 Z: w7 q: X" y* s, B7 i
Update the Ubuntu Server VM

) j' \3 N* W/ ]) n* a& HFirst download and install system updates.
% |: o! ]7 Y4 B* a9 E0 T
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get dist-upgrade
Install required software
# c  v( S2 ^; H9 c/ f
4 I' `( r4 q4 i$ z3 A& CInstall git. Git is the software version control system used by the Mininet project.

* B1 X6 }2 w+ M3 s0 x! X. L$ sudo apt-get install git
Install Mininet 2.2 from source code

Use git to download the Mininet 2.2.0 source code.

3 k# W& Y$ q9 x+ P( Q) |1 B6 ~$ git clone git://github.com/mininet/mininet
This creates a folder in the home directory named mininet that contains the project file structure.

% R' [$ s  L6 X' m* nTo find the latest beta version of Mininet, list all tagged releases in the Mininet project.
- y7 i  R6 T  X$ W$ X
$ cd mininet
0 _& e) g8 y* d* [$ git tag
1.0.0
2.0.0
2.1.0
: w4 h( \" M! h2 S2.1.0p1
; T7 n6 u4 {2 V2.1.0p2
$ y; H9 Q, o2 H7 D& a! y2.2.0b0
2.2.0b1
" t* V, ?# ]$ A7 f/ ]9 O2.2.0b2
* a- K5 ]+ E' n2.2.0b3
cs244-spring-2012-final
4 }7 \) W( }6 d8 A+ Q% [4 eAbove, we see the latest available beta release is 2.2.0b3. So, we switch to that branch on our virtual machine.

$ git checkout -b 2.2.0b3
, f) N) X! E8 k' ^# }" RSwitched to a new branch '2.2.0b3'
The Mininet project provides an install script. Run the script. This will install Mininet 2.2 because the script is run using the files in the Mininet 2.2.0b3 branch.

$ ~/mininet/util/install.sh -a
+ p  M9 N, e6 U! wAfter the script stops running, test that the installation was successful. Execute the following command to test the installation. It should run a short Mininet scenario successfully.

$ sudo mn --test pingall
& P& U5 y; `' m1 s# F* C, ZSet up the VM to work with the host computer
2 d7 x5 Z0 M; s' y
5 V  N4 w; g& [) |" y3 s$ MNow we will set up the virtual machine so that we can connect to it from the host computer using SSH.
4 e, V/ Q1 o( c+ y
Shut down the Ubuntu Server VM.

$ sudo shutdown -h now
; P& N2 Y- }7 b9 W5 W* C$ m( aIn VirtualBox, Add a host-only adapter to the VM. Use the procedures listed below in my post about setting up the Mininet VM.
6 m, O& z# Q7 @- m2 Q4 s, v* O" m
2 n6 Z4 a" @8 g3 q% cAdd a Host-only Adapter in VirtualBox
Add Network Adapter to Mininet virtual machine
Start the Ubuntu Server VM again and log in via the VirtualBox console window
Configure a new virtual ethernet interface on the virtual machine
; q# D" |5 m5 d5 Q: \$ kIn the VirtualBox console menu, login to the VM and make a note of the IP address used by the host-only adapter:
* W, z8 I7 n* o4 W: u. n7 I% @
: K/ F, G. h8 ?* M7 h4 e" b$ ifconfig eth1
! J9 p9 W" E* V5 x8 B; c5 f2 D  GYou may log out of the VirtualBox console if you want.

Login to the Ubuntu Server VM

In our example above, the VM’s host-only adapter IP address is 192.168.56.101. So we will connect to this address via SSH from a terminal window on the host computer. This enables X11 forwarding so we can run X applications, such as Wireshark or MiniEdit.

admin@Host:~$ ssh -Y brian@192.168.56.101
brian@mininet-2-2:~$
In the example above, we have a user account blinklet on the Ubuntu Server named mininet-2-2. You may have defined a different username and server name.

3 D# [- ]' m' l: d) H1 ]: b3 ]Conclusion
# u, o+ E5 z! H8 f1 R* E" B& LWe installed Mininet 2.2 Beta on a virtual machine running Ubuntu Server 14.04.

See the README.md file in the ~/mininet directory after you download the Mininet source code