= GENI Inter-Aggregate Stitching =

== Overview: ==
This tutorial will guide you through a stitching experiment where you will:
 - Use Jacks to modify an 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 already have one [https://groups.geni.net/geni/wiki/SignMeUp sign up!]
   - Familiarity with reserving GENI resources with any of the GENI Tools (GENI Experimenter Portal, Omni, Jacks). See Jacks [https://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/jacks/GettingStarted_PartI/Procedure A First Experiment Using GENI and Jacks Tool],  or  Omni [https://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/HelloOmni tutorial]
   - Familiarity with [https://groups.geni.net/geni/wiki/HowTo/LoginToNodes logging in to GENI compute resources]. 
   - Familiarity with the Unix Command line and  [https://github.com/GENI-NSF/geni-tools/wiki Omni tools].
   
== Tools: ==
 - Omni Tools that is part of the gcf software, download it [https://github.com/GENI-NSF/geni-tools/releases/tag/v2.10 here]

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

== Tutorial Instructions ==
{{{
#!html
<table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0">
  <tr>
    <td>
      <a href="https://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/DesignSetup"><img src="https://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="https://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 1 stitched link</li>
                 <li>Step 3:  Run stitcher tool to get resources </li>
             </ul></ul>
               </td>
  </tr>
  <tr>
    <td>
      <a href="https://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Execute"><img src="https://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="https://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="https://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Finish"><img src="https://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="https://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>