| | 1 | {{{ |
| | 2 | #!html |
| | 3 | <table border="0"> |
| | 4 | <tr> |
| | 5 | <td> <a href="http://groups.geni.net/geni/wiki/NikySandbox/GENIExperimenterWelcome-alt"><img border="0" src="http://groups.geni.net/geni/attachment/wiki/NikySandbox/GENIExperimenter/Graphics/welcome-active.png?format=raw" alt="Welcome!" height="25" title="Welcome to GENI for Experimenters." /> </td> |
| | 6 | <td> <pre> </pre> </td> |
| | 7 | |
| | 8 | <td> <a href="http://groups.geni.net/geni/wiki/NikySandbox/GENIExperimenter/SignMeUp"> <img border="0" src="http://groups.geni.net/geni/attachment/wiki/NikySandbox/GENIExperimenter/Graphics/signup-active.png?format=raw" alt="Sign Up!" height="25" title="Get a GENI Account" /> </a> </td> |
| | 9 | <td> <pre> </pre> </td> |
| | 10 | <td> <a href="http://groups.geni.net/geni/wiki/NikySandbox/GENIExperimenter/RunHelloGENI"> <img border="0" src="http://groups.geni.net/geni/attachment/wiki/NikySandbox/GENIExperimenter/Graphics/hellogeni-done.png?format=raw" alt="Run Hello GENI!" height="22" title="Run your first GENI Experiment" /> </a> </td> |
| | 11 | <td> <pre> </pre> </td> |
| | 12 | </tr> |
| | 13 | </table> |
| | 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:NikySandbox/GENIExperimenter/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&feature=g-all-u 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&feature=g-all-u" target="GENIVideo"> |
| | 31 | <img border="0" src="http://groups.geni.net/geni/attachment/wiki/NikySandbox/GENIExperimenter/Graphics/login-to-flack-video.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 utaemulab.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 [attachment: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/NikySandbox/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/NikySandbox/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/NikySandbox/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, <b>press the Visit</b> button. A new tab should come up that looks like the picture on the side. </li> |
| | 90 | <li> Click the <b>webserver 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>iperf logs</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 at the '''Delete''' button in the bottom of your canvas |
| | 111 | 1. select to delete it at '''used managers only''' 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:NikySandbox/GENIExperimenter/Tutorials 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. |
