tree: d921f026342d90d1039d28a9a3bd72bf2c8e5f9a [path history] [tgz]
  1. .gitignore
  2. README.md
  3. Vagrantfile
  4. bm-commands.sh
  5. export-ova.sh
  6. install-p4-tools.sh
  7. kernel-update.sh
  8. ova-cleanup.sh
  9. root-bootstrap.sh
  10. start_onos.sh
  11. tutorial-bootstrap.sh
  12. upload-ova.sh
  13. user-bootstrap.sh
tools/dev/p4vm/README.md

ONOS-P4 Developer Virtual Machine

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.

Contents

The VM is based on Ubuntu 18.04 (server) and contains the following software:

  • ONOS
  • BMv2 simple_switch_grpc (P4 software switch with P4Runtime support)
  • p4c (P4 compiler)
  • Mininet (network emulator)

Tutorial VM

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.

Recommended system requirements

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.

Download a 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

Login credentials

The VM comes with one user with sudo privileges named sdn with password rocks. Use these credentials to log in the guest Ubuntu system.

Build the VM

Requirements

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.

Build using Vagrant

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 sdn user:

sudo su sdn

Export as OVA package

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:

  1. provision the VM using Vagrant;
  2. reduce VM disk size (by removing build artifacts);
  3. generate a file named onos-p4-dev.ova.

Build the tutorial VM

To build the tutorial VM, you can use the following command:

./export-ova.sh tutorial

Known issues

Dev VM (Ubuntu 18.04 Server)

Tutorial VM (Ubuntu 18.04 Server)