wiki:GENIEducation/Resources

Version 2 (modified by nriga@bbn.com, 11 years ago) (diff)

--

Planning a Class in GENI

GENI can provide a great benefit in teaching

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 and has omni installed.
  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

Account Management

Debug problems

Setup your GENI project

In order for you and your students to get access to GENI resources you will need to get GENI accounts. Every GENI experimenter has to be associated with at least one GENI project, so you will have to create one. Currently there are two different ways to get a GENI project. No matter what way you chose to create your project, it is best to create a separate project for each event. For example if you are planning to use GENI for a course make a new project only for that.

  1. Using the GENI portal: Since 2012, GPO has been developing a new ClearingHouse, that presents a unified view of GENI to experimenters and integrates access with various research institutions. The portal is open for use, but keep in mind that it is still under development. To setup your project this way see these instructions
  2. Use pgeni.gpolab.bbn.com: This is an emulab instance that is run by GPO and issues credentials that give you access to all federated GENI resources. This is the main method that we have used so far, so many tutorials and assignments assume these type of accounts. To setup your project this way see these instructions

If you are not sure which method to choose, please send us an email.

Setup access for attendees

Depending on how much control you have over who is attending your GENI event you have two options about how to give access to GENI to the participants:

  1. Personal GENI accounts. If you have control, or you know in advance, who is going to need access to GENI, then you should ask them to join your project and get individual GENI accounts. This approach works best for classes, or in tutorials that pre-registration is required.
  2. Temporary Tutorial accounts. If your event is a one time tutorial, and access to GENI is needed only for the duration of the event then you could ask us to create for you a set of temporary accounts as part of your project. In your email please include:
    1. the name of your project and whether it is a project at pgeni.gpolab.bbn.com or at the GENI portal
    2. the number of temporary accounts you will need
    3. the prefix for your accounts, all accounts will be of the form <prefix>uxx, the prefix should be at most 7 characters long and should be indicative of your event. For example if you are doing a tutorial at SIGCOM 2013, then the prefix can be sig13
    4. the email address that you want us to use as alias for the account email addresses. Each GENI account is associated with an email address so that experimenters can be notified about their GENI resources, in the case of temporary accounts, we associate the email address to an actual email address, in that way you can be notified abou the activity of these accounts.
    5. the date, time and duration of your event

NOTE:For one-time tutorials we suggest a combination of the two above approaches, i.e. you should try to have your attendees get personal accounts before your event, but also have a set of temporary accounts for people that show up at the last moment, or have not done the pre-work before your event.

Presentation material

Over the years we have generated a lot of presentation material that you can reuse, there is no point in starting from scratch.

Intro to GENI talk

Attachments (2)