Changes between Version 16 and Version 17 of SignMeUp


Ignore:
Timestamp:
06/17/13 13:15:27 (6 years ago)
Author:
nriga@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • SignMeUp

    v16 v17  
    1717}}}
    1818
     19= Sign Me Up for GENI! =
    1920
    20 = Sign Me Up for GENI! =
    21 {{{
    22 #!html
    23 <table border="0" width="750">
    24      <tr>
    25  
    26        
    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="https://portal.geni.net">
    32         <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/use-geni.png?format=raw" alt="Login to GENI"  height="120" title="Use GENI" />  </a>
    33 </td>
    34     </tr>
     21Welcome to GENI!
    3522
    36  </table>
    37 }}}
     23This page tells you how to get your GENI credentials so you can start reserving GENI resources.
    3824
    39 == 1. Login to the Portal ==
     25== In a hurry? ==
    4026
    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  [http://www.incommon.org/federation/info/all-entities.html 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.
    4328
    44 === Check if you can use your Institution's account ===
    45 {{{
    46 #!html
    47 <table border="0" width="1000">
    48    
    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="https://portal.geni.net"> 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="mailto:portal-help@geni.net">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="http://groups.geni.net/geni/wiki/SignMeUpPortal#a2.BecomeamemberofaGENIProject"> join a GENI project </a>.
    64            
    65            </li>
    66        </td>
    67          <td>
     29'''Visit [https://www.pgeni.gpolab.bbn.com/newproject.php3 new GENI project page] to start a new project as the project lead.'''
    6830
    69         <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/portal-login-bu.png?format=raw" alt="Use GENI"  height="120" title="Login to GENI" />
     31'''Visit [https://www.pgeni.gpolab.bbn.com/joinproject.php3 join a GENI project page] to join an existing GENI project.''' (You'll need to know the project name.)
    7032
    71        </td>
     33== GENI Projects and Experimenters ==
    7234
    73     </tr>
    74  </table>
     35Every GENI experimenter must be associated with at least one GENI project.
    7536
    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
    7740
    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.
    7942
    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 [https://portal.geni.net/idp/request.html 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.
    8147
    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 ==
    8349
    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.
    8951
    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."
    9153
    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."
    9455
     56If you run into trouble along the way, contact the GENI help team at [mailto:help@geni.net].
    9557
    96 {{{
    97 #!html
    98 <table border="0">
    99    
    100       <tr>
    101         <td>
     58=== New projects ===
     59 1. The project lead visits the [https://www.pgeni.gpolab.bbn.com/newproject.php3 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 [mailto:help@geni.net]. 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.
    10265
    103         <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/portal_join_project.png?format=raw" 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>
    110            
    111           </ol>
    112        </td>
    113        
    114     </tr>
    115  </table>
    116 }}}
    117 
    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">
    123    
    124       <tr>
    125         <td>
    126 
    127         <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/create-project-empty.png?format=raw" 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.
    137            
    138             <li> <FONT COLOR="black">Press the <b>Create Project</b> button</font>. </li>
    139           </ol>
    140        </td>
    141        
    142     </tr>
    143  </table>
    144 }}}
    145  
    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">
    151    
    152       <tr>
    153         <td>
    154 
    155         <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/invite-members-portal.png?format=raw" 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>
    162            
    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>
    166        
    167     </tr>
    168  </table>
    169 }}}
     66=== Existing projects ===
     67 1. A new project member joins an existing project by visiting the [https://www.pgeni.gpolab.bbn.com/joinproject.php3 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.
    17072
    17173== Now what? ==
    17274
    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.
    17476
    175 The portal is still under development and we would love to [mailto:portal-help@geni.net hear your feedback]!
     77If you're not sure how to proceed from here, you may want to try one of these GENI tools:
     78
     79'''Flack''' is a graphical user interface for finding and requesting GENI resources. It runs in your browser.
     80 * Visit the [http://www.protogeni.net/trac/protogeni/wiki/Flack Flack page].
     81 * Read the [https://www.protogeni.net/trac/protogeni/wiki/FlackTutorial Flack tutorial].
     82 * Watch these brief !YouTube video tutorials.
     83  * [http://youtu.be/-XF6wyNu1BE?hd=1 GENI Tutorial: How To Log In To Flack]
     84  * [http://youtu.be/F5q-AYwggug?hd=1 GENI Tutorial: How to Make a Slice & Reserve Resources]
     85
     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 [http://groups.geni.net/geni/wiki/HowToUseOmni omni how to].
     88
     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].