Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

If Mininet doesn't work, consult the troubleshooting section below.

...

Building ONOS

Make sure that you have built ONOS in your Mininet VM or server using buck:

cd ~/onos
buck build onos

Make sure that the build completes without errors - without a correct ONOS package, you will not be able to start ONOS.
 

Info
titleGive your VM enough memory for ONOS!

ONOS java processes tend to consume a huge amount of memory. In order to run an ONOS cluster in a single VM, you should allocate a large amount of RAM to that VM. We recommend 2-4 GB (or more if you have it) for each ONOS node that you intend to run. You can see how much memory and CPU ONOS's java processes are using by running top - if you start using swap space, the performance of ONOS and Mininet will suffer greatly!

First, make sure that you have built ONOS in your Mininet VM or server using buck:

cd ~/onos
buck build onos
Legacy build process using Maven

It's also possible to use the legacy mvn build process if absolutely necessary, by setting ONOS_TAR to point to the ONOS package:

cd ~/onos
mvn clean install  # or mci for short; needs to complete without errors
onos-package  # once again, 
Info
titleLegacy build process using Maven

It's also possible to use the legacy mvn build process if absolutely necessary, by setting ONOS_TAR to point to the ONOS package:

cd ~/onos
mvn clean install  # or mci for short; needs to complete without errors
onos-package  # once again, needs to complete without errors
cdcd ~/onos/tools/dev/mininet
sudo env ONOS_TAR=/tmp/onos-1.7.0.openflow.tar.gz mn --custom onos.py --controller onos,1 ...

Make sure that you use the correct ONOS_TAR file name for your version of ONOS. Also make sure that it is a gzip/tar archive:

sudo file /tmp/onos-1.7.0.openflow.tar.gz
/tmp/onos-1.7.0.openflow.tar.gz: gzip compressed data, from Unix, last modified: Thu Jun  2 15:08:11 2016

...

Starting up ONOS and your data network

Info
titleGive your VM enough memory for ONOS!

ONOS java processes tend to consume a huge amount of memory. In order to run an ONOS cluster in a single VM, you should allocate a large amount of RAM to that VM. We recommend 2-4 GB (or more if you have it) for each ONOS node that you intend to run. You can see how much memory and CPU ONOS's java processes are using by running top - if you start using swap space, the performance of ONOS and Mininet will suffer greatly!

Next, use Mininet and onos.py to start up a virtual ONOS cluster and data network:

...