Changes between Version 16 and Version 17 of SignMeUp

06/17/13 13:15:27 (8 years ago)



  • SignMeUp

    v16 v17  
     19= Sign Me Up for GENI! =
    20 = Sign Me Up for GENI! =
    21 {{{
    22 #!html
    23 <table border="0" width="750">
    24      <tr>
    27        <td >
    28          Welcome to GENI! <br/> 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 experimenters, projects and slices. This account will provide you with the right credentials for using the GENI testbed.
    29        </td>
    30        <td align="center">
    31         <a href="">
    32         <img border="0" src="" alt="Login to GENI"  height="120" title="Use GENI" />  </a>
    33 </td>
    34     </tr>
     21Welcome to GENI!
    36  </table>
    37 }}}
     23This page tells you how to get your GENI credentials so you can start reserving GENI resources.
    39 == 1. Login to the Portal ==
     25== In a hurry? ==
    41 The GENI Portal leverages InCommon to provide single sign-on authentication.
    42 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.
     27If you don't need explanations, you may follow one of the following links. If you're not sure what to do, skip these links for just a minute, and read on.
    44 === Check if you can use your Institution's account ===
    45 {{{
    46 #!html
    47 <table border="0" width="1000">
    49       <tr>
    50          <td >
    51          If you want to check whether you can use your Institution's account to login:
    52          <ul>
    53            <li> Go to <a href=""> the GENI Portal </a> and press the 'Use GENI' button.
    54            </li>
    55            <li>
    56            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.
    57            </li>
    58             <li>
    59            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 <a href="">an email</a> with the error you got.
    60            </li>
    61            <li>
    62            If you successfully login, then follow the instructions in the next page, and press 'Activate'. <br/> <b> Congratulations, now you have access to the GENI Portal. </b> Now you need to
    63 <a href=""> join a GENI project </a>.
    65            </li>
    66        </td>
    67          <td>
     29'''Visit [ new GENI project page] to start a new project as the project lead.'''
    69         <img border="0" src="" alt="Use GENI"  height="120" title="Login to GENI" />
     31'''Visit [ join a GENI project page] to join an existing GENI project.''' (You'll need to know the project name.)
    71        </td>
     33== GENI Projects and Experimenters ==
    73     </tr>
    74  </table>
     35Every GENI experimenter must be associated with at least one GENI project.
    76 }}}
     37A GENI project is a group of people working together for a particular purpose. For example, a project might be associated with
     38 * a particular lab or research group
     39 * a class
    78 === If your Institution is not a member of InCommon ===
     41A GENI project has a single project lead. The project lead is the primary point of contact for any issues with the project. He or she may authorize new experimenters to join the project. A project lead is generally a faculty or senior staff member at a university, or the equivalent at other institutions.
    80 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 fill out the form to [ request a GENI-only account].
     43In order to start a new GENI project, the project lead needs to provide some straightforward information.
     44 * Project name: A brief (up to 16 characters) name for your project, so we can identify it quickly. Including your school name and/or experiment name is helpful. Try to avoid words like "GENI," "project," "test," or "experiment," which don't really help to distinguish among different projects.
     45 * Contact information for the project lead: so we can reach you with questions, or if something seems amiss. Contact information should be accurate.
     46 * Basic information about your project: so we can understand how GENI is being used.
    82 Once you receive an email verifying that we have created an account for you (this may take awhile), you can follow the [wiki:SignMeUpPortal#CheckifyoucanuseyourInstitutionsaccount above instructions] but as your Institution use 'GENI Project Office'.
     48== Getting your credentials, step-by-step ==
    84 == 2. Become a member of  a GENI Project ==
    85 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:
    86   * a faculty member
    87   * or a senior technical member in a company or a university
    88 you can become a Project Lead and [#a2b.CreateaGENIProject create your own projects].
     50GENI credentials identify you as an experimenter and enable you to request GENI resources. Your credentials are for your personal use only.
    90 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 [#a2a.JoinaGENIProject to join].
     52If you are starting a new project, follow the instructions under "New projects."
    92 === 2a. Join a GENI Project === 
    93 After a project is created, you can try and join the project. In order to do that, do the following:
     54If you are joining an existing project, obtain the name of the project from the project lead (usually the responsible faculty member), and follow the instructions under "Existing projects."
     56If you run into trouble along the way, contact the GENI help team at [].
    96 {{{
    97 #!html
    98 <table border="0">
    100       <tr>
    101         <td>
     58=== New projects ===
     59 1. The project lead visits the [ new GENI project page], and provides the requested information.
     60 2. GENI staff review the project request.
     61 3. The project lead is notified via email when the new project is created.
     62 4. The project lead follows the instructions in the notification email to confirm account creation.
     63 5. (Optional) If the project lead has not already had a discussion with the GENI help team, we suggest that he or she contact us at []. This step is not required, but experience shows that projects are much more likely to be successful with a little getting-started advice. Really, we don't bite, and we'll try to help.
     64 6. Project leads may stop here or advise additional team members to join the project, following the steps below.
    103         <img border="0" src="" alt="Create a GENI Project"  height="120" title="Join a GENI Project" /> </a>
    104        </td>
    105        <td >
    106          <ol>
    107             <li> In the <i>Home tab</i> click the <b> Join Project</b> button.</li>
    108            <li> From the list of projects find the one that was created for you or your class and click the <b>Join </b> button. <br/>
    109 Please make sure you select the right name.</li>
    111           </ol>
    112        </td>
    114     </tr>
    115  </table>
    116 }}}
    118 === 2b. Create a GENI Project ===
    119 A GENI account has no privileges 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.
    120 {{{
    121 #!html
    122 <table border="0">
    124       <tr>
    125         <td>
    127         <img border="0" src="" alt="Create a GENI Project"  height="150" title="Create a GENI Project" /> </a>
    128        </td>
    129        <td >
    130          <ol>
    131             <li> In the first page of the portal, press the button <b>Ask to be a Project Lead</b>.</li>
    132            <li> <FONT COLOR="black"> In the <i>Modify Account</i> page that follows, fill in your telephone number; this is necessary for people that want to become Project Leads. Be sure the box at the bottom of the page that says <b>Make me a 'Project Lead' </b> is checked, and press the <b>Modify Account</b> button.</font></li>
    133             <li> Wait until you receive an email that your request has been approved.</b>
    134             </li>
    135             <li> In the ''Projects'' tab click the <b>Create New Project</b> button.</li>
    136             <li> Fill in the form. <br/>NOTE: The <b>expiration</b> field is optional; you should complete it if you are creating a Project for a class or a tutorial and want the project and experiments to expire. If you are creating a Project for your own research you don't have to fill in this field.
    138             <li> <FONT COLOR="black">Press the <b>Create Project</b> button</font>. </li>
    139           </ol>
    140        </td>
    142     </tr>
    143  </table>
    144 }}}
    146 ==== Add members to your Project ====
    147 When you create a new project for your class you can invite other people to join your project.
    148 {{{
    149 #!html
    150 <table border="0">
    152       <tr>
    153         <td>
    155         <img border="0" src="" alt="Create a GENI Project"  height="150" title="Create a GENI Project" /> </a>
    156        </td>
    157        <td >
    158          <ol>
    159            <li> From the <i>Project</i> page press the button <b>Invite New Project Members</b>.</li>
    160             <li> <FONT COLOR="black">Fill in the form using both email addresses and press the <b>Invite</b> button.</font>
    161             </li>
    163             <li>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 <b>Admin</b> or a <b>Member</b>.  The Admin has the same privileges within a project as a Project Lead (invite people, approve join requests). </li>
    164           </ol>
    165        </td>
    167     </tr>
    168  </table>
    169 }}}
     66=== Existing projects ===
     67 1. A new project member joins an existing project by visiting the [ join a GENI project page] and providing the requested information, including the name of the project.
     68 2. The project lead is notified of the request via email.
     69 3. The project lead follows the instructions in the notification email to approve the new user request.
     70 4. The new project member is notified via email when his or her request is approved.
     71 5. The new project member follows the instructions in the notification email to confirm account creation.
    17173== Now what? ==
    173 Congratulations! You have your GENI credentials and you're good to go. Start with trying this simple [wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example Layer 2 example].
     75Congratulations! You have your GENI credentials and you're good to go.
    175 The portal is still under development and we would love to [ hear your feedback]!
     77If you're not sure how to proceed from here, you may want to try one of these GENI tools:
     79'''Flack''' is a graphical user interface for finding and requesting GENI resources. It runs in your browser.
     80 * Visit the [ Flack page].
     81 * Read the [ Flack tutorial].
     82 * Watch these brief !YouTube video tutorials.
     83  * [ GENI Tutorial: How To Log In To Flack]
     84  * [ GENI Tutorial: How to Make a Slice & Reserve Resources]
     86'''Omni''' is a command-line tool for finding and requesting GENI resources. You download omni and run it on your computer.
     87 * Find information on obtaining and using omni at the [ omni how to].
     89Once you are familiar with one of these basic tools, some sample experiments that you may want to try or modify are available at [wiki:GENIExperimenterWelcome].