[[Image(genidesktop.png)]][[Image(gemini_logo.png)]] = GEC 17 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 FLACK which can be used to create and modify slices. Unlike past tutorials, this 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 presentation and overview, attendees will be given a set of exercises that they will work through individually at their own pace 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. Attendees can work on tasks in any order after the slice has been created, initialized, and instrumentized (task 1). == '''Introductory Slides''' == The introductory slides presented at the beginning of the tutorial are available for download as [attachment:GENIdesktop.pdf GENIdesktop.pdf] and [attachment:GEMINI_active_measurements.pdf GEMINI_active_measurements.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. It also assumes that users have obtained a copy of the user workspace from which they can run Firefox and perform other omni operations if needed. Attendees should use Firefox in the User Workspace when interacting with the GENI Desktop. For the purposes of this tutorial we will be using the following [wiki:GEMINI/Tutorial/GEC17/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 1. Setup the [wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_Example_Topology example topology] == '''Exercises/Tasks''' == 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_instrumentize Accessing Slices:]''' Login to GENI Desktop, Initialize, and Instrumentize a slice 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_ssh Viewing Traffic:]''' SSH'ing into nodes, generating, and viewing traffic 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_tables Detailed Views:]''' Viewing detailed traffic and configuration information 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_runcmd Running Experiments:]''' Loading and executing code 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_blipp Advanced Monitoring:]''' Instrument applications with NetLogger and BLiPP