Page History

...

This document assumes that you already have a VM or server  (we recommend Ubuntu 16 LTS, in spite of an annoying kernel bug) where you can compile ONOS, preferably using buck (or possibly with Maven - see below.)

1. Configure your VM with enough memory to run ONOS!
   1. ONOS java processes tend to consume a huge amount of memory. (In the future ONOS may go on a diet, but for now it's pretty heavyweight.)  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. So a 3-node cluster should be usable in a VM with 6-12 GB of RAM. 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!
2. You may find it more convenient to install a GUI in your VM if you haven't already.
   1. In Ubuntu, you can use the default Ubuntu Unity desktop or the lighter-weight LXDE.
3. For VirtualBox, you may wish to set up networking so that you can connect from your host machine into your VM
   1. Usually this means adding a host-only interface to the VM, and making sure it's configured
   2. Make sure that interface has an IP address (you can check with ifconfig or ip addr)
   3. You may need to run dhclient manually

...

Option 1: If you are running Ubuntu 16.04 or later, you can easily install Mininet 2.2 (and bridge-utils for LinuxBridge) using apt-get:

...

cd ~/onos
tools/build/onos-buck build onos

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

...