Changes between Initial Version and Version 1 of sol4/IDMS/ExpTutorial


Ignore:
Timestamp:
06/20/14 09:08:32 (10 years ago)
Author:
ezkissel@indiana.edu
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • sol4/IDMS/ExpTutorial

    v1 v1  
     1
     2{{{
     3#!html
     4<div style="text-align:left; width:571px; margin-left:none; margin-right:auto;">
     5<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="" />
     6<map id="_Image-Maps_7201210311729283" name="Image-Maps_7201210311729283">
     7<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"   />
     8<area shape="poly" coords="125,12,142,33,123,52,231,52,253,32,233,15," href="http://groups.geni.net/geni/wiki/GENIExperimenter" alt="Welcome GENI Experimenters" title="Welcome GENI Experimenters"   />
     9<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"   />
     10<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"   />
     11<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" />
     12</map>
     13
     14</div>
     15}}}
     16
     17[[PageOutline]]
     18= Using IDMS in your slice=
     19
     20{{{
     21#!html
     22<table border="0" >
     23 <tr>
     24    <td width="350" valign="top">
     25<h3 align="left"> <u>Overview: </u> </h3>
     26Welcome to GENI. This page will guide you through your first GENI experiment. <br>This is a very simple tutorial with one server and one client that are connected with a Layer 2 link. <br>
     27<img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/HelloGENIOverviewDiag.png?format=raw" alt="Hello GENI topology"  align="center" height="65" title="Hello GENI topology" />
     28     </td>
     29 <td> <pre>   </pre> </td>
     30    <td width="350" valign="top">
     31<h3 align="left"> <u>Prerequisites: </u></h3>
     32 For this tutorial you need a GENI Experimenter Portal account and be a member of at least one project.
     33    <ul>
     34   <li> If you have a ProtoGENI (emulab) account, then you can follow
     35<a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/RunHelloGENIProtoGENI"> this version</a> of the tutorial. </li>
     36    <li> If you don't have an account yet <a href="http://groups.geni.net/geni/wiki/SignMeUp"> sign up! </a></li>
     37    </ul>
     38
     39    </td>
     40  </tr>
     41  <tr>
     42    <td width="350" valign="top">
     43<h3 align="left"> <u>Tools: </u></h3>
     44All the tools will already be installed at your nodes. For your reference we are going to use:
     45     <ul>
     46       <li> The <a href="http://httpd.apache.org/" target="_blank"> Apache HTTP server </a> and the <a href="http://www.gnu.org/software/wget/" target="_blank"> wget utility </a> </li>
     47       <li> The <a href="http://en.wikipedia.org/wiki/Iperf " target="_blank"> iperf utility </li>
     48      </ul>
     49     </td>
     50 <td> <pre>   </pre> </td>
     51    <td width="350" valign="top">
     52    <h3 align="left"> <u>Where to get help: </u></h3>
     53      For any questions or problem with the tutorial please email <a href="mailto:help@geni.net?Subject=Help%20with%20HelloGENI%20tutorial"> help@geni.net </a>
     54    </td>
     55  </tr>
     56</table>
     57}}}
     58
     59== Step-by-step Instructions ==
     60
     61{{{
     62#!html
     63<table  border="0" cellpadding="0" cellspacing="0">
     64  <tr>
     65     <td valign="top" align="left">
     66        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design.png?format=raw" width="150" alt="Design/Setup"></a>
     67      </td>
     68      <td>
     69         <h3><u> Step 1: Get Ready: </u></h3>
     70         The first thing we need to do is login to the portal.
     71            <table border="0">
     72              <tr>
     73                <td >
     74                 <ol type="a">
     75                   <li> Go to <a href="http://portal.geni.net" target="_blank"> the GENI Experimenter Portal </a> press the <b> Use GENI </b> button</li> and from the Drop Down menu select your institution. If you got an account through the GENI Identity Provider, please select <b>GENI Project Office</b>.
     76                        <br><b>Tip:</b> Start typing the name of your institution and see the list become smaller.
     77                   </li>
     78                   <li> You will be transferred to the Login Page of your institution. <b>Fill in </b>your username and password. </li>
     79                 </ol>
     80                </td>
     81     
     82             </tr>
     83           </table>
     84              <h3><u> Step 2: Launch your experiment: </u></h3>
     85               <table border="0">
     86   
     87      <tr>
     88       
     89       <td >
     90         <ol type="a">
     91             <li> At the portal home page press the <b> create slice </b> from your project.
     92                       <br><b>Tip:</b> If you are not a member of any project and you don't know how to procede, <a href="mailto:help@geni.net?Subject=Help%20with%20HelloGENI%20tutorial"> email us </a>
     93                    </li>
     94            <li> Name your slice something like <b>xxxhello</b> (where xxx are your initials)<br></li>
     95            <li> When the slice page loads up, press the <b> Launch Flack </b> button, and <b>wait</b> until Flack finishes loading; this might take a while.  </li>
     96            <li> Once Flack finishes loading, on the top of the empty canvas on the right, from the <b> Import menu </b> choose the <b> Import from the web </b> option. </li>
     97            <li> Paste this url <a href="http://www.gpolab.bbn.com/experiment-support/HelloGENI/hellogeni-bound.xml" target="_blank"> http://www.gpolab.bbn.com/exp/HelloGENI/hellogeni-bound.xml</a> and click <b>Ok </b>
     98            <li>  A topology will come up. 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>
     99            <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>
     100           </ol>
     101       </td>
     102       <td>
     103         <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/flack_import_rspec.png?format=raw" alt="Import RSpec in Flack"  height="80" title="Flack: Import RSpec" />
     104       </td>
     105    </tr>
     106 </table>
     107               
     108                 
     109          </td>
     110       </tr>
     111</table>
     112}}}
     113
     114{{{
     115#!html
     116<table  border="0" cellpadding="0" cellspacing="0">
     117  <tr>
     118     <td valign="top" align="left">
     119        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" height="150" alt="Execute"></a>
     120      </td>
     121      <td>
     122         <h3><u> Step 3: View Results: </u></h3>
     123         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
     124<a href="[http://en.wikipedia.org/wiki/Web_server" target="_blank"> web server </a> as well as an <a href="http://en.wikipedia.org/wiki/Iperf" target="_blank"> iperf server</a>, on the server host. On the client, we have started some processes to test both of these services. To view the results of this experiment:
     125            <table border="0">
     126              <tr>
     127                <td >
     128                 <ol type="a">
     129            <li> After the background of your slice turns green, press the (i) button that is on the server node icon.</li>
     130            <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>
     131            <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>
     132            <li> Click the <b>Logs from the iperf Server</b> link to see the statistics from the iperf transfers.</li>
     133           </ol>
     134                </td>
     135     
     136             </tr>
     137           </table>
     138              <h3><u> Optional Step 4: Manually generate traffic: </u></h3>
     139             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.
     140              <ol type="a">
     141                 <li>  Follow <a href="http://groups.geni.net/geni/wiki/HowTo/LoginToNodes" target="_blank"> these instructions</a> and log in to the client node </li>
     142                 <li> When you have successfully logged in, run this command:<br>
     143<code>
     144iperf -c server -P 2
     145</code> <br>
     146    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.
     147     </li>
     148   <li> Scroll all the way down the server iperf log, and look at the logs for your transfers </li>
     149   </ol>
     150                     
     151          </td>
     152       </tr>
     153</table>
     154}}}
     155
     156{{{
     157#!html
     158<table  border="0" cellpadding="0" cellspacing="0">
     159  <tr>
     160     <td valign="top" align="left">
     161        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw"  width="150" alt="Execute"></a>
     162      </td>
     163       <td>
     164              <h3><u> Step 5: Cleanup experiment: </u></h3>
     165           After you are done with your experiment, you should always release your resources so that other experimenters can use
     166the resources. In order to cleanup your slice :
     167              <ol type="a">
     168                 <li>Press the <b>Delete</b> button in the bottom of your canvas </li>
     169                 <li> Select <b>Delete at used managers</b> and <b>confirm</b> your selection. </li>
     170              </ol>
     171Wait 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.
     172
     173                     
     174          </td>
     175       </tr>
     176</table>
     177}}}
     178
     179=  What's next? =
     180Congratulations! You have finished your first GENI Experiment. Now that you are more familiar with GENI concepts you can:
     181  * continue with more [wiki:GENIExperimenter/ExampleExperiments advanced tutorials]
     182  * learn more about how to use Flack by following the [http://www.protogeni.net/trac/protogeni/wiki/FlackTutorial Flack Tutorial]
     183  * 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.