Hands-onLabsusingtheWLANProsODROIDPerformanceTestingDeviceThegoalistoprovideWirelessLANProfessionalswithaready-to-usecustomdevicetohelpprovidethroughputmeasurementsfornetworkperformance.ItcanbeusedtotestWired-to-Wired,Wired-to-Wireless,andevenWireless-to-Wirelesstests.Thesetestscanassistinestablishingbaselines,helpintroubleshooting,testconsistency,aswellasmeasuringnetworkthroughputfromknownendpoints.WhyODROID?TheODROIDC-2devicehasmuchincommonwithotherSingle-Board-Computers,likeRaspberryPiandothers.WechosethisplatformforitsversatilitybutmainlybecauseitoffersafullGigabitEthernetport,sothatcomponentshouldnoteverbeabottleneckorbeathrottletonetworkthroughputtesting.(unliketheRaspberryPi’s10/100Ethernetport).

• ThespecsontheODROIDare:• 1.5GHz64-bitquad-coresingleboardcomputer(SBC)• GigabitEthernet• eMMCFlashStorage–bootsinunder20-seconds• Lowpowerconsumption–around1amp–wepowerwithstandardUSBbattery• VeryVersatile• AbilitytouseBluetoothorUSBkeyboard/mice• HDMIoutcapability• Weuseanattachedscreentodomuchofwhatweneed• Canbeusedina‘headless’environment

LinuxPerformanceTestingAppsWeareusingDebianLinuxwiththefollowingservicesrunninguponbootupsotheyarealwaysready:Application Version PortIperf3 3.16 5202Iperf2 2.0.9 5001RuckusZAP 1.83 Ekahaueperf 3.x 5201HTML5Tests 6versions

onDifferentURLs80

ClientApplications(seeotherinstructionsonhowtoinstallalltheseclient-sidetestingapps)Application Version MacOS Windows Android iOSIperf3 3.1.6 X X Iperf2 2.0.9 X X ZAP 1.83 X X EkahauESS X X WiFiPerf(Demo) 1.9 X X X XRuckusSpeedflex 2.0.7 X XHurricaneElectric 1.5.0.289 X XArubaUtilities XNote:Allthefilesforclient-sideapplicationsareprovidedeitherontheincludedUSBdriveorviaInternetwhiledoingautomaticinstallations.

ItisrecommendedyoudotheClientinstallsbeforestartingontheODROIDperformancetesting.Theinstallationinstructionsareintheappendixattheendofthisdocument.

PoweringOn/OffYourODROIDTheinstalledUSBBatteryfromKORALcanbeturnedonwiththepowerbuttononthesideofthebattery.Alternatively–theODROIDcanbepoweredwithany5v/2apowersource.PoweringOfftheKORALbatterybypressingthepowerbuttonTWICE!Connectyourclientdevicestoeitherthe2.4GHzor5GHzSSID’s.NotewhatIPaddresseseachreceivedviaWIRELESSconnection.• MacOS ___.____.____.____• WindowsOS ___.____.____.____• Android ___.____.____.____• iOS ___.____.____.____

PlugyourODROIDintoawiredport.NotewhatIPaddressitreceived.• ODROID ___.____.____.____

LoginandconfigureyourODROID

• SSHtotheODROIDusinganSSHClient• OpenTerminal(MacOS)orPutty(Windows)

$ SSH root@A.A.A.A Defaultpassword=wlanpro

Changerootpassword:# passwd

YoushouldnowhavearemotesessiontoyourODROIDviaSSH.

PerformanceTestingwiththeODROIDdeviceTask1–BasicPerformanceTestusingiPerfExecuteaniPerftestwithiPerf2$ iperf –c A.A.A.A

ExecuteaniPerf3test$ iperf3 –c A.A.A.A –p 5202

-CspecifiesclientmodeA.A.A.AistheODROIDIPaddress-pspecifiestheporttouse

Task2–TestConsistencyusingZAPtoolUsingtheRuckusZAPtooltomeasuretheconsistencyandthroughputofanetworkconnection.

• Startzapd(daemon)

Note:ThestartingoftheZAPdaemonontheODROIDisbydefaultatstartup–thisistheZAPDaemonontheclientside.WewillberunningtheseZAPtestsfromtheclient’sperspective.Openadifferentterminal(MacOS)orCommandPrompt(Windows)wherewecancontroltheODROID.RunZAPtesttoODROID$ zap –sA.A.A.A –dB.B.B.B -sspecifiesthesourceIPA.A.A.AistheODROIDIPAddress-dspecifiesthedestinationIPB.B.B.Bisyourtestdevice’sIPAddressNote:DoNOTputaspaceafterthe–sor–d

Note:Thiswillrunalongtime…bydefaultitwillrun1,000uniquethroughputtests.Theresultsshownotonlyaverage,butbreakdowntheresultsbypercentile.

Task3–NetworkPerformanceGraphusingWiFiPerf

• StartWiFiPerf(MacOS)• ConfigureWiFiPerfsettings

TargetServerAddress:A.A.A.AServerPort:5202

• RunTest

A.A.A.AistheODROID’sIPaddress

ThistoolisalsousingtheZAPapplicationandshowingavisualresultofthestatistics.Task4–MobilePerformanceTestingusingSpeedflex

• StartSpeedFlexapponiOSorAndroid• ConfigureSpeedFlexsettings

DestinationAddress:A.A.A.A

• RunTestA.A.A.AistheODROID’sIPaddress

Task5–MobilePerformanceTestingusingHurricaneElectricNetworkUtilitiesiPerf2andiPerf3UseH/ENetworkToolstoperformaniperf2/3measurementfromiOS

• StartH/ENetworkTools• Selectiperffromthelistoftools• ConfigureiPerfsettings

Select:iperf2iperfServer:A.A.A.AInterval: 2Bytes: 500M

4.SelectfieldattopwithaddressandclickGo

Note:Justclickinthefieldwiththeserveraddressthenclickenter

*Touseiperf3,selectiperf3andspecifyport5202Example:A.A.A.A-p5202

Task6–MobilePerformanceTestingusingArubaNetworkUtilitiesUseArubaUtilitiestorunaniPerftestfromanAndroiddevice

• StartArubaUtilities(Android)• SwipetothelefttoselectiPerfpage(Perhapsevenmultipleswipes)• ConfigureiPerfsettings

-cA.A.A.A-i2-t10-cconnecttoaniPerfserveratspecifiedIP-isetsthereportingintervaltimeinseconds-ttimeinsecondstoruntestfor

• Run

Task7-Remotetestbetween2devicesUseZaptoremotelymeasurethenetworkperformancebetweentwodevices.

• StartZapdorRuckusSpeedFlexonanytwodevicesExample:iPhonerunningSpeedFlexandOdroidrunningzapd

• RunaremotezaptestfromWindowsorMac

$ zap -sA.A.A.A -dB.B.B.B -sspecifiessourceIPA.A.A.A=IPofDevice1-dspecifiesdestinationIPB.B.B.B=IPofDevice2*donotputaspaceafter-sor-d

Task8–WebBrowserSpeedTestsInthistest,wewillbeusingHTML5codeontheODROID–thereisonespecificsetofcodeforthedefaultonport80…buttogetadditionaltests–oneofwhichyoumightpreferforeaseofuse,readability,etc.We’veadded6moreversionsforyoutochoosefrom.JusttypeintheappropriateURL.

• StartaBrowserofchoice• HeadovertoA.A.A.A-yourODROID’sIPAddress• Makechoicesonthecheck-boxestowhatyou’dliketoview• ClickStart

Foradditionaltests–addoneoftheseoptionstotheend,likeA.A.A.A/exampleX.html

TurnyourODROIDintoaWirelessAccessPoint

• InserttheenclosedUSBWi-FiAdapter• ConfigureyourAccessPointsettingsbyeditingtheAPconfigfile:/boot/ap.txtfromanSSH

sessiontotheODROID• SSHtotheODROIDusinganSSHClient• OpenTerminal(MacOS)orPutty(Windows)

$ SSH root@A.A.A.A Defaultpassword=wlanpro

• #nano /boot/ap.txt

• ModifythefollowingsettingsfromtheWLANProsimage:SSID WLAN_PRO wpa_passphrase changeme channel 36

• PressButton3ontheODROIDtostart/stoptheAccessPoint• Turnontheaccesspoint,andthenassociatewithyourclient.CheckyourIPaddress.• ConnectyourclientdevicestotheSSID’sprovidedbytheODROIDAccessPoint.

NotewhatIPaddresseseachreceived.• MacOS ___.____.____.____• WindowsOS ___.____.____.____• Android ___.____.____.____• iOS ___.____.____.____

• ConnecttotheODROIDviaSSHlikeabove,orrunanyofthethroughputtests.Inthiscase

you’llbetestingtheWi-FiUSBdevice’scapabilities…Bydefaultitshouldbehandingout192.168.42.xxxIP’sfromtheODROID’sDHCPpool.

UseODROIDasaRemoteSensorforWi-FiExplorerProOntheODROID:

• Pressbutton#2toenableanddisabletheRemoteSensorservice• Note:SSHcommandline

# service wifiexplorer-sensor start/stop OntheMacOSClient:

• StartWiFiExplorerPro

Addaremotesensor

YouarenowfeedinginformationfromtheODROID’sattachedUSBWi-FidevicedirectlytotherunningcopyofWi-FiExplorerandcandoremoteanalysis.(ThinkofhavingtheODROIDshippedtoaremotespot,pluggedintoanEthernetporttheattachedremotelyusingWi-FiExplorerforgatheringdetailedinformation.)

Appendix

Client Installations for ODROID Testing

Macintosh

Install iPerf3 on Mac OS Install Xcode Launch Terminal Application $ xcode-select --install Install iperf3 $ sudo git clone https://github.com/esnet/iperf.git $ cd iperf $ sudo ./configure $ sudo make $ sudo make install Test if it is working $ iperf3 –v Start an iperf 3 server $ iperf3 –s Run an iperf3 client $ iperf3 –c x.x.x.x (IP address of iperf3 server) Install iperf2 on Mac OS First, download and extract the latest iperf2 source code from here:

https://sourceforge.net/projects/iperf2/?source=typ_redirect Unzip and Save to your desktop. Open Terminal application and change directories to the location of the extracted iperf2 files, for example: $ cd ~/Desktop/iperf-2.0.9 $ ./configure $ sudo make $ sudo make install

Test if iperf2 is installed: $ iperf –v Start iperf2 server: $ iperf -s Run an iperf test as the client: $ iperf -c x.x.x.x (iperf2 server IP) Install ZAP on Mac OS Open Terminal application. $ sudo curl -O Note: Source-archive.zip is in the ‘Clients for ODROID Exercises’ Folder Note: That is a capital letter O in the –O command above, not a Zero. $ sudo unzip source-archive.zip $ cd zapwireless/trunk $ sudo make $ sudo make install $ sudo mv bin/macintosh/zap* /usr/local/bin Test the Zap server daemon: $ zapd Run a zap test: $ zap -sx.x.x.x -dx.x.x.x (Source and Destination IP Addresses) *zapd server must also be running on the same machine running this local test. Or if you are testing remotely – the remote machine must be running the zapd daemon. Alternative method of using Zap on a Macintosh. Copy the zapd and zap files from the USB. /Clients for ODROID Exercises/ZAP/zap-mac/zap and zapd Copy these two files to the desktop. Test the Zap server daemon: $ /Users/YourUserName\ 1/Desktop/zapd Control-C to exit

Run a zap test: $ /Users/YourUserName\ 1/Desktop/zap -sx.x.x.x - dx.x.x.x (Source and Destination IP Addresses) Do not put a space after the –s or the –d. Use Control-C to exit. Install WiFiPerf (demo) Unzip the WiFiPerf Endpoint files from the Clients for ODROID Exercises Folder. /Clients for ODROID Exercises/Mac_OS_WiFiPerf_Deskptop_v2.0_b585b.zip

Windows

Install iPerf3 Copy the iPerf 3.1.3-Windows files from the USB. /Clients for ODROID Exercises/iPerf3/iperf-3.1.3-Windows Run iperf3.exe Test if it is working $ iperf3 –v Start an iperf 3 server $ iperf3 –s Run an iperf3 client $ iperf3 –c x.x.x.x (IP address of iperf3 server) Install iperf2 Copy the iPerf 2.0.8-Windows files from the USB. /Clients for ODROID Exercises/iPerf2/iperf-2.0.8-Windows Run iperf.exe Test if iperf2 is installed:

$ iperf –v Start iperf2 server: $ iperf -s Run an iperf test as the client: $ iperf -c x.x.x.x (iperf2 server IP) Install ZAP Unzip the Zap-1.83-Windows files from the USB. /Clients for ODROID Exercises/zap-1.83-Windows Test the Zap server daemon: $ zapd Run a zap test: $ zap -sx.x.x.x -dx.x.x.x (Source and Destination IP Addresses) *zapd server must also be running on the same machine running this local test. Or if you are testing remotely – the remote machine must be running the zapd daemon. Install WiFiPerf (demo) Unzip the WiFiPerf-Windows files from the USB. /Clients for ODROID Exercises/Windows_WiFiPerf_Endpoint_v1.0_b528.zip Ekahau Site Survey Install Ekahau ESS and ask instructor for a temporary license key. /Clients for ODROID Exercises/ESS

iOS Install WiFiPerf (demo) Unzip the WiFiPerf Endpoint files from the USB. /Clients for ODROID Exercises/Mac_OS_WiFiPerf_Endpoint_v1.0_b585b.zip Install Ruckus Speedflex Get from Apple App Store https://itunes.apple.com/us/app/ruckus-speedflex/id556602787?mt=8 Install Hurricane Electric Network Tools Install from Apple App Store. https://itunes.apple.com/us/app/he-net-network-tools/id858241710?mt=8

Android Install WiFiPerf (demo) Install the WiFiPerf Endpoint files from the USB. /Clients for ODROID Exercises/Andoird_WiFiPerf_Endpoint_v1.0_build528.apk Install Ruckus SpeedFlex Download from Google Play Store https://play.google.com/store/apps/details?id=com.ruckuswireless.speedflex Install Hurricane Electric – Network Tools App Download and Install from Google Play Store https://play.google.com/store/apps/details?id=net.he.networktools&hl=en Install Aruba Utilities Download and install from Google Play Storehttps://play.google.com/store/apps/details?id=com.arubanetworks.arubautilities