seandunlap / ipmininet

Mininet extension to make experimenting with IP networks easy

IPMininet

This is a python library, extending Mininet, in order to support emulation of (complex) IP networks. As such it provides new classes, such as Routers, auto-configures all properties not set by the user, such as IP addresses or router configuration files, ...

ipmininet/examples/README contains a description of the examples that come with this library.

Installation

Virtual Machine

We maintain a vagrant box packaged with all the daemons. To use it, first install Vagrant and Virtualbox and then, execute the following commands:

$ vagrant init ipmininet/ubuntu-16.04
$ vagrant up

This will create the VM. To access the VM with SSH, just issue the following command in the same directory as the two previous one:

$ vagrant ssh

Manual installation from sources

To manually install IPMininet from source, first get the source code:

$ git clone https://github.com/cnp3/ipmininet.git
$ cd ipmininet
$ git checkout <version>

Then, install IPMininet, Mininet and all the daemons:

$ sudo python util/install.py -iamf

You can choose to install only a subset of the daemons by changing the options on the installation script. For the option documentations, use the -h option.

Manual installation from PyPI

Install Mininet by following its documentation.

Then, you can download and install IPMininet.

$ sudo pip install ipmininet

Finally, you can install all the daemons:

$ sudo python util/install.py -af

You can choose to install only a subset of the daemons by changing the options on the installation script. For the option documentations, use the -h option.

Contributions

If you want to contribute, feel free to open a Pull Request. ipmininet/tests/README contains the instructions to run the test suite of the library.