[[PageOutline]]

[[Image(wiki:GD:genidesktop.png, align=center, valign=middle)]]

= GENI Desktop and GEMINI Tutorial = 

== Overview: ==
The GEMINI instrumentation and measurement services enables users to quickly add software to their slice that will automatically measure and monitor network traffic and other information about the slice.  GEMINI utilizes 
the GENI Desktop to view and access the measurement information produced by GEMINI.  The GENI Desktop is also integrated with JACKS which can be used to create and modify rspecs 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
 - How to use a slice created at the portal with the GENI Desktop
 - GENI Desktop modules and their usage 
 - Using GEMINI Instrumentation and Measurement framework (graphing tools) in the GENI Desktop.

The purpose of this tutorial is to demonstrate what features GENI Desktop offers . You can use any topology that you desire, but for the purpose of this tutorial, we will be using a simple two VM topology connected via a VLAN with a single aggregate.

=== So 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 provides many function we called '''Modules''' to perform commonly used operations like ssh, file-copy, running a command, rebooting nodes , etc . It also provides graphs and table data for various statistics collected from the nodes in your slice. This done  with the use of GEMINI Instrumentation framework that interacts with your experiment’s resources over the control plane via the [wiki:GENIExperimenter/Tutorials/GENIDesktop/Global_Node Global Node].


== 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 with any 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 supported. Some Java related features may or may not work due to recent browser issues on Google Chrome.


== Where to get help: ==
 - If you need help with GEMINI, or GENI Desktop email [mailto:geni-users@googlegroups.com]

== Tutorial Instructions ==
{{{
#!html
<table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0">
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktop/DesignSetup"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design.png?format=raw" width="152" height="152" alt="Design/Setup"></a>
               </td>
               <td>
<ul> 
             <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktop/DesignSetup">Part I: Design/Setup</a></li>
             <ul>
                 <li>Step 1:  Login to GeniDesktop</li>
                 <li>Step 2:  Create Slice</li>
                 <li>Step 3:  Allocate Resources using JACKS in the GENI Desktop</li>
                 <li>Step 4:  View resources while they are being created</li>
             </ul></ul>
               </td>
	</tr>
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktopExecute"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" width="152" height="143" alt="Execute"></a>
                </td>
		<td>
             <ul>
<li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktop/Execute">Part II: Execute</a></li>
             <ul> 
                 <li>Step 5:  Use GENI Desktop Features </li>
                 <li>Step 6:  Use GEMINI Features </li>
             </ul></ul>
                </td>
	</tr>
	<tr>
		<td>
			<a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktop/Finish"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw" width="152" height="114" alt="Finish"></a>
                </td>
		<td>
             <ul>
             <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GENIDesktop/Finish">Part III: Finish</a></li>
             <ul>
                 <li>Step 7:  Teardown Experiment</li>
             </ul></ul>
                </td>

	</tr>
</table>