= Lab One: Understanding the AM API using Named Data Networking  =

== Overview ==

This is a first, simple experiment on GENI useful for familiarizing new experimenters with GENI and the tools for using GENI.

=== What you will learn ===
The high levels goals for this exercise are to:
 1. Understand what happens behind the scenes when you run and experiment in GENI
 1. Learn about RSpecs and the GENI AM API
 1. Learn about the Omni experimenter tool

You will learn these concepts by running an experiment based on the [http://named-data.net Named Data Networking (NDN) Future Internet Architecture].  NDN software will be  installed on the nodes in your network and you will run an application on top of the NDN software that fetches content by name.

Optionally, you can instrument you application using the GENI Desktop to see graphs of traffic on the network links.  This will give you greater insight into when application data is fetched from a  cache and when it comes all the way from a data source. 

=== Experiment Topology and Setup ===

{{{
#!html
<img src="http://groups.geni.net/geni/attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/ccnx_topology_2.png?format=raw" height="252" alt="Tutorial Setup"/>
}}}

Five VMs at the same location connected by Layer 2 links.  One VM is acting as the data source, two VMs are acting as CCN routers, and two VMs are acting as end users.

See also the [wiki:GENIExperimenter/Tutorials/jacks/GettingStarted_PartII_ccn/Procedure/AppendixStitching stitched topology] variation.

== Procedure ==
{{{
#!html


<table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0">
	<tr>
		<td>
			<a href="./Procedure/Setup"><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/Setup">Part I: Design/Setup</a></li>
             <ul>
                 <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/jacks/GettingStarted_PartII_ccn/Procedure/Setup">Using Jacks</a></li>
                 <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/jFed/GettingStarted_PartII_ccn/Procedure/Setup">Using jFed</a></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>
                </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>
                </td>

	</tr>
</table>