| 1 | [[Image(wiki:GEMINI/Tutorial/Images:genidesktop.png)]][[Image(wiki:GEMINI/Tutorial/Images:gemini_logo.png)]] |
| 2 | |
| 3 | = GEC 19 GENI Desktop and GEMINI Tutorial = |
| 4 | |
| 5 | == '''Overview''' == |
| 6 | |
| 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. |
| 13 | |
| 14 | This tutorial will begin with a presentation and demonstration of the GENI |
| 15 | Desktop and its features and capabilities, along with a demonstration of the |
| 16 | measurement information available from the GEMINI measurement services. |
| 17 | |
| 18 | Following the presentation and overview, attendees will be given a |
| 19 | set of exercises that they will work through individually at their own pace to gain experience |
| 20 | using the GENI Desktop and GEMINI. Each exercise is designed to illustrate a |
| 21 | different feature, or set of features, of the GENI Desktop and GEMINI. |
| 22 | Attendees can work on tasks in any order after the slice has been created, initialized, and instrumentized (Exercise/Task 1). |
| 23 | |
| 24 | == '''Introductory Slides''' == |
| 25 | |
| 26 | The introductory slides presented at the beginning of the tutorial are available for download as [attachment:GeniDesktop.pdf GeniDesktop.pdf] |
| 27 | and [attachment:GEMINI_active_measurements.pdf GEMINI_active_measurements.pdf] |
| 28 | |
| 29 | == '''Prerequisites''' == |
| 30 | |
| 31 | The tutorial assumes that attendees already have a GENI Portal account and |
| 32 | know how to login and create slices via the GENI Portal or Flack. |
| 33 | It also assumes that users have the latest version of Firefox browser or the Google Chrome browser installed on their machine. |
| 34 | |
| 35 | NOTE: SAFARI on MAC is not fully supported. |
| 36 | |
| 37 | Alternatively you can obtain a copy of the user workspace from which |
| 38 | you can run Firefox and perform other omni operations if needed. |
| 39 | Attendees should use Firefox or Google Chrome when interacting with the GENI Desktop. |
| 40 | For the purposes of this tutorial we will be using the following |
| 41 | [wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_and_GEMINI_Example_Topology example topology]. |
| 42 | Attendees should have created a slice with this topology prior to the start |
| 43 | of the tutorial, or should do it as soon as the tutorial starts. Note, that |
| 44 | when the slice is created, it must be created with the GEMINI extensions |
| 45 | enabled. |
| 46 | |
| 47 | NOTE: If you plan to do any of the pre-requisites like creating a slice and slivers at the !GeniDesktop, here are the instructions to [wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_login login to the GeniDesktop]. |
| 48 | |
| 49 | 1. Obtain a copy of the User Workspace if needed |
| 50 | 2. Create a Slice . You can use the [https://portal.geni.net Geni Portal] or the [https://genidesktop.netlab.uky.edu GeniDesktop] to do this. |
| 51 | 2. Setup the [wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_and_GEMINI_Example_Topology example topology] using any one of the below mentioned ways. |
| 52 | |
| 53 | NOTE: When using options (b) or (c), the GEMINI Extensions which adds a Global Node has already been done for you.[[BR]] |
| 54 | |
| 55 | a) [wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_and_GEMINI_Example_Topology Using FLACK] at the [https://portal.geni.net Geni Portal] or the [https://genidesktop.netlab.uky.edu GeniDesktop] [[BR]] |
| 56 | b) [wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_and_GEMINI_Example_Topology_g Using GeniDesktop][[BR]] |
| 57 | c) [wiki:GEMINI/Tutorial/GEC19/GENI_Desktop_and_GEMINI_Example_Topology_p Using Geni Portal / ClearingHouse][[BR]] |
| 58 | |
| 59 | |
| 60 | == '''Exercises/Tasks''' == |
| 61 | |
| 62 | To begin the tutorial, click on '''[wiki:GEMINI/Tutorial/GEC19/Tasks Start the Exercises and Tasks]''' |
| 63 | |
| 64 | == '''Past Tutorials''' == |
| 65 | |
| 66 | * You may find information from [wiki:GEMINI/Tutorial past tutorials] to be helpful as well. |
| 67 | |
| 68 | == '''!GeniDesktop FAQ''' == |
| 69 | * We also have an FAQ section listed at [http://groups.geni.net/geni/wiki/GEMINIv3/genidesktop_faq this page] |