wiki:SarahEdwards/GEC17GettingStartedTutorial

Version 3 (modified by sedwards@bbn.com, 7 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

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? EG does not assign 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
  • Layer 2

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. Reserve resources with omni
  10. Login
  11. Do experiment
  12. Delete resources

Outstanding issues

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