1. Sponsored by the National Science Foundation Click Software Routers Sarah Edwards GENI Project Office

2. Sponsored by the National Science Foundation 2 GREE-SC ‘14, July 21, 2014 Software Routers Not wire-speed Easy to deploy Provide ability to implement new routing protocols over a L2 network fast –MobilityFirst, Packet Cache, XIA An easy way to bandwidth limit your slice

3. Sponsored by the National Science Foundation 3 GREE-SC ‘14, July 21, 2014 Install scripts Specify in the RSpec –Where to download software from Usually comes with an install-script.sh –What commands to run at boot time It runs in the context of a the “geni” user –It is not your user account –It does have sudo privileges

4. Sponsored by the National Science Foundation 4 GREE-SC ‘14, July 21, 2014 Install scripts Automatic installation of software

5. Sponsored by the National Science Foundation 5 GREE-SC ‘14, July 21, 2014 Hands On Exercise Run a non-IP multi-path router over layer 2 Reserve 6 VMs: 4 will be Click routers 2 will be end hosts Odd checksums left Even checksums right

6. Sponsored by the National Science Foundation 6 GREE-SC ‘14, July 21, 2014 Part I: Design/Setup –Obtain Resources: Create a slice and reserve resources Part II: Execute –Configure and Initialize Services: Configure the Click Routers –Execute Experiment: Use custom routing to forward traffic over multi-path topology Part III: Finish –Teardown Experiment

7. Sponsored by the National Science Foundation 7 GREE-SC ‘14, July 21, 2014 Experimenter For the Tutorial: Portal Account with Omni Slice : click Sliver AM InstaGENI Aggregate You GENI Portal $ omni.py createsliver aliceslice myRSpec.xml INFO:omni:Loading config file omni_config INFO:omni:Using control framework pgeni INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab. expires within 1 day on 2011-07-07 INFO:omni:Creating sliver(s) from rspec file INFO:omni:Writing result of createsliver for INFO:omni:Writing to ‘aliceslice-manifest-rspe INFO:omni: ----------------------------------- INFO:omni: Completed createsliver: Options as run: aggregate: https://www.emulab. framework: pgeni native: True Args: createsliver aliceslice myRSpec.xml Result Summary: Slice urn:publicid:IDN+pgeni Reserved resources on https://www.emulab.net/p Saved createsliver results to aliceslice-man INFO:omni: =================================== omniomni http://www.gpolab.bbn.com/exp/ClickExampleExperiment/click.rspec

8. Sponsored by the National Science Foundation 8 GREE-SC ‘14, July 21, 2014 … in the meantime … Install Scripts specified in the rspec –It needs to be available over http does not run as “you”, but has sudo it runs at every boot $PATH might not be set OS-dependent 1.Write script in language of choice 2.Upload script 3.Test script 4.Add to rspec

9. Sponsored by the National Science Foundation 9 GREE-SC ‘14, July 21, 2014 Install Scripts: Look inside # 1. Change to dir. with installed software cd /local # 2. Check if first time if [ ! -f "./installed.txt" ] then #### Create the file #### sudo touch "./installed.txt” #### Run one-time commands #### #2a. Install necessary packages #2b. Install custom software #2c. Reboot if needed fi #3. Run Boot-time commands #3a. Start common services hn=`echo $HOSTNAME | cut -d'.' -f 1` if [ $hn == "server" ] then #4. Host specific commands fi 1. Download install script 2. Identify the 4 sections

10. Sponsored by the National Science Foundation 10 GREE-SC ‘14, July 21, 2014 Experiment Workflow Part I: Design/Setup –Obtain Resources: Create a slice and reserve resources Part II: Execute –Configure and Initialize Services: Configure the Click Routers –Execute Experiment: Use custom routing to forward traffic over multi-path topology Part III: Finish –Teardown Experiment

11. Sponsored by the National Science Foundation 11 GREE-SC ‘14, July 21, 2014 Remote configuration of Click Remotely invoke configuration script : extractClickConfig.py –parse manifest rspec –extract information about topology –create click.config Remotely turn off IP in the routers

12. Sponsored by the National Science Foundation 12 GREE-SC ‘14, July 21, 2014 Experiment Workflow Part I: Design/Setup –Obtain Resources: Create a slice and reserve resources Part II: Execute –Configure and Initialize Services: Configure the Click Routers –Execute Experiment: Use custom routing to forward traffic over multi-path topology Part III: Finish –Teardown Experiment

13. Sponsored by the National Science Foundation 13 GREE-SC ‘14, July 21, 2014 Send Traffic Start routers Send packet using netcat HostA Top Bottom Left Right HostB

14. Sponsored by the National Science Foundation 14 GREE-SC ‘14, July 21, 2014 Click Config File route :: Classifier(27/01%01,-); modify :: Unstrip(2) -> StoreData(0, "AliceWasHere3546") -> route; FromDevice(eth3, PROMISC true) -> Classifier(12/0800) -> modify; route[0] -> left :: EtherEncap(0x7744, 00:04:23:b7:14:76, 00:04:23:b7:18:fa) -> SimpleQueue -> Print(outL) -> ToDevice(eth2); route[1] -> right :: EtherEncap(0x7744, 00:04:23:b7:1c:e0, 00:04:23:b7:19:2e) -> SimpleQueue -> Print(outR) -> ToDevice(eth4); restore :: SimpleQueue -> Strip(30) -> EtherEncap(0x800, 00:04:23:b7:14:77, 00:04:23:b7:20:00) -> ToDevice(eth3);

15. Sponsored by the National Science Foundation 15 GREE-SC ‘14, July 21, 2014 21:49:26.003255 02:ea:52:1b:47:ee (oui Unknown) > 02:25:07:e9:38:ba (oui Unknown), ethertype Unknown (0x7744), length 78: 0x0000: 416c 6963 6557 6173 4865 7265 3335 3436 AliceWasHere3546 0x0010: 4500 0030 8215 4000 4011 9d91 0a0a 0101 E..0..@.@....... 0x0020: 0a0a 0602 c1e5 5ff5 001c 7825 686f 7764......_...x%howd 0x0030: 792c 2068 6f77 2061 7265 2079 6f75 3f0a y,.how.are.you?. 21:49:36.060399 02:25:07:e9:38:ba (oui Unknown) > 02:ea:52:1b:47:ee (oui Unknown), ethertype Unknown (0x7744), length 87: 0x0000: 426f 6257 6173 4865 7265 3132 3334 3536 BobWasHere123456 0x0010: 4500 0039 5444 4000 4011 cb59 0a0a 0602 E..9TD@.@..Y.... 0x0020: 0a0a 0101 5ff5 c1e5 0025 e9ef 4927 6d20...._....%..I'm. 0x0030: 6669 6e65 2e20 5468 616e 6b73 2066 6f72 fine..Thanks.for 0x0040: 2061 736b 696e 672e 0a.asking..

16. Sponsored by the National Science Foundation 16 GREE-SC ‘14, July 21, 2014 Experiment Workflow Part I: Design/Setup –Setup: Omni with Multiple Users –Obtain Resources: Create a slice and reserve resources Part II: Execute –Configure and Initialize Services: Configure the Click Routers –Execute Experiment: Use custom routing to forward traffic over multi-path topology Part III: Finish –Teardown Experiment

17. Sponsored by the National Science Foundation 17 GREE-SC ‘14, July 21, 2014 Part III: Finish Experiment When your experiment is done, you should always release your resources. –Normally this is when you would archive your data –Delete your slivers at each aggregate slice project aggregate RSpec user resource sliver AM API sliver credentials certificate