wiki:NikySandbox/SIGSCETutorial

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

--

Prework

In order to participate in this tutorial you need to have an account at an InCommon institution. If you don't already have an account please follow [these instructions].

Make sure you know which institution will provide you access to GENI and the username and password you need to authenticate. If you don't know, please let us know.

Make sure that you have access to your email.

1. Create a GENI account

  1. Go to http://panther.gpolab.bbn.com and press the Use GENI button
  2. From the Drop Down menu select your institutions. If you got an account through the GENI Identity Provider, please select GENI Project Office
    NOTE: Make sure that you do not choose the GENI Project Office (internal)
    Tip: Start typing the name of your institution and see the list become smaller.
  3. You will be transferred in the Login Page of your institution. Fill in your username and password.
    PAUSE BEFORE YOU PRESS THE CONTINUE BUTTON UNTIL SARAH SAYS GO
  4. Complete the form that appears after you have successfully logged in and press Continue.
    PAUSE BEFORE YOU PRESS THE ACTIVATE BUTTON UNTIL SARAH SAYS GO
  5. You will be transferred to an Activation Page. Make sure both checkboxes are checked and then press Activate

Congratulations, you have successfully created a GENI account.

2. Create a GENI Project

A GENI account has no priviledges outside of a Project, i.e. as long as you are not a member of a GENI Project you can not use any GENI resources. In GENI only Project Leads can create Projects. Any faculty member, or a person in a corresponding position in industry, can request to become a Project Lead and thus have the capability of creating GENI Projects.

  1. In the first page of the portal, press the button Ask to be a Project Lead
    PAUSE BEFORE YOU PRESS THE MODIFY ACCOUNT BUTTON UNTIL SARAH SAYS GO
  2. In the Modify Account page that showed up, fill in your telephone number; this is necessary for people that want to become Project Leads. Also check the box at the bottom of the page that says Make me a 'Project Lead' and press the Modify Account button.
  3. Wait until you receive an email that your request has been approved.
  4. In the My Projects page click the Create New Project button
Fill in the form as follows : Make sure to complete the expiration field
Project Name scaleTest<your initials>
Purpose test scaling
Expiration 02/22/2013


PAUSE BEFORE YOU PRESS THE CREATE PROJECT BUTTON UNTIL SARAH SAYS GO

  1. Press the Create Project button

Congratulations you have created a project

3. Invite people to join your project

When you create a new project for your class, you would want to add the TA and the students in your class.

  1. From the Project page press the button Invite New Project Members
  2. Ask another person in the room for their email address, and fill in the form.
    PAUSE BEFORE YOU PRESS THE BUTTON UNTIL SARAH SAYS GO
  3. Press the Invite button
  4. Check your email, you might have an invitation from another user
  5. Follow the instructions about joining their project
  6. Check your email for the request that someone joined your project and follow the instructions to add them to your project. You can decide what privileges you want to give to your new user. Probably you would like to make a TA an admin, while the students should be plain members.

Congratulations, you added your collaborators to your project!

4. Join an existing project

[EXTRA STEP JUST FOR SCALING ITS GOING TO BE REMOVED FOR SIGSCE]

  1. Go to the Projects Tab
  2. Press the Join the Project button
    PAUSE BEFORE YOU PRESS THE BUTTON UNTIL SARAH SAYS GO
  3. From the list of projects find the one named 'tutorial' and press Join

5. Create an experiment

Now that your project is all setup, you are ready to run your first GENI experiment. For the purpose of this tutorial we are going to use a sample assignment that compares a UDP based transfer protocol with a TCP one.

  1. Go to the Home tab
  2. In the project that you created press the Create Slice button
    PAUSE BEFORE YOU PRESS THE BUTTON UNTIL SARAH SAYS GO
  3. As a slice name use pt<your initials>, you can leave the description empty and press Create Slice
  4. Select Add Resources
    PAUSE BEFORE YOU SUBMIT UNTIL WE WILL TAKE TURNS IN CREATING SLIVERS
  5. Complete the form as follows:
Choose Resources UDT Tutorial
Choose Aggregate ProtoGENI Utah
  1. Press the Reserve Resources button

While we are waiting for our resources to be reserved and configured lets explore some other capabilities of the portal.

  1. Go to the slices tab
    PAUSE BEFORE YOU PRESS THE BUTTON UNTIL SARAH SAYS GO
  2. Select the Launch Flack button

5. Run your experiment

6. Delete your experiment