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 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 machinetrouble 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


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.


Clone the Test-ON from TestON 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
git clone

Run the script:

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

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 :

Code Block
$ ./cli

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

Code Block
teston> help

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.