[[PageOutline]]

[[Image(wiki:GEMINI/Tutorial/Images:genidesktop.png)]]

= GENIDesktop Tutorial @ GEC23 = 

=== What is the GENIDesktop ? ===

The GENIDesktop is a tool that supports multiple ways to “visualize” a slice, and makes it easy to apply an operation to a subset of resources within a slice. It basically uses a file-browser-like interface that users are familiar with. The analogy is selecting files in a file browser and applying an operation (regardless of the “view” – e.g., list view, icon view, detailed view, etc.). GENIDesktop supports extensible functionality we called '''Modules''' that perform commonly used operations like ssh, file-copy, running a command, rebooting nodes , etc, as can also be used to support custom functionality.   It also provides graphs and table data for various statistics collected from the nodes in a slice. This is done  with the use of the GENIDesktop monitoring tools that interact with the experiment’s resources over the control plane via a [wiki:GENIExperimenter/Tutorials/GENIDesktop/Global_Node Global Node]. The GENIDesktop automatically adds software to a slice that will measure and monitor network traffic and other information about the slice.The GENIDesktop is also integrated with JACKS which can be used to create and modify RSPEC topologies.

This tutorial will demonstrate :
 - How to login to the GENI Desktop
 - How to use Slice and Sliver Creation Tools (JACKS) in the GENI Desktop
 - Perform a simple traffic generation and experiment monitoring using the Browser (GENI Desktop GUI)
 - Perform a simple traffic generation and experiment monitoring using the Command Line Tool (gdcli) 

For the purpose of this tutorial, we will be using a simple two VM topology connected via a link within a single aggregate.


== Prerequisites: ==
   - A GENI account, if you don't already have one [http://groups.geni.net/geni/wiki/SignMeUp sign up!]
   - Familiarity with reserving GENI resources using one of the GENI Tools (GENI Experimenter Portal, Jacks). See Jacks [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/jacks/GettingStarted_PartI/Procedure A First Experiment Using GENI and Jacks Tool]
   - Familiarity with the Unix Command line.

NOTE: GENIDesktop pages may not load properly on Smartphones and Tablets. Windows , Linux and MAC are the preferred desktop to be used for this tutorial.   

== Tools: ==
 - latest version of Firefox browser or the Google Chrome browser installed
 - Pop-up blockers and javascript blockers disabled in the browser being used

NOTE: SAFARI on MAC and IE on WINDOWS are not fully supported at this time.


== Where to get help: ==
 - If you need help with GENIDesktop, please email us at [mailto:geni-users@googlegroups.com]

== Tutorial Instructions ==

 === '''!Exercises/Tasks''' ===

 1. ''' Create your Experiment: '''
  * [wiki:GENIExperimenter/Tutorials/GENIDesktop/GEC23/let_me_in Login to GENIDesktop ]
  * [wiki:GENIExperimenter/Tutorials/GENIDesktop/GEC23/create_slice Create your Slice]
  * [wiki:GENIExperimenter/Tutorials/GENIDesktop/GEC23/jacks Allocate Resources using JACKS in the GENIDesktop]
  * [wiki:GENIExperimenter/Tutorials/GENIDesktop/GEC23/ready_init_instr View resources while they are being created, initialized and Instrumentized]
 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/GEC23/GENI_Desktop_runcmd Running Experiments:]''' Load and execute code
 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/GEC23/GENI_Desktop_ssh Viewing Traffic:]''' SSH into nodes, generate and view traffic
 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/GEC23/GENIDesktop_CLI GENIDesktop CLI:]''' Perform GENIDesktop operations using a Command Line Interface.