mirror of
				https://github.com/Telecominfraproject/wlan-lanforge-scripts.git
				synced 2025-10-31 18:58:01 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			372 lines
		
	
	
		
			16 KiB
		
	
	
	
		
			Python
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			372 lines
		
	
	
		
			16 KiB
		
	
	
	
		
			Python
		
	
	
		
			Executable File
		
	
	
	
	
| #!/usr/bin/env python3
 | |
| """
 | |
| NAME: test_l4.py
 | |
| 
 | |
| PURPOSE:
 | |
| test_l4.py will create stations and endpoints to generate and verify layer-4 traffic
 | |
| 
 | |
| This script will monitor the urls/s, bytes-rd, or bytes-wr attribute of the endpoints.
 | |
| These attributes can be tested over FTP using a --ftp flag.
 | |
| If the the monitored value does not continually increase, this test will not pass.
 | |
| 
 | |
| This script replaces the functionality of test_ipv4_l4.py, test_ipv4_l4_ftp_upload.py, test_ipv4_l4_ftp_urls_per_ten.py,
 | |
| test_ipv4_l4_ftp_wifi.py, test_ipv4_l4_urls_per_ten.py, test_ipv4_l4_urls_per_ten.py, test_ipv4_l4_wifi.py
 | |
| 
 | |
| EXAMPLE (urls/s):
 | |
|     ./test_l4.py --upstream_port eth1 --radio wiphy0 --num_stations 3 --security {open|wep|wpa|wpa2|wpa3}
 | |
|                  --ssid netgear --passwd admin123 --requests_per_ten 600 --mode   1 --num_tests 1 --test_type 'urls'
 | |
|                  --url "dl http://10.40.0.1 /dev/null" --ap "00:0e:8e:78:e1:76" --target_per_ten 600 --output_format csv
 | |
|                  --report_file ~/Documents/results.csv --test_duration 2m --debug
 | |
| 
 | |
| EXAMPLE (bytes-wr):
 | |
|     ./test_l4.py --upstream_port eth1 --radio wiphy0 --num_stations 3 --security {open|wep|wpa|wpa2|wpa3}
 | |
|                  --ssid netgear --passwd admin123 --test_duration 2m --url "ul http://10.40.0.1 /dev/null"
 | |
|                  --requests_per_ten 600 --test_type bytes-wr --debug
 | |
| 
 | |
| EXAMPLE (bytes-rd):
 | |
|     ./test_l4.py --upstream_port eth1 (optional) --radio wiphy0  (required) --num_stations 3 (optional)
 | |
|                  --security {open|wep|wpa|wpa2|wpa3} (required) --ssid netgear (required)
 | |
|                  --url "dl http://10.40.0.1 /dev/null" (required) --password admin123 (required)
 | |
|                  --test_duration 2m (optional) --test_type bytes-rd --debug (optional)
 | |
| 
 | |
| EXAMPLE (ftp urls/s):
 | |
|     ./test_l4.py --upstream_port eth1 --radio wiphy0 --num_stations 3 --security {open|wep|wpa|wpa2|wpa3}
 | |
|                  --ssid netgear --passwd admin123 --test_duration 2m --interval 1s --mode 1 --ap "00:0e:8e:78:e1:76"
 | |
|                  --requests_per_ten 600 --num_tests 1 --ftp --test_type 'urls'
 | |
|                  --url "ul ftp://lanforge:lanforge@10.40.0.1/example.txt  /home/lanforge/example.txt" --debug
 | |
| 
 | |
| EXAMPLE (ftp bytes-wr):
 | |
|     ./test_l4.py --upstream_port eth1 --radio wiphy0 --num_stations 3 --security {open|wep|wpa|wpa2|wpa3}
 | |
|                  --ssid netgear --passwd admin123 --test_duration 2m --url "ul ftp://10.40.0.1 /dev/null"
 | |
|                  --requests_per_ten 600 --ftp --test_type bytes-wr --debug
 | |
| 
 | |
| EXAMPLE (ftp bytes-rd):
 | |
|     ./test_l4.py --upstream_port eth1 (optional) --radio wiphy0  (required) --num_stations 3 (optional)
 | |
|                  --security {open|wep|wpa|wpa2|wpa3} (required) --ssid netgear (required)
 | |
|                  --url "dl ftp://10.40.0.1 /dev/null" (required) --password admin123 (required)
 | |
|                  --test_duration 2m (optional) --ftp --test_type bytes-rd --debug (optional)
 | |
| 
 | |
| Use './test_l4.py --help' to see command line usage and options
 | |
| Copyright 2021 Candela Technologies Inc
 | |
| License: Free to distribute and modify. LANforge systems must be licensed.
 | |
| """
 | |
| import sys
 | |
| import os
 | |
| import importlib
 | |
| import time
 | |
| import argparse
 | |
| import datetime
 | |
| 
 | |
| if sys.version_info[0] != 3:
 | |
|     print("This script requires Python 3")
 | |
|     exit(1)
 | |
| 
 | |
| sys.path.append(os.path.join(os.path.abspath(__file__ + "../../../")))
 | |
| 
 | |
| lfcli_base = importlib.import_module("py-json.LANforge.lfcli_base")
 | |
| LFCliBase = lfcli_base.LFCliBase
 | |
| LFUtils = importlib.import_module("py-json.LANforge.LFUtils")
 | |
| realm = importlib.import_module("py-json.realm")
 | |
| Realm = realm.Realm
 | |
| TestGroupProfile = realm.TestGroupProfile
 | |
| port_utils = importlib.import_module("py-json.port_utils")
 | |
| PortUtils = port_utils.PortUtils
 | |
| 
 | |
| 
 | |
| class IPV4L4(LFCliBase):
 | |
|     def __init__(self,
 | |
|                  host="localhost",
 | |
|                  port=8080,
 | |
|                  ssid=None,
 | |
|                  security=None,
 | |
|                  password=None,
 | |
|                  url=None,
 | |
|                  ftp_user=None,
 | |
|                  ftp_passwd=None,
 | |
|                  requests_per_ten=None,
 | |
|                  station_list=None,
 | |
|                  test_duration="2m",
 | |
|                  ap=None,
 | |
|                  mode=0,
 | |
|                  target_requests_per_ten=60,
 | |
|                  number_template="00000",
 | |
|                  num_tests=1,
 | |
|                  radio="wiphy0",
 | |
|                  _debug_on=False,
 | |
|                  upstream_port="eth1",
 | |
|                  ftp=False,
 | |
|                  source=None,
 | |
|                  dest=None,
 | |
|                  test_type=None,
 | |
|                  _exit_on_error=False,
 | |
|                  _exit_on_fail=False):
 | |
|         super().__init__(host, port, _debug=_debug_on, _exit_on_fail=_exit_on_fail)
 | |
| 
 | |
|         self.host = host
 | |
|         self.port = port
 | |
|         self.radio = radio
 | |
|         self.upstream_port = upstream_port
 | |
|         self.ssid = ssid
 | |
|         self.security = security
 | |
|         self.password = password
 | |
|         self.url = url
 | |
|         self.mode = mode
 | |
|         self.ap = ap
 | |
|         self.debug = _debug_on
 | |
|         self.requests_per_ten = int(requests_per_ten)
 | |
|         self.number_template = number_template
 | |
|         self.test_duration = test_duration
 | |
|         self.sta_list = station_list
 | |
|         self.num_tests = int(num_tests)
 | |
|         self.target_requests_per_ten = int(target_requests_per_ten)
 | |
| 
 | |
|         self.local_realm = realm.Realm(lfclient_host=self.host, lfclient_port=self.port)
 | |
|         self.station_profile = self.local_realm.new_station_profile()
 | |
|         self.cx_profile = self.local_realm.new_l4_cx_profile()
 | |
| 
 | |
|         self.port_util = PortUtils(self.local_realm)
 | |
| 
 | |
|         self.station_profile.lfclient_url = self.lfclient_url
 | |
|         self.station_profile.ssid = self.ssid
 | |
|         self.station_profile.ssid_pass = self.password
 | |
|         self.station_profile.security = self.security
 | |
|         self.station_profile.number_template_ = self.number_template
 | |
|         self.station_profile.mode = self.mode
 | |
|         self.test_type = test_type
 | |
|         self.ftp_user = ftp_user
 | |
|         self.ftp_passwd = ftp_passwd
 | |
|         self.source = source
 | |
|         self.dest = dest
 | |
|         if self.ap is not None:
 | |
|             self.station_profile.set_command_param("add_sta", "ap", self.ap)
 | |
| 
 | |
|         self.cx_profile.url = self.url
 | |
|         self.cx_profile.test_type = self.test_type
 | |
|         self.cx_profile.requests_per_ten = self.requests_per_ten
 | |
|         self.cx_profile.target_requests_per_ten = self.target_requests_per_ten
 | |
| 
 | |
|         self.ftp = ftp
 | |
|         if self.ftp and 'ftp://' not in self.url:
 | |
|             print("WARNING! FTP test chosen, but ftp:// not present in url!")
 | |
| 
 | |
|         test_types = {'urls', 'bytes-wr', 'bytes-rd'}
 | |
|         if self.test_type not in test_types:
 | |
|             raise ValueError(
 | |
|                 "Unknown test type: %s\nValid test types are urls, bytes-rd, or bytes-wr" % self.test_type)
 | |
| 
 | |
|     def build(self):
 | |
|         # Build stations
 | |
|         self.station_profile.use_security(self.security, self.ssid, self.password)
 | |
|         print("Creating stations")
 | |
|         self.station_profile.set_command_flag("add_sta", "create_admin_down", 1)
 | |
|         self.station_profile.set_command_param("set_port", "report_timer", 1500)
 | |
|         self.station_profile.set_command_flag("set_port", "rpt_timer", 1)
 | |
|         self.station_profile.create(radio=self.radio, sta_names_=self.sta_list, debug=self.debug)
 | |
|         self._pass("PASS: Station build finished")
 | |
| 
 | |
|         temp_url = self.url.split(" ")
 | |
|         if temp_url[0] == 'ul' or temp_url[0] == 'dl':
 | |
|             if len(temp_url) == 2:
 | |
|                 if self.url.startswith("ul") and self.source not in self.url:
 | |
|                     self.cx_profile.url += " " + self.source
 | |
|                 elif self.url.startswith("dl") and self.dest not in self.url:
 | |
|                     self.cx_profile.url += " " + self.dest
 | |
|         else:
 | |
|             raise ValueError("ul or dl required in url to indicate direction")
 | |
|         if self.ftp:
 | |
|             if self.ftp_user is not None and self.ftp_passwd is not None:
 | |
|                 if ("%s:%s" % (self.ftp_user, self.ftp_passwd)) not in self.url:
 | |
|                     temp_url = self.url.split("//")
 | |
|                     temp_url = ("//%s:%s@" % (self.ftp_user, self.ftp_passwd)).join(temp_url)
 | |
|                     self.cx_profile.url = temp_url
 | |
|             self.cx_profile.create(ports=self.station_profile.station_names, sleep_time=.5, debug_=self.debug,
 | |
|                                    suppress_related_commands_=True)
 | |
|         else:
 | |
|             self.cx_profile.create(ports=self.station_profile.station_names, sleep_time=.5, debug_=self.debug,
 | |
|                                    suppress_related_commands_=None)
 | |
| 
 | |
|     def start(self, print_pass=False, print_fail=False):
 | |
|         if self.ftp:
 | |
|             self.port_util.set_ftp(port_name=self.local_realm.name_to_eid(self.upstream_port)[2], resource=1, on=True)
 | |
|         temp_stas = self.sta_list.copy()
 | |
| 
 | |
|         self.station_profile.admin_up()
 | |
|         if self.local_realm.wait_for_ip(temp_stas):
 | |
|             self._pass("All stations got IPs", print_pass)
 | |
|         else:
 | |
|             self._fail("Stations failed to get IPs", print_fail)
 | |
|             exit(1)
 | |
| 
 | |
|         self.cx_profile.start_cx()
 | |
|         print("Starting test")
 | |
| 
 | |
|     def stop(self):
 | |
|         self.cx_profile.stop_cx()
 | |
|         if self.ftp:
 | |
|             self.port_util.set_ftp(port_name=self.local_realm.name_to_eid(self.upstream_port)[2], resource=1, on=False)
 | |
|         self.station_profile.admin_down()
 | |
| 
 | |
|     def cleanup(self, sta_list):
 | |
|         self.cx_profile.cleanup()
 | |
|         self.station_profile.cleanup(sta_list)
 | |
|         LFUtils.wait_until_ports_disappear(base_url=self.lfclient_url, port_list=sta_list,
 | |
|                                            debug=self.debug)
 | |
| 
 | |
| 
 | |
| def main():
 | |
|     parser = LFCliBase.create_basic_argparse(
 | |
|         prog='test_l4',
 | |
|         formatter_class=argparse.RawTextHelpFormatter,
 | |
|         epilog='''\
 | |
|                This script will monitor the urls/s, bytes-rd, or bytes-wr attribute of the endpoints.
 | |
|                ''',
 | |
|         description='''\
 | |
|     test_l4.py:
 | |
| --------------------
 | |
| Generic command example:
 | |
| python3 ./test_l4.py 
 | |
|     --upstream_port eth1 \\
 | |
|     --radio wiphy0 \\
 | |
|     --num_stations 3 \\
 | |
|     --security {open|wep|wpa|wpa2|wpa3} \\
 | |
|     --ssid netgear \\
 | |
|     --passwd admin123 \\
 | |
|     --requests_per_ten 600 \\
 | |
|     --mode   1      
 | |
|                 {"auto"   : "0",
 | |
|                 "a"      : "1",
 | |
|                 "b"      : "2",
 | |
|                 "g"      : "3",
 | |
|                 "abg"    : "4",
 | |
|                 "abgn"   : "5",
 | |
|                 "bgn"    : "6",
 | |
|                 "bg"     : "7",
 | |
|                 "abgnAC" : "8",
 | |
|                 "anAC"   : "9",
 | |
|                 "an"     : "10",
 | |
|                 "bgnAC"  : "11",
 | |
|                 "abgnAX" : "12",
 | |
|                 "bgnAX"  : "13"} \\
 | |
|     --num_tests 1 \\
 | |
|     --url "dl http://10.40.0.1 /dev/null" \\
 | |
|     --ap "00:0e:8e:78:e1:76"
 | |
|     --target_per_ten 600 \\
 | |
|     --output_format csv \\
 | |
|     --report_file ~/Documents/results.csv \\
 | |
|     --test_duration 2m \\
 | |
|     --debug
 | |
|             ''')
 | |
|     parser.add_argument('--requests_per_ten', help='--requests_per_ten number of request per ten minutes',
 | |
|                         default=600)
 | |
|     parser.add_argument('--num_tests', help='--num_tests number of tests to run. Each test runs 10 minutes',
 | |
|                         default=1)
 | |
|     parser.add_argument('--url', help='--url specifies upload/download, address, and dest',
 | |
|                         default="dl http://10.40.0.1 /dev/null")
 | |
|     parser.add_argument('--test_duration', help='duration of test', default="2m")
 | |
|     parser.add_argument('--target_per_ten',
 | |
|                         help='--target_per_ten target number of request per ten minutes. test will check for 90 percent this value',
 | |
|                         default=600)
 | |
|     parser.add_argument('--mode', help='Used to force mode of stations')
 | |
|     parser.add_argument('--ap', help='Used to force a connection to a particular AP')
 | |
|     parser.add_argument('--report_file', help='where you want to store results')
 | |
|     parser.add_argument('--output_format', help='choose csv or xlsx')  # update once other forms are completed
 | |
|     parser.add_argument('--ftp', help='Use ftp for the test', action='store_true')
 | |
|     parser.add_argument('--test_type', help='Choose type of test to run {urls, bytes-rd, bytes-wr}',
 | |
|                         default='bytes-rd')
 | |
|     parser.add_argument('--ftp_user', help='--ftp_user sets the username to be used for ftp', default=None)
 | |
|     parser.add_argument('--ftp_passwd', help='--ftp_user sets the password to be used for ftp', default=None)
 | |
|     parser.add_argument('--dest',
 | |
|                         help='--dest specifies the destination for the file, should be used when downloading',
 | |
|                         default="/dev/null")
 | |
|     parser.add_argument('--source',
 | |
|                         help='--source specifies the source of the file, should be used when uploading',
 | |
|                         default="/var/www/html/data_slug_4K.bin")
 | |
| 
 | |
|     args = parser.parse_args()
 | |
| 
 | |
|     num_sta = 2
 | |
|     if (args.num_stations is not None) and (int(args.num_stations) > 0):
 | |
|         num_stations_converted = int(args.num_stations)
 | |
|         num_sta = num_stations_converted
 | |
|     if args.report_file is None:
 | |
|         if args.output_format in ['csv', 'json', 'html', 'hdf', 'stata', 'pickle', 'pdf', 'parquet', 'png', 'df',
 | |
|                                   'xlsx']:
 | |
|             output_form = args.output_format.lower()
 | |
|         else:
 | |
|             print("Defaulting data file output type to Excel")
 | |
|             output_form = 'xlsx'
 | |
| 
 | |
|     else:
 | |
|         if args.output_format is None:
 | |
|             output_form = str(args.report_file).split('.')[-1]
 | |
|         else:
 | |
|             output_form = args.output_format
 | |
| 
 | |
|             # Create directory
 | |
|     if args.report_file is None:
 | |
|         if os.path.isdir('/home/lanforge/report-data'):
 | |
|             homedir = str(datetime.datetime.now().strftime("%Y-%m-%d-%H-%M")).replace(':', '-') + 'test_l4'
 | |
|             path = os.path.join('/home/lanforge/report-data/', homedir)
 | |
|             os.mkdir(path)
 | |
|         else:
 | |
|             path = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 | |
|             print('Saving file to local directory')
 | |
|         if args.output_format in ['csv', 'json', 'html', 'hdf', 'stata', 'pickle', 'pdf', 'png', 'df', 'parquet',
 | |
|                                   'xlsx']:
 | |
|             rpt_file = path + '/data.' + args.output_format
 | |
|         else:
 | |
|             print('Defaulting data file output type to Excel')
 | |
|             rpt_file = path + '/data.xlsx'
 | |
|     else:
 | |
|         rpt_file = args.report_file
 | |
| 
 | |
|     station_list = LFUtils.portNameSeries(prefix_="sta", start_id_=0, end_id_=num_sta - 1, padding_number_=10000,
 | |
|                                           radio=args.radio)
 | |
| 
 | |
|     ip_test = IPV4L4(host=args.mgr, port=args.mgr_port,
 | |
|                      ssid=args.ssid,
 | |
|                      password=args.passwd,
 | |
|                      radio=args.radio,
 | |
|                      upstream_port=args.upstream_port,
 | |
|                      security=args.security,
 | |
|                      station_list=station_list,
 | |
|                      url=args.url,
 | |
|                      mode=args.mode,
 | |
|                      ap=args.ap,
 | |
|                      ftp=args.ftp,
 | |
|                      ftp_user=args.ftp_user,
 | |
|                      ftp_passwd=args.ftp_passwd,
 | |
|                      source=args.source,
 | |
|                      dest=args.dest,
 | |
|                      test_type=args.test_type,
 | |
|                      _debug_on=args.debug,
 | |
|                      test_duration=args.test_duration,
 | |
|                      num_tests=args.num_tests,
 | |
|                      target_requests_per_ten=args.target_per_ten,
 | |
|                      requests_per_ten=args.requests_per_ten)
 | |
|     ip_test.cleanup(station_list)
 | |
|     ip_test.build()
 | |
|     ip_test.start()
 | |
| 
 | |
|     layer4traffic = ','.join([[*x.keys()][0] for x in ip_test.local_realm.json_get('layer4')['endpoint']])
 | |
|     ip_test.cx_profile.monitor(col_names=['name', 'bytes-rd', 'urls/s', 'bytes-wr'],
 | |
|                                report_file=rpt_file,
 | |
|                                duration_sec=ip_test.local_realm.parse_time(args.test_duration).total_seconds(),
 | |
|                                created_cx=layer4traffic,
 | |
|                                output_format=output_form,
 | |
|                                script_name='test_l4',
 | |
|                                arguments=args,
 | |
|                                debug=args.debug)
 | |
|     ip_test.stop()
 | |
|     if not ip_test.passes():
 | |
|         print(ip_test.get_fail_message())
 | |
|         exit(1)
 | |
|     time.sleep(30)
 | |
|     ip_test.cleanup(station_list)
 | |
|     if ip_test.passes():
 | |
|         print("Full test passed")
 | |
| 
 | |
| 
 | |
| if __name__ == "__main__":
 | |
|     main()
 | 
