Welcome to TestON tutorial!
Overview
Test on runs on Linux platform. TestON requires a proper ONOS installation in order to work, see ONOS tutorial 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 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,
teston>
indicates that you are in the TestON command line, whereas
$
indicates that you are in your machine.
Configuring Linux to run TestON
Requirements:
- A Linux 2.6.26 or greater kernel compiled with network namespace support enabled (see INSTALL for additional information.)
python 2.6 or higher versions.
Install python package configObj using:
$ 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?
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.
Installation
Clone the TestON from https://github.com/OPENNETWORKINGLAB/ONLabTest.git
git clone https://github.com/opennetworkinglab/ONLabTest.git
Please configure mail server details before going to start working with TestON
- Open core/utilities.py file inside TestON Framework
- Check def send_mail(self) and configure the mail server and your credentials as mention below:
233: msg['From'] = 'user@mailserver.com' 250: smtp = smtplib.SMTP('Hostname/IP') 252: smtp.login('user@mailserver.com','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 cli.py :
$ ./cli
You can execute help command for the to show the list of command in TestON :
teston> help
Running the test on TestON:
teston> run PingallExample
or simply run your test when you execute cli.py:
$ ./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.