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

'''If you are planning to lead this as a tutorial, please drop a note to help@geni.net letting us know.'''

== 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])
 * Worksheets for use during the exercise ([attachment:Generic_PortalTutorialWorksheet.docx docx])
 * 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 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]