[[PageOutline]]

=   [wiki:GEC19Agenda#ConferenceAgenda GEC19] Tutorial: Getting Started with GENI =

== Schedule ==

This tutorial spans two sessions: 
  Monday 11:00am-12:30pm and 1.30pm-3pm

== Session Leaders ==

{{{
#!html
<table  cellspacing=0  style="border:2px solid gray;">
<tr  style="border-style:solid; border-color:gray;" align='center'>
<td> <a href="http://www.geni.net/?page_id=2353"><img src="http://www.geni.net/wp-content/uploads/2012/06/edwards_sarah.jpg" height='120px'/></a></td>
<td><a href="http://www.geni.net/?page_id=1934"><img src="http://www.geni.net/wp-content/uploads/2012/08/riga_niky_1118_edit_crop_180x176web.jpg" height='120px'/></a></td>
<td> <a href="http://www.geni.net/?page_id=293"><img src="http://www.geni.net/wp-content/uploads/2012/08/thomas_vic_0942.gif" height='120px'/></a></td>
</tr>
<tr align='center'  style="border:1px solid gray;">
<td  style="border:1px solid gray;">Sarah Edwards<br/>GPO</td>
<td style="border:1px solid gray;">Niky Riga<br/>GPO</td>
<td style="border:1px solid gray;">Vic Thomas<br/>GPO</td>
</tr>
</table>
}}}


== Agenda / Details ==

This session is for those with little to no experience running experiments on GENI.  Attendees will be introduced to key GENI concepts, will run simple experiments on GENI and learn the basics of debugging their GENI experiments.  By the end of this session participants should feel comfortable running their own experiments on GENI.

== Pre-Requisites ==

None.  Attendees must have done the advance work (getting a GENI account, installing GENI tools, etc) as described in ….

== Tutorial materials ==
Instructions:

Slides: 





'''Complete your first experiment using GENI! '''

Develop a basic understanding of the experiment workflow by doing a simple layer 2 experiment.

While doing this experiment, use and understand the following terms: experimenter, project, slice, aggregate, resource, resource specification (RSpec)

Do the experiment using the following tools: GENI Portal, Flack, ssh & ssh keys

==== Pre-Requisites ====

There are no pre-requisites for this tutorial. 

''This is the first part of a [wiki:GEC18Agenda/GettingStartedWithGENI three part tutorial].  This tutorial or equivalent experience is a pre-requisites for [wiki:GEC18Agenda/GettingStartedWithGENI_II Part II].''

The following background will be helpful for this tutorial:
 * A basic familiarity and comfort with using a UNIX command line
 * A basic understanding of GENI concepts such as those covered in the [wiki:GEC18Agenda/IntroToGENI Introduction to GENI and Experimentation using GENI] talk immediately prior to this tutorial

==== Please Arrive With: ====
 1. Laptop with a recent version of [http://www.virtualbox.org/ Virtual Box]. 
 1. A GENI Experimenter Portal account.

==== Results ====

In Part I, attendees will run their first complete experiment in GENI.

At the end of Part I, attendees will be able to:
 * Use and understand the following terms:
   - Experimenter
   - Project
   - Slice 
   - Aggregate 
   - Resource
   - Resource Specification (aka RSpec)
 * Do the complete experiment workflow:
   - understand how to use their GENI Experimenter Portal account to join a project and create a slice
   - know how to draw an experimental topology and reserve resources using a graphical tool (Flack)
   - know how to log into compute resources using ssh and a private key
   - know how to manually load software onto a compute node
   - have run a simple layer 2 experiment
   - know how to delete resources

== Tutorial materials ==
''Part I''
 * Instructions: [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GettingStarted_PartI/Procedure web]
 * Slides: [attachment: pptx]

''Part II''
 * Instructions: [http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/UnderstandAMAPI/Procedure web]
 * Slides: [attachment: pptx]

Want to do this exercise at home or in the classroom?  
  Complete information for these exercises:
    * [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GettingStarted_PartI Part I]
    * [http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/UnderstandAMAPI Part II]