= GENI Inter-Aggregate Stitching =

== Overview: ==
This is a tutorial will guide you through a stitching experiment where you will:
 - use flack to modify existing experiment RSpec to generate a stitching RSpec.
 - create a sliver with 3 hosts with one stitched link
 - run an experiment to compare performance between a stitched link connecting two sites and a local link connecting two hosts in the same rack.

== Prerequisites: ==
   - A GENI account, if you don't have one [http://groups.geni.net/geni/wiki/SignMeUp sign up!]
   - Familiarity with how to reserve GENI resources with any of the GENI Tools (GENI Experimenter Portal, Omni, Flack). See the tutorials:
      * Reserving resources using Flack [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/RunHelloGENI tutorial]
      * Reserving resources using Omni [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/HelloOmni tutorial]
   - Familiarity with [http://groups.geni.net/geni/wiki/HowTo/LoginToNodes logging in to GENI compute resources]. 
   - Basic understanding of [http://trac.gpolab.bbn.com/gcf/wiki/Omni Omni tools].
   - Familiarity with Unix Command line.
     
== Tools: ==
 - omni Tools for Mac Os available [http://trac.gpolab.bbn.com/gcf/wiki/MacOS here]
 - or omni Tools for Windows OS available [http://trac.gpolab.bbn.com/gcf/wiki/Windows here]
 - or gcf tools for Linux available [http://trac.gpolab.bbn.com/gcf/wiki here]

== Where to get help: ==
   - If you need help with GENI, or Omni Tools email [mailto:help@geni.net]

== Tutorial Instructions ==
{{{
#!html


<table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0">
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/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>
               </td>
               <td>
<ul> 
             <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/DesignSetup">Part I: Design/Setup</a></li>
             <ul>
                 <li>Step 1:  Download and Import Initial Resource Request RSpec</li>
                 <li>Step 2:  Modify RSpec to include 2 Aggregates with stitched link</li>
                 <li>Step 3:  Run stitcher tool to get resources </li>
             </ul></ul>
               </td>
	</tr>
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Execute"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" width="152" height="143" alt="Execute"></a>
                </td>
		<td>
             <ul>
<li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Execute">Part II: Execute</a></li>
             <ul> 
                 <li>Step 4:  Execute Experiment </li>
             </ul></ul>
                </td>
	</tr>
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Finish"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw" width="152" height="114" alt="Finish"></a>
                </td>

		<td>
             <ul>
             <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Finish">Part III: Finish</a></li>
             <ul>
                 <li>Step 5:  Teardown Experiment</li>
             </ul></ul>
                </td>

	</tr>
</table>