wiki:SignMeUpPortal

Version 47 (modified by nriga@bbn.com, 7 years ago) (diff)

--

This page is under construction and the content might still be inaccurate, for any questions please email us!

Sign Me Up for the GENI Portal

Welcome to GENI!
This page tells you how to Sign Up for the GENI Portal. The portal is a web interface to the GENI Clearinghouse that manages GENI users, projects and slices. This account will provide you with the right credentials for using the GENI Testbed.
Login to GENI

1. Login to the Portal

The GENI Portal leverages InCommon to provide single sign-on authentication. If you are affiliated with a US college or University that is a member of the InCommon federation, simply login using your usual username and password to activate your GENI account. If you are not affiliated with an InCommon federated institution, you may request a GENI-only login.

Check if you can use your Institution's account

If you want to check whether your can use your Institution's account to login:
  • Go to the GENI Portal and press the 'Use GENI' button.
  • Start typing your institution's name and if it is a member it will just show up; select it and press 'Continue'. If it does not appear in the list, read on to the next section.
  • Pressing 'Continue' will transfer you to the familiar Login Page of your institution. Log in to your institution using your usual username and password. If you get an error after you login please send us an email with the error you got.
  • If you successfully login, then follow the instructions in the next page, and press 'Activate'.
    Congratulations, now you have access to the GENI Portal
Use GENI

If your Institution is not a member of InCommon

If you were not able to login to the GENI Portal through your Institution, you can request a GENI-only account. In order to do that, please send us an email using the template that follows to this address. Fill in your personal information.

In the email you have to include a hashed password that you can get using the slappasswd command. slappasswd is a command line tool that is available on Macs and probably most Linux distributions. It will generate a string that begins with "{SSHA}". We need that entire string. If you are having problems using this utility please email us.

Make sure that you send us this email from the email account that you want to be associated with your GENI account.

Once you receive an email verifying that we have created an account for you, you can follow the above instructions but as your Institution use 'GENI Project Office'.

Hi,

My name is YOUR_NAME_HERE and I am a YOUR_TITLE_HERE at YOUR_INSTITUTION_HERE. 
I was not able to login to the GENI Portal through my institution and I would like to get a GENI account. 

Here is my personal information:

  * Username (max 8 chars, we can make this up if you don't have a preference)
  * First name 
  * Last name
  * E-mail address
  * Phone number
  * Hashed password

Thanks,
YOUR_NAME_HERE 

2. Become a member of a GENI Project

Now you should be able to login to the portal, however in order to run experiments in GENI you would need to join or create a project, if you are :

  • a faculty member
  • or a senior member in a company

you can become a Project Lead and create your own projects.

Everyone else should join a project created by a Project Lead, you can ask any of your collaborators that fit the above criteria to create a project for you to join.

2a. 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.

Create a GENI Project
  1. In the first page of the portal, press the button Ask to be a Project Lead
  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.
  • In the ''Projects'' tab click the Create New Project button
  • Fill in the form.
    NOTE: The expiration field is optional, you should complete it if you are creating a Project for a class or a tutorial. If you are creating a Project for your own research you don't have to fill in this field.
  • Press the Create Project button
  • Add members to your Projct

    When you create a new project for your class you can invite other people to join your project.

    Create a GENI Project
    1. From the Project page press the button Invite New Project Members
    2. Fill in the form using both email addresses and press the Invite button
    3. Check your email for the request that someone joined your project and follow the instructions to add them to your project. You can decide if this person should be an Admin or a Member. The Admin has the same privileges within a project as a Project Lead (invite people, approve join requests).

    2b. Join a GENI Project

    After a project is created, you can try and join the project. In order to do that, do the following:

    Create a GENI Project
    1. In the Home tab click the Join Project button
    2. From the list of projects find the one that is listed in the piece of paper you have and clink the Join button
      Please make sure you use the right name.

    Now what?

    Congratulations! You have your GENI credentials and you're good to go. Start with trying this simple Layer 2 example.

    The portal is still under development and we would love to hear your feedback!