Welcome to the P4+ONOS SRv6 tutorial! The goal of this tutorial is to teach you how to use ONOS as the control plane of a network of P4-capable devices, controlled using P4Runtime. The tutorial is organized around a sequence of hands-on exercises that show how to build a leaf-spine data center fabric based on a simplified version of Segment Routing over IPv6 (SRv6). Exercises will include activities such as:

• P4 implementation of basic forwarding behaviors (bridging and routing) as well as SRv6
• Writing P4 unit tests using the Packet Test Framework (PTF)
• Implementing an ONOS app providing the fabric control plane

Tutorial slides are available online. These slides provide an introduction to each exercise as well as the software tools used. We suggest you look at it before starting to work on the exercises.

A P4 language cheat sheet is also available online. It contains various P4 code examples that you can refer to.

To complete the exercises, you will need to download and run this tutorial VM (5.3 GB):

• http://bit.ly/p4d2-spring19-adv-vm
• http://onlab.vicci.org/onos/p4d2-spring19-adv-vm.ova (backup)

To run the VM you can use any modern x86 virtualization system. The VM has been tested with VirtualBox v6.0.6. To download VirtualBox and import the VM use the following links:

• https://www.virtualbox.org/wiki/Downloads
• https://docs.oracle.com/cd/E26217_01/E26796/html/qs-import-vm.html

The VM is configured with 4 GB of RAM and 4 CPU cores, while the disk has size of approx. 8 GB. These are the recommended minimum requirements to be able to run Ubuntu along with a Mininet network of 1-10 BMv2 devices controlled by 1 ONOS instance. For a flawless experience, we recommend running the VM on a host system that has at least the double of resources.

Use the following credentials to log in the Ubuntu system:

• Username: sdn
• Password: rocks

To work on the exercises you will need to clone this repo inside the VM:

cd ~
git clone https://github.com/opennetworkinglab/onos-p4-tutorial tutorial

If the tutorial directory is already present, make sure to update its content:

cd ~/tutorial
git pull origin master

ONOS uses SSH key-based authentication to access its command line interface (CLI). Before starting ONOS, generate public/private rsa key pair using the following command inside the VM:

ssh-keygen -t rsa -f ~/.ssh/id_rsa -P '' -q

The VM may have shipped with an older version of ONOS than we would like to use for the exercises. You can upgrade to the latest version used for the tutorial using the following command:

make onos-upgrade

During the exercises you will need to write code in multiple languages such as P4, Python and Java. While the exercises do not prescribe the use of any specific IDE or code editor, the tutorial VM comes with Java IDE IntelliJ IDEA Community Edition, already pre-loaded with plugins for P4 syntax highlighting and Python development. We suggest using IntelliJ IDEA especially when working on the ONOS app, as it provides code completion for all ONOS APIs.

This repo is structured as follows:

• p4src/ P4 implementation
• app/ ONOS app Java implementation
• mininet/ Mininet script to emulate a 2x2 leaf-spine fabric topology of stratum_bmv2 devices
• ptf/ PTF-based unit tests

To facilitate working on the exercises, we provide a set of make-based commands to control the different aspects of the tutorial. Commands will be introduced in the exercises, here's a quick reference:

Click on the exercise name to see the instructions:

1. Software tools basics and packet I/O
2. L2 bridging
3. IPv6 routing
4. Segment Routing v6

You can find solutions for each exercise in the solution directory. Feel free to compare your implementation to the reference one whenever you feel stuck. To use the solution code that is provided, simply use the same make commands in the solution directory.