| 1 | {{{ |
| 2 | #!html |
| 3 | <div style="text-align:left; width:571px; margin-left:none; margin-right:auto;"> |
| 4 | <img id="Image-Maps_7201210311729283" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/hello.png?format=raw" usemap="#Image-Maps_7201210311729283" border="0" width="571" height="68" alt="" /> |
| 5 | <map id="_Image-Maps_7201210311729283" name="Image-Maps_7201210311729283"> |
| 6 | <area shape="poly" coords="15,14,115,12,133,32,120,51,17,50," href="http://groups.geni.net/geni" alt="Wiki Home" title="Wiki Home" /> |
| 7 | <area shape="poly" coords="125,12,142,33,123,52,231,52,253,32,233,15," href="http://groups.geni.net/geni/wiki/GENIExperimenterWelcome" alt="Welcome GENI Experimenters" title="Welcome GENI Experimenters" /> |
| 8 | <area shape="poly" coords="242,13,256,32,237,52,336,56,355,30,332,11," href="http://groups.geni.net/geni/wiki/SignMeUp" alt="Sign Up For a GENI Account" title="Sign Up For a GENI Account" /> |
| 9 | <area shape="poly" coords="344,10,363,29,344,50,540,53,553,31,532,13," href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/RunHelloGENI" alt="Run Hello GENI example" title="Run Hello GENI example" /> |
| 10 | <area shape="rect" coords="569,66,571,68" href="http://www.image-maps.com/index.php?aff=mapped_users_7201210311729283" alt="Image Map" title="Image Map" /> |
| 11 | </map> |
| 12 | |
| 13 | </div> |
| 14 | }}} |
| 15 | |
| 16 | [[PageOutline]] |
| 17 | |
| 18 | Welcome to GENI. This page will guide you through your first GENI experiment. The only thing you will need is a GENI account. If you don't already have one, [wiki:SignMeUp sign up!] |
| 19 | |
| 20 | |
| 21 | = 1. Configure your GENI account = |
| 22 | For our first experiment we are going to use [http://www.protogeni.net/flack" Flack] a web-based graphical tool for reserving GENI resources. Your first step is to log in to Flack. [http://www.youtube.com/watch?v=-XF6wyNu1BE This video] will guide you through the steps of logging in. |
| 23 | {{{ |
| 24 | #!html |
| 25 | <table border="0"> |
| 26 | |
| 27 | <tr> |
| 28 | <td> |
| 29 | |
| 30 | <a href="http://www.youtube.com/watch?v=-XF6wyNu1BE" target="GENIVideo"> |
| 31 | <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/video-flack.png?format=raw" alt="Login to Flack Video" height="120" title="How to login video" /> </a> |
| 32 | </td> |
| 33 | <td > |
| 34 | <ol> |
| 35 | <li> Go to <a href="http://www.protogeni.net/flack" target="_blank"> http://www.protogeni.net/flack </a> and press the <b> Log in </b> button</li> |
| 36 | <li> From the <b> select authority</b> drop down menu, select the site authority for your GENI account, most probably pgeni.gpolab.bbn.com and press the <b> Download </b> button</li> |
| 37 | <li> Answer <b>yes</b> in the pop-up window </li> |
| 38 | <li> Login to the new window using your GENI account </li> |
| 39 | <li> Reload the Flack tab and repeat steps <b> 1 and 2 </b> </li> |
| 40 | <li> After your private key and certificate are loaded, type your GENI passphrase in the box</li> |
| 41 | <li> Select the sites you want. For this tutorial we only need the utahemulab.cm site.</li> |
| 42 | </ol> |
| 43 | </td> |
| 44 | |
| 45 | </tr> |
| 46 | </table> |
| 47 | }}} |
| 48 | |
| 49 | = 2. Launch your experiment = |
| 50 | Now that you are logged in to Flack, we are ready to design our experiment. [http://www.youtube.com/watch?v=F5q-AYwggug&NR=1 This video] will guide you through the process of setting up the resources for the Hello GENI experiment. To complete the setup you will need to save a copy of [http://www.gpolab.bbn.com/experiment-support/HelloGENI/hellogeni.rspec this file] on your computer. This is a [wiki:GENIExperimenter/RSpecs Resource Specification (rspec)] file that contains a description of this experiment for Flack. |
| 51 | {{{ |
| 52 | #!html |
| 53 | <table border="0"> |
| 54 | |
| 55 | <tr> |
| 56 | <td> |
| 57 | |
| 58 | <a href="http://www.youtube.com/watch?v=F5q-AYwggug&NR=1" target="GENIVideo"> |
| 59 | <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/launch-experiment-video.png?format=raw" alt="Launch Experiment Video" height="120" title="How to configure your experiment" /> </a> |
| 60 | </td> |
| 61 | <td > |
| 62 | <ol> |
| 63 | <li> After Flack finishes loading all the information, create a new slice by clicking <b>New</b> on the left of the screen, right under your user name. Name your slice something like <b>xxxhello</b> (where xxx are your initials)<br></li> |
| 64 | <li> When an empty canvas shows up, you are ready to create an experiment. Click at the <b>Import</b> button on the top of the canvas and select <b>Import from file </b></li> |
| 65 | <li> Find the copy of <a href ="attachment:hellogeni.rspec"> this rspec file</a> that you downloaded earlier and press ok</li> |
| 66 | <li> A topology will come up, it will look different than the topology on the video. Your topology should look like <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/hellogeni-topo.png?format=raw" alt="Login to Flack Video" height="20" title="How to login video" />. Press the <b>Submit</b> button and <b>confirm</b> that you want to reserve these resources.</li> |
| 67 | <li> Wait while your resources are being reserved. This will take several minutes so be patient. When your sliver is ready the background will be green. </li> |
| 68 | </td> |
| 69 | |
| 70 | </tr> |
| 71 | </table> |
| 72 | }}} |
| 73 | |
| 74 | = 3. View your results = |
| 75 | For this example experiment we used the install script facility to automatically install the necessary software and kick-off the experiment. In this very simple setup, we have installed and launched a [http://en.wikipedia.org/wiki/Web_server web server] as well as an [http://en.wikipedia.org/wiki/Iperf iperf server], on the server host. On the client, we have started some processes to test both of these |
| 76 | services. To view the results of this experiment: |
| 77 | |
| 78 | {{{ |
| 79 | #!html |
| 80 | <table border="0"> |
| 81 | |
| 82 | <tr> |
| 83 | <td> |
| 84 | <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/hellogeni-websrv.png?format=raw" alt="Hello GENI index" height="90" title="Hello GENI Web server" /> |
| 85 | </td> |
| 86 | <td > |
| 87 | <ol> |
| 88 | <li> After the background of your slice turns green, press the (i) button that is on the server node icon.</li> |
| 89 | <li> In the information tab that came up, press the <b>Visit</b> button. A new tab should come up that looks like the picture on the side. </li> |
| 90 | <li> Click the <b>Web Server Statistics</b> link to look at statistics. Refresh the page a couple of times to see how the statistics change as the client requests documents.</li> |
| 91 | <li> Click the <b>Logs from the iperf Server</b> link to see the statistics from the iperf transfers.</li> |
| 92 | </ol> |
| 93 | |
| 94 | </td> |
| 95 | </tr> |
| 96 | </table> |
| 97 | }}} |
| 98 | 5. ''' Optional: Manually generate traffic ''' While conducting experiments in GENI, you will often want to run commands directly on the nodes. In this optional step, you will log in to a node and issue commands directly to it. |
| 99 | * Follow [wiki:HowTo/LoginToNodes these instructions] and log in to the client node |
| 100 | * When you have successfully logged in, run this command |
| 101 | {{{ |
| 102 | iperf -c server -P 2 |
| 103 | }}} |
| 104 | This task shouldn't take more than 30 seconds. Change the number after the ` -P ` argument and watch how the performance is affected while you change the number of parallel TCP connections. |
| 105 | * Scroll all the way down the server iperf log, and look at the logs for your transfers |
| 106 | |
| 107 | = 4. Cleanup = |
| 108 | After you are done with your experiment, you should always release your resources so that other experimenters can use |
| 109 | the resources. As shown at the end of the [http://www.youtube.com/watch?v=F5q-AYwggug&feature=youtu.be video for reserving resources], in order to cleanup your slice : |
| 110 | 1. Press the '''Delete''' button in the bottom of your canvas |
| 111 | 1. select "'''Delete at used managers'''" and '''confirm''' your selection. |
| 112 | Wait and after a few moments all the resources will have been released and you will have an empty canvas again. Notice that your slice is still there. There is no way to delete a slice, it will be removed automatically after its expiration date, but remember that a slice is just an empty container so it doesn't take up any resources. |
| 113 | |
| 114 | = 5. What's next? = |
| 115 | Congratulations! You have finished your first GENI Experiment. Now that you are more familiar with GENI concepts you can: |
| 116 | * continue with more [wiki:GENIExperimenter/ExampleExperiments advanced tutorials] |
| 117 | * learn more about how to use Flack by following the [http://www.protogeni.net/trac/protogeni/wiki/FlackTutorial Flack Tutorial] |
| 118 | * start with your own experiment. This tutorial showed you the basic steps for running an experiment. Use Flack to create your own topology, take a look at the [wiki:HowTo/WriteInstallScript instructions about how to write your own install scripts] to automate your expriment. |