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

== Experiment Description ==
{{{
#!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.

== Prerequisites ==
In order to participate in this tutorial you need to have an account at an InCommon institution or from the GPO. If you haven't done so before, please [http://groups.geni.net/geni/wiki/SignMeUpPortal sign in to the GENI Portal]. 

Make sure you know which institution will provide you access to GENI and the username and password you need to authenticate. If you don't know, please let us know. 

It may be helpful for you to have access to your email. 

== 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/GEC17Agenda/GettingStartedWithGENI_II/SetupAccount"><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>Part I: Design/Setup</li>
             <ul>
                 <li><a href="http://groups.geni.net/geni/wiki/GEC17Agenda/GettingStartedWithGENI_II/SetupAccount">Step 1: Establish Management Environment: Setup your GENI account and join a GENI Project</a></li>
                 <li><a href="http://groups.geni.net/geni/wiki/GEC17Agenda/GettingStartedWithGENI_II/ObtainResources">Step 2: Obtain Resources: Create a slice and reserve resources</a></li>
             </ul></ul>
               </td>
	</tr>
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GEC17Agenda/GettingStartedWithGENI_II/ExecuteExperiment"><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>Part II: Execute</li>
             <ul> 
                 <li><a href="http://groups.geni.net/geni/wiki/GEC17Agenda/GettingStartedWithGENI_II/ExecuteExperiment">Execute Experiment: Login to nodes and inspect automatic execution results.</a> </li>
             </ul></ul>
                </td>
	</tr>
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GEC17Agenda/GettingStartedWithGENI_II/TeardownExperiment"><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>Part III: Finish</li>
             <ul>
                 <li><a href="http://groups.geni.net/geni/wiki/GEC17Agenda/GettingStartedWithGENI_II/TeardownExperiment">Teardown Experiment: Delete Resources</a></li>
             </ul></ul>
                </td>

	</tr>
</table>

}}}