System Test Setup Overview

Created by: ; Last Modified by: ; Last Update: 

Components in this Setup:

• Jenkins CI system (Optional - if you need to have automated build job set up; else, all the test cases can be driven from TestStation.);
• Wiki (Atlassian Confluence), or other publishing services (Optional - if you don't need to publish test results);
• Gerrit Repo - gerrit.onosproject.org; this is the git repository for both onos and OnosSystemTest;
• TestStation - runs "OnosSystemTest/TestON"; optionally onos Bench and Mininet. Required: "OC" environment variables are configure in the host to run test scripts.
• ONOS cells - each cell is a node running ONOS - the number of cells needed depending on your test cases;
• SDN network - this is either a Mininet-emulated network, or physical network.

Example Test Setup Procedure:

This guide will help you install TestON, configure your environment, and run a sample test with a three node cluster.

Requirements: ONOS 1.3 or higher (recommended) must be correctly installed. Follow this guide to install ONOS.

Clone Mininet to TestStation and run the install script

$ git clone https://github.com/jhall11/mininet/tree/dynamic_topo
$ ~/mininet/util/install.sh -a

Clone "OnosSystemtest" to TestStation 

$ git clone https://gerrit.onosproject.org/OnosSystemTest

Set your cell. The sample test requires a 3-node cell. Follow this guide if you are having trouble setting your cell.

$ cell <cell name>

NOTE: Make sure ONOS is update-to-date and you build it before running the test.

Run the sample test.

$ cd ~/OnosSystemTest/TestON/bin/
$ ./cli.py run SAMPstartTemplate