[[Image(genidesktop.png)]][[Image(gemini_logo.png)]]
'''This tutorial is currently outdated but we are actively updating. If you need help with this tutorial please contact: help@geni.net'''
= GENI Desktop and GEMINI Tutorial = 

== '''Tutorial Overview''' ==

This tutorial will introduce you to the GENI Desktop web service
for viewing and working with your slices/experiments.  It will also introduce
you to the instrumentation and measurement services provided by GEMINI which
can be accessed via the GENI Desktop.

The tutorial will begin with a presentation and demonstration of the GENI
Desktop and its features and capabilities, along with a demonstration of the
measurement information available from the GEMINI measurement services.

Following the initial presentation and overview, attendees will be assigned a
set of exercises that they will work through individually to gain experience
using the GENI Desktop and GEMINI.  Each exercise is designed to illustrate a
different feature, or set of features, of the GENI Desktop and GEMINI.

== '''Introductory Slides''' ==

The tutorial introductory slides are available for download as [attachment:GeniDesktop.pdf GeniDesktop.pdf].

== '''Prerequisites''' ==


The tutorial assumes that attendees already have a GENI Portal account and
know how to login and create slices via the GENI Portal or Flack.
The tutorial assumes that attendees have obtained a copy of the user workspace (which will be handed out
at the summer camp).  You will perform all exercises using Firefox in the User Workspace.
For the purposes of this tutorial we will be using the following
[wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_Example_Topology example topology].
Attendees should have created a slice with this topology prior to the start
of the tutorial, or should do it as soon as the tutorial starts.  Note, that
when the slice is created, it must be created with the GEMINI extensions
enabled.

 1. '''Do the [http://groups.geni.net/geni/wiki/APRAGENI/GREE-SC2013/Prework pre-work]'''
 1. '''Obtain a copy of the User Workspace''' (handed out at the summer camp)
 1. '''Setup the [wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_Example_Topology example topology]'''

Related Links: (You may find the information in these pages helpful when doing the exercises)
   a. [wiki:GEMINI/Tutorial/GEC15/Background/VM Getting and using the user workspace]
   a. [wiki:GEMINI/Tutorial/GEC15/Background/Topology Creating an example Topology]
   a. [http://www.protogeni.net/wiki/GeniTutorial GEC 16 Flack, GENI Desktop, and GEMINI Tutorial]

== '''The Excercises''' ==

 1. '''[wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_instrumentize Login to GENI Desktop, Initialize, and Instrumentize your topology]'''
 1. '''[wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_ssh SSH'ing into nodes, generating, and viewing traffic]'''
 1. '''[wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_tables Viewing detailed traffic and configuration information]'''
 1. '''[wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_runcmd Loading and executing code]'''