Welcome to TestON tutorial!
Overview
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 |
---|
teston> |
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
...
- A Linux 2.6.26 or greater kernel compiled with network namespace support enabled (see INSTALL for additional information.)
python Python 2.6 or higher versions.
Install python package configObj using:
Code Block |
---|
$ sudo pip install configObj |
Prerequisites:
- Properly installed ONOS.
- Dependencies - ONOS, Python packages, Pox, Mininet, STS, etc. (Check out the Dependencies section in the Github wiki for more information)
- Prior knowledge of ONOS and Mininet
- Two or more VMs running Ubuntu Server
- Ssh log in without password
Stuck? Found a bug? Questions?
...
Installation
Clone the TestON from https://githubgerrit.onosproject.com/opennetworkinglab/ONLabTest.gitorg/OnosSystemTest:
Code Block |
---|
git clone https://github.com/opennetworkinglab/ONLabTest.git |
Please configure mail server details before going to start working with TestON
...
gerrit.onosproject.org/OnosSystemTest |
Run the install.sh script:
Code Block |
---|
233: msg['From'] = 'user@mailserver.com' 250: smtp = smtplib.SMTP('Hostname/IP') 252: smtp.login('user@mailserver.com','password') cd OnosSystemTest/TestON/ ./install.sh |
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 cli.py :
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 cli.py:
Code Block |
---|
$ ./cli.py 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.