| 1 | [[PageOutline]] |
| 2 | |
| 3 | [[Image(wiki:GEMINI/Tutorial/Images:genidesktop.png)]] |
| 4 | |
| 5 | = GENIDesktop Tutorial @ GEC23 = |
| 6 | |
| 7 | === What is the GENIDesktop ? === |
| 8 | |
| 9 | 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. |
| 10 | |
| 11 | This tutorial will demonstrate : |
| 12 | - How to login to the GENI Desktop |
| 13 | - How to use Slice and Sliver Creation Tools (JACKS) in the GENI Desktop |
| 14 | - Perform a simple traffic generation and experiment monitoring using the Browser (GENI Desktop GUI) |
| 15 | - Perform a simple traffic generation and experiment monitoring using the Command Line Tool (gdcli) |
| 16 | |
| 17 | For the purpose of this tutorial, we will be using a simple two VM topology connected via a link within a single aggregate. |
| 18 | |
| 19 | |
| 20 | == Prerequisites: == |
| 21 | - A GENI account, if you don't already have one [http://groups.geni.net/geni/wiki/SignMeUp sign up!] |
| 22 | - 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] |
| 23 | - Familiarity with the Unix Command line. |
| 24 | |
| 25 | 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. |
| 26 | |
| 27 | == Tools: == |
| 28 | - latest version of Firefox browser or the Google Chrome browser installed |
| 29 | - Pop-up blockers and javascript blockers disabled in the browser being used |
| 30 | |
| 31 | NOTE: SAFARI on MAC and IE on WINDOWS are not fully supported at this time. |
| 32 | |
| 33 | |
| 34 | == Where to get help: == |
| 35 | - If you need help with GENIDesktop, please email us at [mailto:geni-users@googlegroups.com] |
| 36 | |
| 37 | == Tutorial Instructions == |
| 38 | |
| 39 | === '''!Exercises/Tasks''' === |
| 40 | |
| 41 | 1. ''' Create your Experiment: ''' |
| 42 | * [wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/let_me_in Login to GENIDesktop ] |
| 43 | * [wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/create_slice Create your Slice] |
| 44 | * [wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/jacks Allocate Resources using JACKS in the GENIDesktop] |
| 45 | * [wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/ready_init_instr View resources while they are being created, initialized and Instrumentized] |
| 46 | 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/GENI_Desktop_runcmd Running Experiments:]''' Load and execute code |
| 47 | 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/GENI_Desktop_ssh Viewing Traffic:]''' SSH into nodes, generate and view traffic |
| 48 | 1. '''[wiki:GENIExperimenter/Tutorials/GENIDesktop/05032016/GENIDesktop_CLI GENIDesktop CLI:]''' Perform GENIDesktop operations using a Command Line Interface. |