Changes between Version 13 and Version 14 of SignMeUp


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

--

Legend:

Unmodified
Added
Removed
Modified
  • SignMeUp

    v13 v14  
    1717}}}
    1818
    19 = Sign Me Up for GENI! =
    2019
    21 Welcome to GENI!
     20[[PageOutline]]
     21= Sign Me Up for the GENI Portal =
     22{{{
     23#!html
     24<table border="0" width="750">
     25     <tr>
     26 
     27       
     28       <td >
     29         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.
     30       </td>
     31       <td align="center">
     32        <a href="https://portal.geni.net">
     33        <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>
     34</td>
     35    </tr>
    2236
    23 This page tells you how to get your GENI credentials so you can start reserving GENI resources.
     37 </table>
     38}}}
    2439
    25 == In a hurry? ==
     40== 1. Login to the Portal ==
    2641
    27 If 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.
     42The GENI Portal leverages InCommon to provide single sign-on authentication.
     43If 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.
    2844
    29 '''Visit [https://www.pgeni.gpolab.bbn.com/newproject.php3 new GENI project page] to start a new project as the project lead.'''
     45=== Check if you can use your Institution's account ===
     46{{{
     47#!html
     48<table border="0" width="1000">
     49   
     50      <tr>
     51         <td >
     52         If you want to check whether you can use your Institution's account to login:
     53         <ul>
     54           <li> Go to <a href="https://portal.geni.net"> the GENI Portal </a> and press the 'Use GENI' button.
     55           </li>
     56           <li>
     57           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.
     58           </li>
     59            <li>
     60           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.
     61           </li>
     62           <li>
     63           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
     64<a href="http://groups.geni.net/geni/wiki/SignMeUpPortal#a2.BecomeamemberofaGENIProject"> join a GENI project </a>.
     65           
     66           </li>
     67       </td>
     68         <td>
    3069
    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.)
     70        <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" />
    3271
    33 == GENI Projects and Experimenters ==
     72       </td>
    3473
    35 Every GENI experimenter must be associated with at least one GENI project.
     74    </tr>
     75 </table>
    3676
    37 A 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
     77}}}
    4078
    41 A 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.
     79=== If your Institution is not a member of InCommon ===
    4280
    43 In 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.
     81If 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].
    4782
    48 == Getting your credentials, step-by-step ==
     83Once 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'.
    4984
    50 GENI credentials identify you as an experimenter and enable you to request GENI resources. Your credentials are for your personal use only.
     85== 2. Become a member of  a GENI Project ==
     86Now 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:
     87  * a faculty member
     88  * or a senior technical member in a company or a university
     89you can become a Project Lead and [#a2b.CreateaGENIProject create your own projects].
    5190
    52 If you are starting a new project, follow the instructions under "New projects."
     91Everyone 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].
    5392
    54 If 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."
     93=== 2a. Join a GENI Project === 
     94After a project is created, you can try and join the project. In order to do that, do the following:
    5595
    56 If you run into trouble along the way, contact the GENI help team at [mailto:help@geni.net].
    5796
    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.
     97{{{
     98#!html
     99<table border="0">
     100   
     101      <tr>
     102        <td>
    65103
    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.
     104        <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>
     105       </td>
     106       <td >
     107         <ol>
     108            <li> In the <i>Home tab</i> click the <b> Join Project</b> button.</li>
     109           <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/>
     110Please make sure you select the right name.</li>
     111           
     112          </ol>
     113       </td>
     114       
     115    </tr>
     116 </table>
     117}}}
     118
     119=== 2b. Create a GENI Project ===
     120A 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.
     121{{{
     122#!html
     123<table border="0">
     124   
     125      <tr>
     126        <td>
     127
     128        <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>
     129       </td>
     130       <td >
     131         <ol>
     132            <li> In the first page of the portal, press the button <b>Ask to be a Project Lead</b>.</li>
     133           <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>
     134            <li> Wait until you receive an email that your request has been approved.</b>
     135            </li>
     136            <li> In the ''Projects'' tab click the <b>Create New Project</b> button.</li>
     137            <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           
     139            <li> <FONT COLOR="black">Press the <b>Create Project</b> button</font>. </li>
     140          </ol>
     141       </td>
     142       
     143    </tr>
     144 </table>
     145}}}
     146 
     147==== Add members to your Project ====
     148When you create a new project for your class you can invite other people to join your project.
     149{{{
     150#!html
     151<table border="0">
     152   
     153      <tr>
     154        <td>
     155
     156        <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>
     157       </td>
     158       <td >
     159         <ol>
     160           <li> From the <i>Project</i> page press the button <b>Invite New Project Members</b>.</li>
     161            <li> <FONT COLOR="black">Fill in the form using both email addresses and press the <b>Invite</b> button.</font>
     162            </li>
     163           
     164            <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>
     165          </ol>
     166       </td>
     167       
     168    </tr>
     169 </table>
     170}}}
    72171
    73172== Now what? ==
    74173
    75 Congratulations! You have your GENI credentials and you're good to go.
     174Congratulations! You have your GENI credentials and you're good to go. Start with trying this simple [wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example Layer 2 example].
    76175
    77 If 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 
    89 Once 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].
     176The portal is still under development and we would love to [mailto:portal-help@geni.net hear your feedback]!