= Lab Zero: A First Experiment Using GENI and Jacks Tool =

== Overview ==

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

The IP Routing portion of this assignment has been provided by [http://www-net.cs.umass.edu/~zink/umasshome/pmwiki.php Mike Zink]

=== What you will learn ===
The high levels goals for this exercise are to:
 1. Do a simple but complete GENI experiment
 2. Learn and use 5 GENI terms: experimenter, project, slice, resource, and aggregate
 3. Use the [http://portal.geni.net GENI Experimenter Portal] and Jacks

Specifically, during this exercise you will:
 * Use your GENI account for the first time and do some one time setup
   - Login to the GENI Experimenter Portal for the first time
   - Join a Project
   - Specify `ssh` keys for use logging into resources
 * Learn how to reserve, login to, and release resources in GENI
   - Create and renew a slice
   - Generate and reserve your own topology of GENI resources using Flack
   - Learn how to login to compute resources using `ssh`
   - Learn how to delete resources in GENI
 * Understand the difference between the control and data plane interfaces on each node
 * Use these resources to do a very simple first experiment
   - Use `ping` to test connectivity between the reserved resources
   - Use `ifconfig` to identify your data and control plane interfaces

=== Experiment Topology and Setup ===

{{{
#!html
<img border="0" src="https://groups.geni.net/geni/attachment/wiki/GENIEducation/SampleAssignments/IPRouting/Procedure/routetopology.png?format=raw" alt="route topology"  align="center" width="350" title="route topology" /> 
}}}

Reserve three VMs at the same location connected in a triangle topology.  

== Background ==

[wiki:GENIExperimenter/Tutorials/GettingStarted_PartI/Background Background information] about pre-requisites, tools, resources, and where to get help.


== Procedure ==
{{{
#!html


<table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0">
	<tr>
		<td>
			<a href="./Procedure/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="./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="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="./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="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="./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>