1. Sponsored by the National Science Foundation 1 ICDCS13: July 8, 2013 Are you ready for the tutorial? 1.Grab a Worksheet and instructions 2.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.Are you running the ICDCS13 Tutorial VM including both: VirtualBox ICDCS13 Tutorial VM image GENI Portal is at: http://portal.geni.net

2. Sponsored by the National Science Foundation Tutorial: Getting Started with GENI - Part I Niky Riga, GENI Project Office 8 July 2013

3. Sponsored by the National Science Foundation 3 ICDCS13: July 8, 2013 Hands On Exercise Do a Simple Layer 2 Experiment in GENI Reserve two VMs connected at Layer 2 Layer 2 VM

4. Sponsored by the National Science Foundation 4 ICDCS13: July 8, 2013 Understand GENI Terminology slice project aggregate experimenter resource

5. Sponsored by the National Science Foundation 5 ICDCS13: July 8, 2013 Use the GENI Portal and Flack

6. Sponsored by the National Science Foundation 6 ICDCS13: July 8, 2013 Experiment Workflow Part I: Design/Setup Part II: Execute Part III: Finish

7. Sponsored by the National Science Foundation 7 ICDCS13: July 8, 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 ICDCS13: July 8, 2013 Flack is … A graphical user interface (GUI) for: –designing topologies in GENI –reserving resources in GENI

9. Sponsored by the National Science Foundation 9 ICDCS13: July 8, 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

10. Sponsored by the National Science Foundation 10 ICDCS13: July 8, 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

11. Sponsored by the National Science Foundation 11 ICDCS13: July 8, 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 in about a week

12. Sponsored by the National Science Foundation 12 ICDCS13: July 8, 2013 Experiment Workflow Part I: Design/Setup Part II: Execute Part III: Finish

13. Sponsored by the National Science Foundation 13 ICDCS13: July 8, 2013 Part I: Establish Management Environment 1 Pre-work: Design your experiment 2.1 Pre-work: Login to the Portal 2.2 Pre-work: Project lead adds you to project Project Name: ICDCS13 2.3 Generate and Download SSH Keypair Tutorial instructions: http://groups.geni.net/geni/wiki/Tutorials/ICDCS2013/GettingStartedWithGENI_I/Procedure

14. Sponsored by the National Science Foundation 14 ICDCS13: July 8, 2013 Creating a GENI account GENI Portal is at: https://portal.geni.net 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

15. Sponsored by the National Science Foundation 15 ICDCS13: July 8, 2013 InCommon For many experimenters: no new passwords familiar login screens Leverage InCommon for single sign-on authentication Experimenters from 304 educational and research institutions have InCommon accounts

16. Sponsored by the National Science Foundation 16 ICDCS13: July 8, 2013 Using ssh with a public/private keypair Login to all GENI compute resources using ssh with a private key 1.The public key is loaded onto the node when you reserve resources. 2.You provide the private key when you log into the node. There are several ways to offer your private key to ssh. You should never be prompted for a password to log into a GENI compute node. If you are, something has always gone wrong. No password!

17. Sponsored by the National Science Foundation 17 ICDCS13: July 8, 2013 Using ssh with a public/private keypair Login to all GENI compute resources using ssh with a private key There are several ways to offer your private key to ssh. Today we will use tool called an ssh agent. $ ssh-add ~/.ssh/id_geni_ssh_rsa $ ssh username@hostname -p 12345 You should never be prompted for a password to log into a GENI compute node. If you are, something has always gone wrong. No password!

18. Sponsored by the National Science Foundation 18 ICDCS13: July 8, 2013 Expiration and renewal slice expiration time ≤ project expiration time each resource expiration time ≤ slice expiration time each resource expiration time ≤ aggregate’s max expiration project slice resource (optional) project expiration time slice expiration time resource expiration time now In general, to extend the lifetime of your resource reservation, you must renew the slice and all resources resource

19. Projects Slices Log Messages Profile You are here Help

20. Generate SSH Keys 2 Login Join Project

21. 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 2

22. Sponsored by the National Science Foundation 22 ICDCS13: July 8, 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

23. Sponsored by the National Science Foundation 23 ICDCS13: July 8, 2013 Aggregate An aggregate manages a set of reservable resources Aggregates include: GENI racks OpenFlow WiMAX InstaGENI RackExoGENI Rack

24. Sponsored by the National Science Foundation 24 ICDCS13: July 8, 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

25. Sponsored by the National Science Foundation 25 ICDCS13: July 8, 2013 Experimenter Putting it all together slice aggregate project Member: Lead: Experimenter Layer 2 resource

26. Sponsored by the National Science Foundation 26 ICDCS13: July 8, 2013 slice Part I continued: Obtain Resources 3.1 Create a slice 3.2 (optional) Renew your slice 3.3 Reserve two VMs and a link 3.4 Check Whether VMs are Ready to be Used Layer 2 VM

27. Create Slice 3.1

28. Extend slice expiration 3.2

29. Launch Flack Extend slice expiration Extend resource expiration 3.3

30. Launch Flack usernameslice name all available aggregates 3.3

31. Draw two VMs connected by a link 3.3

32. Change names of VMs 3.3

33. Reserve resources 3.3

34. Resources are READY!!! 3.4

35. Sponsored by the National Science Foundation 35 ICDCS13: July 8, 2013 Experiment Workflow Part I: Design/Setup Part II: Execute Part III: Finish

36. Sponsored by the National Science Foundation 36 ICDCS13: July 8, 2013 Part II: Execute Experiment 4.1 Login to nodes (two nodes: client & server) 4.2 Download and compile pingPlus 5 Run your experiment 5.1 Send IP Traffic 5.2 Disable IP and send Layer 2 (non-IP) Traffic 6.1 Logout of nodes Internet Data Interfaces Control Interfaces ssh Layer 2 Experimenter serverclient

37. Login 4.1

38. $ wget …/pingPlus-0.2.tar.gz $ tar xvfz pingPlus-0.2.tar.gz $ cd pingPlus-0.2 $ make $ /sbin/ifconfig $ wget …/pingPlus-0.2.tar.gz $ tar xvfz pingPlus-0.2.tar.gz $ cd pingPlus-0.2 $ make $ /sbin/ifconfig server client 4.25.1

39. Worksheet Client Control Interface Nameeth ___ IP Address__. __. __. __ Data Interface Nameeth ___ Initial IP Addr10. __. __. __ Des IP Addr10. 18. 1. 1 /24 Server Control Interface Nameeth ___ IP Address__. __. __. __ Data Interface Nameeth ___ Initial IP Addr10. __. __. __ Des IP Addr10. 18. 1. 2 /24 MAC Address __ : __ : __ : __ : __ : __ Project Name:ICDCS13 Slice Name: portal 01 EtherType: 180 01 5.1

40. # configure your IP $ sudo /sbin/ifconfig mv10.1 10.18.1.1/24 # should SUCCEED $ ping 10.18.1.2 –c 5 # disable IP on your nodes $ sudo /sbin/ifconfig eth1726 0.0.0.0 # should FAIL $ ping 10.18.1.2 –c 5 # start L2 client $ sudo pingPlus 01:02:03:04:05:06 eth1726 18001 $ exit # configure your IP $ sudo /sbin/ifconfig mv2.3 10.18.1.2/24 # disable IP on your nodes $ sudo /sbin/ifconfig eth1726 0.0.0.0 # start L2 server $ sudo pingPlusListener 18001 $ exit server client 5.15.26.1

41. Sponsored by the National Science Foundation 41 ICDCS13: July 8, 2013 Experiment Workflow Part I: Design/Setup Part II: Execute Part III: Finish

42. Sponsored by the National Science Foundation 42 ICDCS13: July 8, 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

43. Delete Resources 7

44. Sponsored by the National Science Foundation 44 ICDCS13: July 8, 2013 Congratulations! You have… –Run your first GENI Experiment! –Exercised your knowledge of GENI terminology –Used the GENI Portal and Flack

45. Sponsored by the National Science Foundation 45 ICDCS13: July 8, 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!

46. Sponsored by the National Science Foundation 46 ICDCS13: July 8, 2013 Learn about other tools Tools that are integrated with the Portal –Flack GUI is linked on each slice page –Omni command line tool (config linked on bottom of Profile page) Next tutorial –GEMINI/GENI Desktop is an Intrumentation and Measurement tool Get help after ICDCS –help@geni.net (Niky and Vic)help@geni.net

47. Sponsored by the National Science Foundation 47 ICDCS13: July 8, 2013 Welcome to GENI!