wiki:SarahEdwards/GEC17GettingStartedTutorial

Version 6 (modified by sedwards@bbn.com, 11 years ago) (diff)

--

Getting Started with GENI - Part I

Goal

  • the instant gratification of doing "Hello GENI"

Overview

  • doing a single aggregate, Layer 2 experiment
  • use and understand 5 terms
  • using two basic GENI tools: Experimenter Portal and Flack

Concepts

  • Layer 2 with a rack

Terms

5 terms:

  1. Experimenter
  2. Project
  3. Slice
  4. Aggregate
  5. Resource (with mention of resource specification/RSpecs)

Tools

  • GENI Experimenter Portal
  • Flack
  • ssh & ssh keys

Rough procedure

  1. Login to Portal
  2. join GEC17 project (maybe this is prework?)
  3. Create slice
  4. Launch Flack, look around and draw sample topology
  5. Draw two VMs with a link (tell them which site to use)
  6. ssh into the nodes
  7. download and compile pingPlus
  8. run the listener and the sender
  9. Delete resources

Outstanding issues

  • What about IP addresses? ExoGENI not allow you to change IP addresses
  • Non-Portal accounts?

Getting Started with GENI - Part II

Goal

  • How to write a (first) RSpec (that automates startup)
  • Pulling back the covers: RSpecs & AM API (aka "all tools are created equal")

Overview

  • doing a two aggregate, Layer 2 experiment
  • use and understand 3 terms
  • using two basic GENI tools: (Experimenter Portal and ) Flack and omni

Concepts

  • AM API
  • customized RSpec
    • image
    • boot script
  • Layer 2 across country

Terms

3 terms:

  1. RSpec (again)
  2. Sliver
  3. AM API
  4. others?

Tools

  • (GENI Experimenter Portal)
  • Flack
  • omni

Rough procedure

  1. Launch Flack and load Part I slice
    • if not in Part I create a slice
  2. Load the topology from an rspec
    • load not reserve
  3. Look at the rspec document
  4. Add custom image and look rspec
  5. Add download/install services and look at rspec
  6. Quickly go over the script
  7. Save RSpec to a file
  8. (optional) Do a minor edit to the RSpec (eg edit client_id)
  9. Run rspeclint on edited RSpec
  10. Reserve resources with omni
  11. Login
  12. Do experiment
  13. Delete resources

Outstanding issues

  • pipe VLANs and/or use GENI for ExoGENI aggregates? What about other InstaGENI aggregates?