Page tree

Versions Compared


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

Welcome to TestON tutorial!


Test on TestON runs on Linux platform. 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 TestON.
  • Create appropriate files to run test on TestON.
  • Create and run TestON script.
  • Create a TestON driver.

NOTE: If you are having trouble  on trouble running TestON, visit TestON FAQs or git hub wiki for additional information.

Important Command Prompt Notes

In this tutorial, commands are shown along with a command prompt to indicate the subsystem for which they are intended.

For example,

Code Block

indicates that you are in the TestON command line, whereas

Code Block

indicates that you are in your machine, or email us if you're stuck.

Configuring Linux to run TestON


  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

Please configure mail server details before going to start working with TestON


Run the script:

Code Block
233: msg['From'] = '' 
250: smtp = smtplib.SMTP('Hostname/IP') 
252: smtp.login('','password') cd OnosSystemTest/TestON/

Having installation problem? visit TestON FAQ for more information.

Running TestON

Please take a look at the Test Files section of the tutorial to know more about the files necessary to run the test. If you have any problem please visit TestON FAQs for more information.

In the /TestON/bin folder run the :




You can execute help command for the to show the list of command in TestON :


Running the test on TestON:

Code Block
teston> run PingallExample

or simply run your test when you execute

Code Block
$ ./ run PingallExample

NOTE: Every time you run your test make sure you disconnect Mininet entirely by doing "sudo mn -c" command.

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 us if you’re stuck, think you’ve found a bug, or just want to send some feedback. Please have a look at the guidelines to learn how to efficiently submit a bug report.