wiki:GENIEducation/SampleAssignments/UnderstandAMAPI/ForInstructors

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

--

Materials and Guidance for leading the exercise: Understanding the AM API

If you are planning to lead this in a classroom, please drop a note to help@geni.net letting us know.

Background information about pre-requisites, tools, resources, and where to get help.

Exercise materials

  • Slides (pptx) and (pdf)
  • Generic worksheets for use during the exercise (docx) Each page of this document references a different aggregate. Make as many copies of these worksheets as you need but keep the distribution across the various aggregates. (That is, for a class of 18 students, make 3 copies of the worksheet document.)
  • Instructions (web) and (pdf)

Guidance for leading the exercise

As soon as possible

  1. As soon as possible, e-mail help@geni.net letting us know you are running this exercise. Doing this will:
    1. allow us to notify GMOC (GENI Operations) that you are running an exercise
    2. give us an opportunity to answer any questions you may have and provide any needed support.
  2. If you don't already it, request to have the project lead permission in the portal. You can request the project lead permission via the "Ask to be a Project Lead" button on the Home page of the portal. It may take a couple of business days for your request to be approved.
  3. Once you have the Project Lead permission, create a project in the portal.
  4. Add any other instructors or teaching assistants to the project and make them Admins.
  5. If you haven't already, you and any other instructors or teaching assistants should read through the slides (including the notes) and work through the exercise and let us know if you have any questions.
  6. Verify that students will have access to a machine that allows them to ssh using a private key. Drop us a note at help@geni.net if you need help with this step.
  7. Verify that students will have access to a machine or VM that has omni installed. Drop us a note at help@geni.net if you need help with this step.

Approximately one week in advance

  1. Invite attendees to login to the portal and request an account from the GENI IdP if necessary. This may require some manual intervention, so it's important that people do this early.
  2. e-mail attendees information about any other pre-work. In particular, they will need a machine that allows them to ssh using a private key.
  3. Make a worksheet for each attendee
  4. If desired, print hardcopies of the exercise and worksheets.

Day of exercise

  1. A few hours before hand, bulk add attendees to the project (doing this in advance makes the exercise go more quickly)
  2. At the exercise, add any stragglers who haven't joined the project by having them clicking the "Request to Join a Project" button on the home page. Then you are one of the project Admins should manually add each of these users to the project.
  3. At the exercise, please distribute:
    1. one worksheet to each attendee (or pair of attendees) doing this exercise. The worksheet does three things:
      1. it helps attendees identify the data (and not the control plane interface) which they will bring down during the exercise
      2. it ensures slice names are unique
    2. a hardcopy of the instructions
    3. Use the slides to cover the background material needed to do the exercise

Attachments (6)