Versions Compared

Key

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

...

We also hope that using onos.py will make ONOS development easier and more fun.

...

Configuring your development VM (or server)

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

...

  1. 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. 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 desktop GUI 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)

Getting Mininet

In order to use onos.py, you need Mininet, which is easy to install in a VM or server running a recent release of Ubuntu.

...