= [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial GENI Inter-Aggregate Stitching Tutorial] =

{{{
#!html

<div style="text-align:center; width:495px; margin-left:auto; margin-right:auto;">
<img id="Image-Maps_5201305222028436" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Setup.jpg?format=raw" usemap="#Image-Maps_5201305222028436" border="0" width="495" height="138" alt="" />
<map id="_Image-Maps_5201305222028436" name="Image-Maps_5201305222028436">
<area shape="rect" coords="18,18,135,110" href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/DesignSetup" alt="" title=""    />
<area shape="rect" coords="180,18,297,111" href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Execute" alt="" title=""    />
<area shape="rect" coords="344,17,460,110" href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Finish" alt="" title=""    />
<area shape="rect" coords="493,136,495,138" href="http://www.image-maps.com/index.php?aff=mapped_users_5201305222028436" alt="Image Map" title="Image Map" />
</map>
<!-- Image map text links - End - -->

</div>
}}}

= Step 4: Execute Experiment =

To run the experiment we will use:
 - Two terminals to login to the ''"right-client"'' and the ''"left-client"'' VMs
 - One browser to connect to the ''"server"'' VM

But first we must determine which nodes have been allocated to our experiment.


'''1.''' In the first terminal window, use the `readyToLogin` script to determine the login information, and login to ''"right-client"''. If you are following along as part of a tutorial, use the aggregates assigned to you!!
{{{
$ readyToLogin -a rightAggr MySlice
....
$ ssh -i right-client....
...
}}}

  (where ''"rightAggr"'' is the aggregate where you have requested the VM named ''"right-client"''.)

For the experiment in this example we use: 
{{{
$ readyToLogin -a wisconsin-ig MySlice
...
right-client's geni_status is: ready (am_status:ready) 
User lnevers logs in to right-client using:
	ssh -p 32314  -i /Users/lnevers/.ssh/geni_cert_portal_key lnevers@pc2.instageni.wisc.edu

$ ssh -p 32314  -i /Users/lnevers/.ssh/geni_cert_portal_key lnevers@pc2.instageni.wisc.edu
Last login: Thu Mar 13 09:15:18 2014 from 128.89.73.116
[lnevers@right-client ~]$ 
}}}

'''2.''' Open a second terminal window, and use the `readyToLogin` script to determine the login information for ''"left-client"'', and then log in. If you are following along as part of a tutorial use the aggregates assigned to you!!:
{{{
$ readyToLogin -a leftAggr MySlice
...
$ ssh -i left-client....
...
}}}
   (where ''"leftAggr"'' is the aggregate where you have requested the named ''"left-client"''.)

For the experiment in this example we use:
{{{
$ readyToLogin -a stanford-ig MySlice
...

left-client's geni_status is: ready (am_status:ready) 
User lnevers logs in to left-client using:
	ssh -p 31802  -i /Users/lnevers/.ssh/geni_cert_portal_key lnevers@pc1.instageni.stanford.edu

server's geni_status is: ready (am_status:ready) 
User lnevers logs in to server using:
	ssh -i /Users/lnevers/.ssh/geni_cert_portal_key lnevers@pcvm1-15.instageni.stanford.edu

$ ssh -p 31802  -i /Users/lnevers/.ssh/geni_cert_portal_key lnevers@pc1.instageni.stanford.edu
Last login: Thu Mar 13 07:16:54 2014 from 128.89.73.116
[lnevers@left-client ~]$ 
}}}

'''3.''' Start a browser and navigate to the ''"server's"''s hostname from step 2. For this example experiment the hostname allocated is pcvm1-15.instageni.stanford.edu:
 
     [[Image(GENIExperimenter/Graphics:server-web.jpg,75%)]]
 
'''4.''' In the first terminal logged in to ''"right-client"'', install iperf and send traffic to the server over the ''stitched'' path by executing the 2 commands exactly as shown:
{{{
right-client$ sudo yum install iperf -y
right-client$ /usr/bin/iperf -c 10.10.1.2 -t 30 -P 10
}}}

'''5.''' In the second terminal connected to ''"left-client"''. install iperf and send traffic to the server over the ''local'' link by executing the 2 commands exactly as shown:
{{{
left-client$ sudo yum install iperf -y
left-client$ /usr/bin/iperf -c 192.168.1.2 -t 30 -P 10
}}}

'''6.''' Now back in the browser: Refresh the web page and you should see the results from the iperf server. 

   ''Note: '' The interface capacity for all links was set to '' '''20 Mbits/sec''' '' in the RSpec used for this tutorial.

     [[Image(GENIExperimenter/Graphics:server-web2.jpg)]]

The experiment is now completed; time to release resources!

= [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial Introduction] =
= [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/StitchingTutorial/Finish Finish] =