[[PageOutline]]
= Understanding the GENI AM API through a simple experiment =


== Overview ==

=== What you will learn ===

At the end of this exercise, you will be able to:
  * Use and understand the following terms:
    - Resource Specification (aka RSpec)
    - sliver
    - Aggregate Manager API (AM API)
  * Customize the resources they reserve using standard mechanisms:
    - understand that a resource specification (RSpec) is an XML file
    - understand that resources are reserved using the aggregate manager API (AM API)
    - understand how to load a topology using an RSpec
    - have edited an RSpec using a tool (Flack) as well as by hand
    - have reserved and deleted resources using a command line tool (omni)
    - know how to specify the image to load on a compute node
    - know how to have software automatically loaded and run on a compute node
    - have run a simple layer 2 experiment
  * Use multiple tools to act on a slice and reserve resources
    - understand that all tools use common mechanisms to describe resources (RSpecs) and to reserve resources (the AM API)
  * Understand the strengths of different types of GENI racks

== Experiment Topology and Setup ==
{{{
#!html
<img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2ExampleOneAM/Graphics/vms-on-lan.png?format=raw" height="152" alt="Tutorial Setup"/>
}}}

Use the Omni GENI client to reserve two VMs connected by a Layer 2 circuit.  

Then arrange for automatic installation and execution of software on these nodes (performing basic traffic measurement tests), and manually log in to inspect the results.

== Procedure ==
{{{
#!html


<table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0">
	<tr>
		<td>
			<a href="./Procedure/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="./Procedure/DesignSetup">Part I: Design/Setup</a></li>
             <ul>
                 <li>Step 1:  Design Experiment</li>
                 <li>Step 2:  Establish Management Environment</li>
                 <li>Step 3:  Obtain Resources</li>
             </ul></ul>
               </td>
	</tr>
	<tr>
		<td>
			<a href="./Procedure/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="./Procedure/Execute">Part II: Execute</a></li>
             <ul> 
                 <li>Step 4:  Configure and Initialize Services </li>
                 <li>Step 5:  Execute Experiment </li>
                 <li>Step 6:  Analyze and Visualize Experiment </li>
             </ul></ul>
                </td>
	</tr>
	<tr>
		<td>
			<a href="./Procedure/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="./Procedure/Finish">Part III: Finish</a></li>
             <ul>
                 <li>Step 7:  Teardown Experiment</li>
                 <li>Step 8:  Archive Experiment</li>
             </ul></ul>
                </td>

	</tr>
</table>