| 1 | = Lab Zero: A First Experiment Using GENI and Jacks Tool = |
| 2 | |
| 3 | == Overview == |
| 4 | |
| 5 | This is a first, simple experiment on GENI useful for familiarizing new experimenters with GENI and the tools for using GENI. |
| 6 | |
| 7 | === What you will learn === |
| 8 | The high levels goals for this exercise are to: |
| 9 | 1. Do a simple but complete GENI experiment |
| 10 | 2. Learn and use 5 GENI terms: experimenter, project, slice, resource, and aggregate |
| 11 | 3. Use the [http://portal.geni.net GENI Experimenter Portal] and Flack |
| 12 | |
| 13 | Specifically, during this exercise you will: |
| 14 | * Use your GENI account for the first time and do some one time setup |
| 15 | - Login to the GENI Experimenter Portal for the first time |
| 16 | - Join a Project |
| 17 | - Specify `ssh` keys for use logging into resources |
| 18 | * Learn how to reserve, login to, and release resources in GENI |
| 19 | - Create and renew a slice |
| 20 | - Generate and reserve your own topology of GENI resources using Flack |
| 21 | - Learn how to login to compute resources using `ssh` |
| 22 | - Learn how to delete resources in GENI |
| 23 | * Understand the difference between the control and data plane interfaces on each node |
| 24 | * Use these resources to do a very simple first experiment |
| 25 | - Use `ping` to test connectivity between the reserved resources |
| 26 | - Use `ifconfig` to identify your data and control plane interfaces |
| 27 | |
| 28 | === Experiment Topology and Setup === |
| 29 | |
| 30 | {{{ |
| 31 | #!html |
| 32 | <img src="http://groups.geni.net/geni/attachment/wiki/GEC17Agenda/GettingStartedWithGENI_I/Graphics/2vmvlan_overview.png?format=raw" height="152" alt="Tutorial Setup"/> |
| 33 | }}} |
| 34 | |
| 35 | Reserve two VMs at the same location connected by a Layer 2 circuit. |
| 36 | |
| 37 | == Background == |
| 38 | |
| 39 | [wiki:GENIExperimenter/Tutorials/GettingStarted_PartI/Background Background information] about pre-requisites, tools, resources, and where to get help. |
| 40 | |
| 41 | |
| 42 | == Video == |
| 43 | |
| 44 | * A [https://www.youtube.com/watch?v=vCOtltU3rX0&list=UUg_vFA7gvYEcILfAZlfL9Bw video] of the Lab Zero exercise |
| 45 | |
| 46 | == Procedure == |
| 47 | {{{ |
| 48 | #!html |
| 49 | |
| 50 | |
| 51 | <table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0"> |
| 52 | <tr> |
| 53 | <td> |
| 54 | <a href="./Procedure/DesignSetup"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design.png?format=raw" width="152" height="152" alt="Design/Setup"></a> |
| 55 | </td> |
| 56 | <td> |
| 57 | <ul> |
| 58 | <li><a href="./Procedure/DesignSetup">Part I: Design/Setup</a></li> |
| 59 | <ul> |
| 60 | <li>Step 1: Design Experiment</li> |
| 61 | <li>Step 2: Establish Management Environment</li> |
| 62 | <li>Step 3: Obtain Resources</li> |
| 63 | </ul></ul> |
| 64 | </td> |
| 65 | </tr> |
| 66 | <tr> |
| 67 | <td> |
| 68 | <a href="./Procedure/Execute"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" width="152" height="143" alt="Execute"></a> |
| 69 | </td> |
| 70 | <td> |
| 71 | <ul> |
| 72 | <li><a href="./Procedure/Execute">Part II: Execute</a></li> |
| 73 | <ul> |
| 74 | <li>Step 4: Configure and Initialize Services </li> |
| 75 | <li>Step 5: Execute Experiment </li> |
| 76 | <li>Step 6: Analyze and Visualize Experiment </li> |
| 77 | </ul></ul> |
| 78 | </td> |
| 79 | </tr> |
| 80 | <tr> |
| 81 | <td> |
| 82 | <a href="./Procedure/Finish"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw" width="152" height="114" alt="Finish"></a> |
| 83 | </td> |
| 84 | |
| 85 | <td> |
| 86 | <ul> |
| 87 | <li><a href="./Procedure/Finish">Part III: Finish</a></li> |
| 88 | <ul> |
| 89 | <li>Step 7: Teardown Experiment</li> |
| 90 | <li>Step 8: Archive Experiment</li> |
| 91 | </ul></ul> |
| 92 | </td> |
| 93 | |
| 94 | </tr> |
| 95 | </table> |