1. Sponsored by the National Science Foundation 1 GEC16: March 19, 2013 Are you ready for the tutorial? 1.Sign In 2.Grab a Worksheet 3.Did you do the pre-work? A.Are you able to login to the GENI Portal? Using your home institution username and password, or Using a GPO issued username and password, or A temporary account B.Have are running the GEC16 Tutorial VM including both: VirtualBox GEC16 Tutorial VM image C.Sign and return the GENI Project Software Disclaimer GENI Portal is at: http://panther.gpolab.bbn.com

2. Sponsored by the National Science Foundation Tutorial: Getting Started with GENI Using the GENI Portal Sarah Edwards, Marshall Brinn, Aaron Helsinger, Tom Mitchell GENI Project Office 19 March 2013

3. Sponsored by the National Science Foundation 3 GEC16: March 19, 2013 Hands On Exercise Do a Simple Layer 2 Experiment in GENI Reserve two VMs across the US from each other connected by a Layer 2 circuit Layer 2 VM in MA VM in Utah

4. Sponsored by the National Science Foundation 4 GEC16: March 19, 2013 Understand GENI Terminology slice project aggregate experimenter resource

5. Sponsored by the National Science Foundation 5 GEC16: March 19, 2013 Use the GENI Portal

6. Sponsored by the National Science Foundation 6 GEC16: March 19, 2013 Experiment Workflow Part I: Design/Setup –Step 1: Establish Management Environment –Step 2: Obtain Resources Part II: Execute –Execute Experiment Part III: Finish –Teardown Experiment

7. Sponsored by the National Science Foundation 7 GEC16: March 19, 2013 The GENI Portal is… A web-based tool for experimenters to manage experimenters, projects, and slices. Includes simple tools to reserve resources. More to come in the future.

8. Sponsored by the National Science Foundation 8 GEC16: March 19, 2013 Experimenter An experimenter is a researcher who uses GENI resources Different types of experimenters have different roles and permissions: Advisor vs Grad Student Teacher vs TA vs Student Experimenter

9. Sponsored by the National Science Foundation 9 GEC16: March 19, 2013 Projects Projects organize research in GENI Project Lead Members Slice Projects contain both people and their experiments A project is led by a single responsible individual: the project lead

10. Sponsored by the National Science Foundation 10 GEC16: March 19, 2013 Creating Projects Only project leads can create projects. Project names are public, unique and permanent A project may contain many experimenters; an experimenter may be a member of many projects Projects have an optional expiration (e.g. for classes, tutorials) For today’s tutorial we will all join a project which expires on Friday

11. Sponsored by the National Science Foundation 11 GEC16: March 19, 2013 Experiment Workflow Part I: Design/Setup –Step 1: Establish Management Environment –Step 2: Obtain Resources Part II: Execute –Execute Experiment Part III: Finish –Teardown Experiment

12. Sponsored by the National Science Foundation 12 GEC16: March 19, 2013 Part I: Step 1: Establish Management Environment 1.Pre-work: Login to the Portal 2.Generate and Download SSH Keypair 3.Join a Project Project Name: GEC16PortalTutorial Tutorial instructions: http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example

13. Sponsored by the National Science Foundation 13 GEC16: March 19, 2013 Creating a GENI account GENI Portal is at: https://panther.gpolab.bbn.com Anyone with an account at a supported identity provider (usually your school or employer) can log in, but they will have no privileges If you don’t have such an account, we will make you an account at the GPO Identity Provider You must be a member of a project to do anything interesting

14. Sponsored by the National Science Foundation 14 GEC16: March 19, 2013 InCommon For many experimenters: no new passwords familiar login screens Leverage InCommon for single sign-on authentication Experimenters from 288 educational and research institutions have InCommon accounts

15. Projects Slices Log Messages Profile You are here Help

16. Generate SSH Keys

17. In your local VM … > mv ~/Downloads/id_geni_ssh_rsa ~/.ssh/. > chmod 600 ~/.ssh/id_geni_ssh_rsa > ssh-add ~/.ssh/id_geni_ssh_rsa

18. Join a Project GEC16PortalTutorial

19. Sponsored by the National Science Foundation 19 GEC16: March 19, 2013 Resource A resource is a piece of infrastructure A resource can be real or virtual. Resource specifications are used to describe and request resources. Examples: Compute: computer vs virtual machine (VM) Wireline Network: VLAN or OpenFlow Wireless: WiMAX

20. Sponsored by the National Science Foundation 20 GEC16: March 19, 2013 Aggregate An aggregate manages a set of reservable resources Aggregates include: GENI racks OpenFlow WiMAX InstaGENI RackExoGENI Rack

21. Sponsored by the National Science Foundation 21 GEC16: March 19, 2013 Slice A slice is a container of resources used in an experiment. A slice can contain resources from one or more aggregates A slice is in a single project A slice has an expiration Slice names are public, reusable and unique

22. Sponsored by the National Science Foundation 22 GEC16: March 19, 2013 Experimenter Putting it all together slice aggregate project Member: Lead: Experimenter Layer 2 VLAN resource

23. Sponsored by the National Science Foundation 23 GEC16: March 19, 2013 Experiment Workflow Part I: Design/Setup –Step 1: Establish Management Environment –Step 2: Obtain Resources Part II: Execute –Execute Experiment Part III: Finish –Teardown Experiment

24. Sponsored by the National Science Foundation 24 GEC16: March 19, 2013 slice Part I: Step 2: Obtain Resources 1.Create a slice 2.Reserve VM at Two Aggregates –Utah InstaGENI –GPO InstaGENI 3.Check Whether VMs are Ready to be Used Layer 2 VLAN VM (Mass) VM (Utah) Wait for blinking ball

25. Create Slice

26. Add Resources Extend slice expiration Extend resource expiration

27. Add Resources at Utah InstaGENI Add Resources at GPO InstaGENI Wait for blinking ball

28. Nodes ready?

29. Sponsored by the National Science Foundation 29 GEC16: March 19, 2013 Experiment Workflow Part I: Design/Setup –Step 1: Establish Management Environment –Step 2: Obtain Resources Part II: Execute –Execute Experiment Part III: Finish –Teardown Experiment

30. Sponsored by the National Science Foundation 30 GEC16: March 19, 2013 Part II: Execute Experiment 1.Login to nodes (two nodes: client & server) 2.Run your experiment 1.Send IP Traffic 2.Disable IP 3.Send Layer 2 (non-IP) Traffic 3.Logout of nodes Internet Data Interfaces Control Interfaces ssh Layer 2 VLAN Experimenter server (Mass) client (Utah)

31. Login

32. # login to “client” VM > ssh username @ hostname1 -p port1 $ /sbin/ifconfig # login to “server” VM > ssh username @ hostname2 -p port2 $ /sbin/ifconfig server client

34. $ /sbin/ifconfig server client

35. Worksheet Client Control Interface Nameeth ___ IP Address__. __. __. __ Data Interface Namemv ___. ___ Initial IP Addr10. __. __. __ Des IP Addr10. 10. 1. 1 /24 Server Control Interface Nameeth ___ IP Address__. __. __. __ Data Interface Namemv ___. ___ Initial IP Addr10. __. __. __ Des IP Addr10. 10. 1. 2 /24 MAC Address __ : __ : __ : __ : __ : __ Project Name:GEC16PortalTutorial Slice Name: portal 01 EtherType: 100 01

36. # configure your IP $ sudo /sbin/ifconfig mv10.1 10.10.1.1/24 # should SUCCEED $ ping 10.10.1.2 –c 5 # disable IP on your nodes $ sudo /sbin/ifconfig mv10.1 0.0.0.0 # should FAIL $ ping 10.10.1.2 –c 5 # start L2 client $ sudo /usr/local/bin/pingPlus 01:02:03:04:05:06 mv10.1 10001 $ exit # configure your IP $ sudo /sbin/ifconfig mv2.3 10.10.1.2/24 # disable IP on your nodes $ sudo /sbin/ifconfig mv2.3 0.0.0.0 # start L2 server $ sudo /usr/local/bin/pingPlusLis tener 10001 $ exit server client Be careful!

37. Sponsored by the National Science Foundation 37 GEC16: March 19, 2013 Experiment Workflow Part I: Design/Setup –Step 1: Establish Management Environment –Step 2: Obtain Resources Part II: Execute –Execute Experiment Part III: Finish –Teardown Experiment

38. Sponsored by the National Science Foundation 38 GEC16: March 19, 2013 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 resources at each aggregate slice project aggregate experimenter resource

39. Delete Resources at both GPO InstaGENI and Utah InstaGENI

40. Sponsored by the National Science Foundation 40 GEC16: March 19, 2013 Congratulations! You have… –Run your first GENI Experiment! –Exercised your knowledge of GENI terminology –Used the GENI Portal

41. Sponsored by the National Science Foundation 41 GEC16: March 19, 2013 What’s Next? (If needed) Request a permanent account Are you a Professor or PI? –Ask to be a Project Lead so you can create projects –Invite students to join your project Are you a Student? –Ask your professor to create a project –Request to join that project Keep experimenting!

42. Sponsored by the National Science Foundation 42 GEC16: March 19, 2013 Learn about other tools Tools that are integrated with the Portal –Flack GUI is linked on each slice page InstaGENI Tutorial on Thurs from 8:30-10am –Omni command line tool (config linked on bottom of Profile page) Advanced Networking Experiments Tutorial on Wed from 1:30-3:30 Get help at GEC –Drop In Session –Coding Sprint –Help Table Get help after GEC –Portal specific questions: portal-help@geni.net (Sarah, Tom, Aaron & Marshall)portal-help@geni.net –Everything else: help@geni.net (Niky and Vic)help@geni.net

43. Sponsored by the National Science Foundation 43 GEC16: March 19, 2013 Welcome to GENI! Don’t forget to fill out the tutorial survey! http://tinyurl.com/GEC16-Tut-Feedback