This directory contains files necessary to build and provision a VM to test and develop ONOS support for P4Runtime.
For more information on P4 support in ONOS please visit the following web page: https://wiki.onosproject.org/x/FYnV
This document contains also instructions on how to download a pre-built VM.
The VM is based on Ubuntu 18.04 (server) and contains the following software:
It is possible to generate a variant of the VM to be used during tutorials. This version of the VM comes with a desktop environment, pre-built ONOS and code editors.
The VM is configured with 4 GB of RAM and 2 CPU cores (4 cores for the tutorial variant). The disk has size of approx. 4 GB but expect to grow up to 8 GB when building ONOS. For a flawless experience we recommend running the VM on a host system that has at least the double of resources.
These are the recommended minimum requirements to be able to run a Mininet network with 1-10 BMv2 devices controlled by 1 ONOS instance. To emulate larger networks with multiple instances of ONOS (for example using
onos.py), we recommend configuring the VM to use at least 4 CPU cores.
To modify the VM configuration you can either modify the Vagrantfile (look for
vb.cpus) before starting the build process, or use the VirtualBox VM settings after you have imported the pre-built VM.
Building the VM takes around 30 minutes, depending on your Internet connection speed. If you would rather not wait, you can use the following link to download an Open Virtual Appliance (OVA) package to be imported using VirtualBox or any other x86 virtualization system that supports this format.
Pre-built OVA package (approx. 1.5 GB): http://onlab.vicci.org/onos/onos-p4-dev.ova
The tutorial variant of the OVA package can be found here (approx 3 GB): http://onlab.vicci.org/onos/onos-p4-tutorial.ova
The VM comes with one user with sudo privileges named
sdn with password
rocks. Use these credentials to log in the guest Ubuntu system.
To build the VM you will need the following software installed in your host machine:
Optionally, to export the VM as an OVA package you will also need sshpass.
The VM can be generated locally using Vagrant. In a terminal window type:
cd $ONOS_ROOT/tools/dev/p4vm vagrant up dev
Once Vagrant has provisioned the VM, you can access to it using the
vagrant ssh command. However, this command will log in to the guest Ubuntu shell with the default
vagrant user. To use ONOS and the other P4 tools, we suggest using the
sdn user. Once you are able to access the VM using
vagrant ssh, use the following command to switch to the
sudo su sdn
It is possible to generate an OVA package to distribute a pre-built VM. To generate the OVA file, in a terminal window type the following commands:
cd $ONOS_ROOT/tools/dev/p4vm ./export-ova.sh dev
This script will:
To build the tutorial VM, you can use the following command:
Dev VM (Ubuntu 18.04 Server)
VirtualBox shared folders are not mounted on startup even if "auto-mount" flag is set. To fix it:
sudo systemctl edit --full vboxadd-service
systemd-timesync.service from the
Conflicts= line, then reboot. (https://superuser.com/questions/1351003/after-upgrade-to-ubuntu-lts-18-virtualbox-shared-folders-marked-auto-mount-do)
Tutorial VM (Ubuntu 18.04 Server)
GNOME desktop can be very slow when using VirtualBox. Please select "Unity" as your graphical shell when logging in: https://askubuntu.com/questions/1035410/ubuntu-18-04-gnome-hangs-on-virtualbox-with-3d-acceleration-enabled
When using Unity, the Launcher menu is empty (no apps are shown).