7 | | The GEMINI instrumentation and measurement services enables users to quickly |
8 | | add software to their slice that will automatically measure and monitor |
9 | | network traffic and other information about the slice. GEMINI utilizes |
10 | | the GENI Desktop to view and access the measurement information produced by |
11 | | GEMINI. The GENI Desktop is also integrated with FLACK which can be used to |
12 | | create and modify slices. |
| 6 | The GEMINI instrumentation and measurement services enables users to quickly |
| 7 | add software to their slice that will automatically measure and monitor |
| 8 | network traffic and other information about the slice. GEMINI utilizes |
| 9 | the GENI Desktop to view and access the measurement information produced by |
| 10 | GEMINI. The GENI Desktop is also integrated with FLACK which can be used to |
| 11 | create and modify slices. |
14 | | Unlike past tutorials, this tutorial is designed to attendees with a quick introduction to the |
15 | | features of GEMINI and the GENI Desktop, but then let them gain hands-on experience by working through |
16 | | a set of tasks at their own pace. Each of the tasks focuses on a different aspect/feature of the GENI Desktop and the |
17 | | GEMINI measurement system. Attendees can pick work on tasks in any order after the slice has been created, initialized, and instrumentized (task 1). |
| 13 | Unlike past tutorials, this tutorial will begin with a presentation and demonstration of the GENI |
| 14 | Desktop and its features and capabilities, along with a demonstration of the |
| 15 | measurement information available from the GEMINI measurement services. |
19 | | == '''The Tutorial''' == |
| 17 | Following the presentation and overview, attendees will be given a |
| 18 | set of exercises that they will work through individually at their own pace to gain experience |
| 19 | using the GENI Desktop and GEMINI. Each exercise is designed to illustrate a |
| 20 | different feature, or set of features, of the GENI Desktop and GEMINI. |
| 21 | Attendees can work on tasks in any order after the slice has been created, initialized, and instrumentized (task 1). |
| 22 | |
| 23 | == '''Introductory Slides''' == |
| 24 | |
| 25 | The introductory slides presented at the beginning of the tutorial are available for download as [attachment:GENIdesktop.pdf GENIdesktop.pdf] |
| 26 | and [attachment:GEMINI_active_measurements.pdf GEMINI_active_measurements.pdf] |
| 27 | |
| 28 | == '''Prerequisites''' == |
| 29 | |
| 30 | The tutorial assumes that attendees already have a GENI Portal account and |
| 31 | know how to login and create slices via the GENI Portal or Flack. |
| 32 | It also assumes that users have obtained a copy of the user workspace from which |
| 33 | they can run Firefox and perform other omni operations if needed. |
| 34 | Attendees should use Firefox in the User Workspace when interacting with the GENI Desktop. |
| 35 | For the purposes of this tutorial we will be using the following |
| 36 | [wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_Example_Topology example topology]. |
| 37 | Attendees should have created a slice with this topology prior to the start |
| 38 | of the tutorial, or should do it as soon as the tutorial starts. Note, that |
| 39 | when the slice is created, it must be created with the GEMINI extensions |
| 40 | enabled. |
| 41 | |
| 42 | 1. Do the [http://groups.geni.net/geni/wiki/APRAGENI/GREE-SC2013/Prework pre-work] |
| 43 | 1. Obtain a copy of the User Workspace |
| 44 | 1. Setup the [wiki:GENIExperimenter/Tutorials/GENI_Desktop_and_GEMINI_Example_Topology example topology] |
22 | | * [http://www.protogeni.net/wiki/GeniTutorial GEC16 - Introduction:] Login to the GENI Desktop, create a slice with FLACK, and view ''passive measurements'' with the GENI Desktop |
23 | | * [http://groups.geni.net/geni/wiki/PhoebusExperimentGEMINI GEC16 - Advanced:] Run a sample experiment and view ''active'' measurements |
| 47 | == '''Exercises/Tasks''' == |
| 48 | |
| 49 | 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_instrumentize Accessing Slices:]''' Login to GENI Desktop, Initialize, and Instrumentize a slice |
| 50 | 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_ssh Viewing Traffic:]''' SSH'ing into nodes, generating, and viewing traffic |
| 51 | 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_tables Detailed Views:]''' Viewing detailed traffic and configuration information |
| 52 | 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_runcmd Running Experiments:]''' Loading and executing code |
| 53 | 1. '''[wiki:GEMINI/Tutorial/GEC17/GENI_Desktop_and_GEMINI_logging Running Experiments:]''' Loading and executing code |
| 54 | |