Welcome to Test-ON tutorial!
Test on runs on Linux platform. Test-ON requires a proper ONOS installation in order to work, see ONOS tutorial for more information.
By completing this tutorial, you will understand how to:
NOTE: If you are having trouble on running Test-ON visit Test-ON FAQs or git hub wiki for additional information.
python 2.6 or higher versions.
Install python package configObj using:
$ sudo pip install configObj
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 https://github.com/OPENNETWORKINGLAB/ONLabTest.git
Please configure mail server details before going to start working with Test-ON
233: msg['From'] = 'firstname.lastname@example.org' 250: smtp = smtplib.SMTP('Hostname/IP') 252: smtp.login('email@example.com','password')
You can see test files in the /TestON/tests/ folder. The name of the test folder should be the name of the test as well as all the files .Each of the tests has a unique set of 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, drivers, and/or Mininet's topology would be specified in this file. ( Please use the exact syntax/format in the topo file. The space character in the xml tags is important even though you are not defining anything in the tag Eg. <COMPONENTS> </COMPONENTS>)
.py - This is where all of the test cases are written. It calls upon functions implemented in the respective drivers to create a progression of events that produces some sort of pass/fail outcome.
This test uses pingall function to ping all the host in the network. The test is successful if all the hosts are reachable.
Below is the PingallExample.params file:
<PARAMS> <testcases>1,2,3</testcases> <ENV> <cellName>HA</cellName> </ENV> <Git>True</Git> <CTRL> <ip1>10.128.30.11</ip1> <port1>6633</port1> </CTRL> </PARAMS>
The <testcases> tag defines the order in which the test cases in the .py file are executed. The <cellName> is the name of the cell when setting up your environment.
Below is the PingallExample.topo file:
<TOPOLOGY> <COMPONENT> <ONOSbench> <host>10.128.30.10</host> <user>admin</user> <password> </password> <type>OnosDriver</type> <connect_order>1</connect_order> <COMPONENTS> </COMPONENTS> </ONOSbench> <ONOScli1> <host>10.128.30.10</host> <user>admin</user> <password> </password> <type>OnosCliDriver</type> <connect_order>2</connect_order> <COMPONENTS> </COMPONENTS> </ONOScli1> <ONOS1> <host>10.128.30.11</host> <user>sdn</user> <password>rocks</password> <type>OnosDriver</type> <connect_order>3</connect_order> <COMPONENTS> </COMPONENTS> </ONOS1> <Mininet1> <host>10.128.30.9</host> <user>admin</user> <password> </password> <type>MininetCliDriver</type> <connect_order>4</connect_order> <COMPONENTS> #Specify the Option for mininet <arg1> --topo=tree,3,3 </arg1> <arg2> </arg2> <arg3> </arg3> <controller> remote </controller> </COMPONENTS> </Mininet1> </COMPONENT> </TOPOLOGY>
The .topo file includes the log in info of the machine that the ONOS and Mininet will be run. In this example, the test runs using two VM machine with host name user name and password defined for each of the component. The <connect_order> tag is the connection order that the testON will execute. The formatting of the .topo file must be followed correctly. The space character inside every empty tag indicates that a blank information will be passed along in the component otherwise the test would give an error , if that space character isn't there, and would stop the test. The <args> tag in the MIninet component is necessary and should be kept even though have empty arguments.
NOTE: It is important to check the log in info carefully for each component as incorrect information would result to test failure.