Changes between Initial Version and Version 1 of GEC21Agenda/GettingStartedWithGENI


Ignore:
Timestamp:
09/03/14 17:36:11 (10 years ago)
Author:
sedwards@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GEC21Agenda/GettingStartedWithGENI

    v1 v1  
     1[[PageOutline]]
     2
     3=   [wiki:GEC20Agenda#ConferenceAgenda GEC20] Tutorial: Getting Started with GENI =
     4
     5== Schedule ==
     6
     7This tutorial spans two sessions:
     8  Saturday 2:00pm-3:30pm and 4.00pm-5.30pm
     9
     10== Session Leaders ==
     11
     12{{{
     13#!html
     14<table  cellspacing=0  style="border:2px solid gray;">
     15
     16<tr align='center'>
     17<td> <a href="http://www.geni.net/?page_id=2353"><img src="http://www.geni.net/wp-content/uploads/2012/06/edwards_sarah.jpg" height='120px'/></a></td>
     18<td> <a href="http://www.geni.net/?page_id=293"><img src="http://www.geni.net/wp-content/uploads/2012/08/thomas_vic_0942.gif" height='120px'/></a></td>
     19<td><a href="http://www.geni.net/?page_id=1934"><img src="http://www.geni.net/wp-content/uploads/2012/08/riga_niky_1118_edit_crop_180x176web.jpg" height='120px'/></a></td>
     20</tr>
     21<tr align='center'  style="border:1px solid gray;">
     22
     23<td style="border:1px solid gray;">Sarah Edwards <br/>GPO</td>
     24<td  style="border:1px solid gray;">Vic Thomas<br/>GPO</td>
     25<td style="border:1px solid gray;">Niky Riga <br/>GPO</td>
     26
     27</tr>
     28</table>
     29}}}
     30
     31== Agenda / Details ==
     32
     33This session is for those with little to no experience running experiments on GENI.  Attendees will be introduced to key GENI concepts, will run simple experiments on GENI and learn the basics of debugging their GENI experiments.  By the end of this session participants should feel comfortable running their own experiments on GENI.
     34
     35Part I:
     36Develop a basic understanding of the experiment workflow by doing a simple experiment.  Understand the role of the data and control interfaces on each compute node.
     37
     38Part II:
     39Understand how resources are described and reserved in GENI. Learn how to customize those resources using standard mechanisms. Use multiple tools to act on a slice and reserve resources.
     40
     41''Familiarity with the material presented in this session will be assumed in other tutorials at GEC.''
     42
     43
     44==== Pre-Requisites ====
     45
     46There are no pre-requisites for this tutorial.
     47
     48Attendees should have done the [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/ToolsSetup pre-work] (getting a GENI account, installing GENI tools, etc).
     49
     50The following background will be helpful for this tutorial:
     51 * A basic familiarity and comfort with using a UNIX command line
     52 * A basic understanding of GENI concepts such as those covered in the [wiki:GEC19Agenda/IntroToGENI Introduction to GENI and Experimentation using GENI] talk immediately prior to this tutorial
     53
     54
     55==== Results ====
     56
     57In Part I, attendees will run their first complete experiment in GENI.
     58
     59At the end of Part I, attendees will be able to:
     60 * Use and understand the following terms:
     61   - Experimenter
     62   - Project
     63   - Slice
     64   - Aggregate
     65   - Resource
     66   - Resource Specification (aka RSpec)
     67 * Do the complete experiment workflow:
     68   - understand how to use their GENI Experimenter Portal account to join a project and create a slice
     69   - know how to draw an experimental topology and reserve resources using a graphical tool (Flack)
     70   - know how to log into compute resources using ssh and a private key
     71   - know how to manually load software onto a compute node
     72   - understand the purpose of the control and data interfaces
     73   - know how to delete resources
     74
     75In Part II, attendees will run their second complete experiment in GENI.
     76
     77At the end of Part II, attendees will be able to:
     78  * Use and understand the following terms:
     79    - Resource Specification (aka RSpec)
     80    - sliver
     81    - Aggregate Manager API (AM API)
     82  * Customize the resources they reserve using standard mechanisms:
     83    - understand that a resource specification (RSpec) is an XML file
     84    - understand that resources are reserved using the aggregate manager API (AM API)
     85    - understand how to load a topology using an RSpec
     86    - have edited an RSpec using a tool (Flack) as well as by hand
     87    - have reserved and deleted resources using a command line tool (omni)
     88    - know how to specify the image to load on a compute node
     89    - know how to have software automatically loaded and run on a compute node
     90    - have run a simple layer 2 experiment
     91  * Use multiple tools to act on a slice and reserve resources
     92    - understand that all tools use common mechanisms to describe resources (RSpecs) and to reserve resources (the AM API)
     93  * Understand the strengths of different types of GENI racks
     94
     95
     96== Tutorial materials ==
     97''Part I: A first experiment using GENI''
     98 * Instructions: [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GettingStarted_PartI/Procedure web] [http://groups.geni.net/geni/raw-attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_LabZero_Instr_v3.pdf pdf]
     99 * Slides: [http://groups.geni.net/geni/raw-attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_GettingStarted_PartI_slides_20140620.pptx pptx]
     100 * Worksheets: [http://groups.geni.net/geni/attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_GettingStarted_PartI_Worksheet_EG_140123.docx docx] [http://groups.geni.net/geni/attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_GettingStarted_PartI_Worksheet_EG_140123.pdf pdf]
     101
     102''Working with Collaborators''
     103 * Slides: [http://groups.geni.net/geni/raw-attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_GettingStarted_Part3_v4.pptx pptx] (starts on slide 30)
     104
     105
     106''Break for Lunch''
     107
     108''Part II: Understanding the AM API using a simple experiment''
     109 * Instructions: [wiki:GENIExperimenter/Tutorials/GettingStarted_PartII_ccn/Procedure/Setup web] [http://groups.geni.net/geni/raw-attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_LabOne_Instr_v1.pdf pdf]
     110   * Appendix: [wiki:GENIExperimenter/Tutorials/GettingStarted_PartII_ccn/Procedure/Execute/GEMINI web] [http://groups.geni.net/geni/raw-attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_LabOne_Appendix_Instr_v1.pdf pdf]
     111 * Slides: [attachment:GEC20_GettingStarted_PartII_slides_v2.pptx pptx]
     112 * Worksheets: [http://groups.geni.net/geni/attachment/wiki/GEC20Agenda/GettingStartedWithGENI/UnderstandAMAPIWorksheet_IGonly_rework_140619a.docx docx]
     113
     114''Getting started with your own experiment''
     115 * Advanced Topics
     116 * Solving Common Issues
     117 * Getting Help
     118 * Slides: [http://groups.geni.net/geni/raw-attachment/wiki/GEC20Agenda/GettingStartedWithGENI/GEC20_GettingStarted_Part3_v4.pptx pptx]
     119
     120Want to do this exercise at home or in the classroom?  Complete information for these exercises is available.
     121    * [http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/GettingStarted_PartI Part I]
     122{{{
     123#!comment
     124    * [http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/UnderstandAMAPI Part II]
     125}}}