[[PageOutline]]

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

= GENIDesktop Tutorial  = 
Updated 3/1/2021
=== 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. GENIDesktop 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 call '''Modules''' that perform commonly used operations like ssh, file-copy, running a command, rebooting nodes and so on.  Modules can also be written to support custom functionality.   GENIDesktop also provides graphs and table data for various statistics collected from the nodes in a slice. The metric collection is performed with the use of the GENIDesktop monitoring tools that interact with the experiment’s resources over the control plane via a [wiki:GeniDesktop/Manual/globalnode 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 GENIDesktop
 - How to use Slice and Sliver Creation Tools (JACKS) in the GENIDesktop
 - Perform a simple traffic generation and experiment monitoring using the Browser (GENIDesktop 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 smart phones or tablets. Windows, Linux and Mac are the preferred platforms 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/05032016/let_me_in Login to GENIDesktop ]
  * [wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/create_slice Create your Slice]
  * [wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/jacks Allocate Resources using JACKS in the GENIDesktop]
  * [wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/ready_init_instr View resources while they are being created, initialized and Instrumentized]
 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/GENI_Desktop_runcmd Running Experiments:]''' Load and execute code
 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/GENI_Desktop_ssh Viewing Traffic:]''' SSH into nodes, generate and view traffic
 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/GENIDesktop_CLI GENIDesktop CLI:]''' Perform GENIDesktop operations using a Command Line Interface. 
 1. '''[wiki:GeniDesktop/Manual GENIDesktop Manual]''' Explore the manual for more details about the GENIDesktop.