Page History

...

This document assumes that you already have a VM or server  (we recommend Ubuntu 16 LTS) 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 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

...