View on GitHub

MiniNExT | Mininet ExTended

Making it easier to build complex networks in Mininet

Download this project as a .zip file Download this project as a tar.gz file

MiniNExT is an extension layer that makes it easier to build complex networks in Mininet.

MiniNExT includes building blocks that are used in many experimental networks, including:

In addition, MiniNExT hosts / containers can provide greater isolation, including:

We also make it easier to express common configurations with:

We hope to upstream some of these extensions (such as support for PID and UTS namespaces, easier mount management, etc.) into mainline Mininet.

Project Details

MiniNExT was developed by Brandon Schlinker at The University of Southern California in collaboration with Kyriakos Zarifis (USC), Italo Cunha (UFMG), Nick Feamster (GaTech), Ethan Katz-Bassett (USC), and Minlan Yu (USC).

MiniNExT is part of the PEERING project at USC, which combines Transit Portal and MiniNExT. Combined, these tools enable researchers to build realistic AS topologies that can exchange BGP routes and traffic with real ISPs around the world. The PEERING tools played a role in evaluating Software Defined Internet Exchanges by making it possible to build a virtual IXP fabric composed of real ISP peers.

For problems with the code base, please use the GitHub issue tracker. All other queries, please email bschlink@usc.edu

Getting Started

Installing Mininet

MiniNExT depends on the Mininet software package, and thus you must have Mininet installed.

You can check if you already have Mininet installed and its version by executing mn --version

If Mininet is not installed, you can install it on Debian/Ubuntu by executing:

$ sudo apt-get install mininet

OR, Mininet can be installed from source by following the instructions on the Mininet website

Downloading MiniNExT

MiniNExT sources are available here. The easiest option is to download a .zip or .tar.gz source archive. Download and extract the archive to a location in your home directory.

You may also prefer to use git to clone the MiniNExT repository to make upgrading easier.

Installing MiniNExT Dependencies

MiniNExT depends on a packages that may not be installed by default with Mininet.

To list these dependencies, execute the following in the directoy where you extracted MiniNExT:

$ make deps

These dependencies can be installed on Debian/Ubuntu by executing:

$ sudo apt-get install `make deps`

Installing MiniNExT

To install MiniNExT, execute the following in the directoy where you extracted MiniNExT:

$ sudo make install

Uninstalling MiniNExT

To uninstall MiniNExT, execute the following in the directoy where you extracted MiniNExT:

$ sudo make uninstall

Note that the pip package must be installed for this to work.

Developer Installation

If you're extending or debugging MiniNExT, you likely do not want to install to the system's Python library.

Instead, you can run the following command to install MiniNExT in developer mode:

$ sudo make develop

This triggers the development mode that is provided by the setuptools package, which then creates a link instead of performing a complete installation. However, note that the mxexec and supporting help files are still installed into their respective system paths.

To remove, run:

$ sudo make undevelop

Note: MiniNExT no longer forks Mininet
Previously MiniNExT functionality was built by forking and modifying the original Mininet source code. However, this created conflicts with existing Mininet installations and made it difficult to merge in upstream changes. MiniNExT has been redesigned to extend Mininet, and does not impact default Mininet execution.