= Guidance and Materials for leading the exercise: Simple Layer 2 Experiment Using the GENI Portal =

== Goals for this exercise ==

 1. Do a simple but complete GENI experiment using two aggregates connected by a layer 2 circuit (VLAN)
 2. Learn and use 5 GENI terms: experimenter, project, slice, resource, and aggregate
 3. Use the [http://panther.gpolab.bbn.com GENI Experimenter Portal]

=== Exercise description ===
{{{
#!html
<img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/description.png?format=raw" height="152" alt="Tutorial Setup"/>
}}}

Reserve two VMs across the US from each other connected by a Layer 2 circuit.  

Then send layer 2 traffic between these two nodes (without IP).

== Exercise materials ==
 * Slides with notes ([attachment:GettingStartedGENIPortal_130401.pptx ppt]) and ([attachment:GettingStartedGENIPortal_130401.pdf pdf])
 * [attachment:Generic_PortalTutorialWorksheet.docx Worksheets] for use during the exercise
 * Instructions ([wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example web]) and ([attachment:GettingStartedWithGENIPortal_2rspec_130401.pdf pdf])

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

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

It may be helpful for attendees to have access to their email. 

Please distribute one [attachment:SimpleLayer2_classroomWorksheets.pdf worksheet] to each attendee (or pair of attendees) doing this exercise.  The worksheet does three things:
 1. it helps attendees identify the data (and not the control plane interface) which they will bring down during the tutorial
 2. it ensures slice names are unique
 3. it ensures each attendee (or pair of attendees) use different IP addresses and subnets. (The VLAN used in the tutorial is shared and so IPs need to be deconflicted.)

== Tutorial Instructions ==
[http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example Instructions for the tutorial]