Installation¶

IPMininet needs at minimum:

Python (with pip) 3.6+
Mininet

IPMininet needs some daemon executables to be installed and accessible through the PATH environment variable:

FRRouting daemons: zebra, ospfd, ospf6d, bgpd, pimd
RADVD
SSHD

You can either download them by hand or rely on one the following methods:

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-20.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¶

You can download and install IPMininet. You can change the installed version by replacing “v1.1” in the following commands. If you have pip above 18.1, execute:

$ sudo pip install --upgrade git+https://github.com/cnp3/ipmininet.git@v1.1

If you have an older version of pip, use:

$ sudo pip install --process-dependency-links --upgrade git+https://github.com/cnp3/ipmininet.git@v1.1

Then, you can install all the daemons:

$ sudo python -m ipmininet.install -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.