Page tree

Versions Compared


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

Welcome to Test-ON TestON tutorial!


Test on TestON runs on Linux platform. Test-ON TestON requires a proper ONOS installation in order to work, see ONOS tutorialTutorial for more information.

By completing this tutorial, you will understand how to:

  • Install Test-ONTestON.
  • Create appropriate files to run test on Test-ONTestON.
  • Create and run Test-ON TestON script.
  • Create a Test-ON TestON driver.

NOTE: If you are having trouble  on running Test-ON visit Test-ON FAQs or visit git hub wiki for additional informationtrouble running TestON, visit TestON FAQs for additional information, or email us if you're stuck.

Configuring Linux to run




  1. A Linux 2.6.26 or greater kernel compiled with network namespace support enabled (see INSTALL for additional information.)
  2. python Python 2.6 or higher versions.

Install python package configObj using:

Code Block
$ sudo pip install configObj



Clone the TestON from 

Code Block
git clone

Run the script:

Code Block
cd OnosSystemTest/TestON/

Having installation problem? visit TestON FAQ for more information.

Exploring further

Now that you finish installing TestON, you can now create your test cases. Find out how you can create your own tests in test files section of the tutorial.

Stuck? Found a bug? Questions?

Email Email us if if you’re stuck, think you’ve found a bug, or just want to send some feedback. Please have a look at the the guidelines to to learn how to efficiently submit a bug report.


Clone the Test-ON from

Please configure mail server details before going to start working with Test-ON

  • Open core/ file inside Test-ON Framework
  • Check def send_mail(self) and configure the mail server and your credentials as mention below:
Code Block
233:   msg['From'] = ''
250:   smtp = smtplib.SMTP('Hostname/IP')
252:   smtp.login('','password')

Test files

You can see actual test files in the /TestON/tests/ folder. Each of the tests has unique files defined below:

Params - This file contains user defined variables for the test case. Also specify the order of which test cases to run.

Topo - This file defines all the components and options that Test-ON will use to execute its test. The machine's user name, password, IP addresses and/or Mininet's topology would be specified in this file.

py -