Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/RunHelloGENIProtoGENI


Ignore:
Timestamp:
06/17/13 13:21:08 (7 years ago)
Author:
nriga@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/Tutorials/RunHelloGENIProtoGENI

    v1 v1  
     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
     18Welcome 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 =
     22For 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 =
     50Now 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 =
     75For 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
     76services. 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}}}
     985. ''' 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   {{{
     102iperf -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 =
     108After you are done with your experiment, you should always release your resources so that other experimenters can use
     109the 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.
     112Wait 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? =
     115Congratulations! 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.