[[PageOutline]]
'''PAGE UNDER CONSTRUCTION'''
= Getting Started with GENI and the GENI Portal  =

== Schedule ==

Sunday, 10:30am - noon

== Session Leaders ==

TBD

== Agenda / Details ==

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

Goal: Complete your first experiment using GENI! 

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

Concepts: Use and understand the following terms: Experimenter, Project, Slice, Aggregate, Resource, RSpecs

Tools: GENI Portal, Flack, ssh & ssh keys

==== Pre-Requisites ====

There are no requirements for this tutorial.

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:GEC17Agenda/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 ====

Start with creating a very simple experiment using Flack (Session 1) and end with learning to instrument experiments using GIMI & GEMINI (Session 3)
Build on concepts learnt in previous tutorials.
By end of Day 1, attendees should feel comfortable running experiments and instrumenting them.  Experimenters should feel comfortable creating slices, reserving resources and using rspecs. 

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)
 * have run their first complete experiment in GENI:
   - 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

At the end of Part II, attendees will:
  * be able to use and understand the following terms:
    - Resource Specification (aka RSpec)
    - sliver
    - Aggregate Manager API (AM API)
  * have run their second complete experiment in GENI:
    - understand how to load a topology from an rspec
    - understand that an RSpec is an XML
    - have edited an RSpec using a tool (Flack) as well as by hand
    - have reserved/deleted resources using a command line tool (omni)
    - know how to have software automatically loaded and run on a compute node
    - have run a simple ''cross-country'' layer 2 experiment
  * have used more than one tool to act on a slice and reserve resources
    - understand that all tools use common mechanisms to describe resources (RSpecs) and to reserve resources (the AM API)
    

== Tutorial materials ==
Instructions: TBD
Slides: TBD