Changes between Version 17 and Version 18 of SignMeUp


Ignore:
Timestamp:
06/19/13 09:37:04 (11 years ago)
Author:
nriga@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • SignMeUp

    v17 v18  
    11[[PageOutline]]
     2
     3
     4= Sign Me Up for GENI! =
    25{{{
    36#!html
     7<table border="0" width="750">
     8     <tr>
     9 
     10       
     11       <td >
     12         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.
     13       </td>
     14       <td align="center">
     15        <a href="https://portal.geni.net">
     16        <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>
     17</td>
     18    </tr>
    419
    5 <div style="text-align:left; width:571px; margin-left:none; margin-right:auto;">
    6 <img id="Image-Maps_7201210311729283" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/signUp.png?format=raw" usemap="#Image-Maps_7201210311729283" border="0" width="571" height="68" alt="" />
    7 <map id="_Image-Maps_7201210311729283" name="Image-Maps_7201210311729283">
    8 <area shape="poly" coords="15,14,115,12,133,32,120,51,17,50," href="http://groups.geni.net/geni" alt="Wiki Home" title="Wiki Home"   />
    9 <area shape="poly" coords="125,12,142,33,123,52,231,52,253,32,233,15," href="http://groups.geni.net/geni/wiki/GENIExperimenterWelcome" alt="Welcome GENI Experimenters" title="Welcome GENI Experimenters"   />
    10 <area shape="poly" coords="242,13,256,32,237,52,336,56,355,30,332,11," href="http://groups.geni.net/geni/wiki/SignMeUp" alt="Sign Up For a GENI Account" title="Sign Up For a GENI Account"   />
    11 <area shape="poly" coords="344,10,363,29,344,50,540,53,553,31,532,13," href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/RunHelloGENI" alt="Run Hello GENI example" title="Run Hello GENI example"   />
    12 <area shape="rect" coords="569,66,571,68" href="http://www.image-maps.com/index.php?aff=mapped_users_7201210311729283" alt="Image Map" title="Image Map" />
    13 </map>
    14 
    15 </div>
    16            
     20 </table>
    1721}}}
    1822
    19 = Sign Me Up for GENI! =
     23== 1. Login to the Portal ==
    2024
    21 Welcome to GENI!
     25The GENI Portal leverages InCommon to provide single sign-on authentication.
     26If 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.
    2227
    23 This page tells you how to get your GENI credentials so you can start reserving GENI resources.
     28=== Check if you can use your Institution's account ===
     29{{{
     30#!html
     31<table border="0" width="1000">
     32   
     33      <tr>
     34         <td >
     35         If you want to check whether you can use your Institution's account to login:
     36         <ul>
     37           <li> Go to <a href="https://portal.geni.net"> the GENI Portal </a> and press the 'Use GENI' button.
     38           </li>
     39           <li>
     40           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.
     41           </li>
     42            <li>
     43           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.
     44           </li>
     45           <li>
     46           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
     47<a href="http://groups.geni.net/geni/wiki/SignMeUpPortal#a2.BecomeamemberofaGENIProject"> join a GENI project </a>.
     48           
     49           </li>
     50       </td>
     51         <td>
    2452
    25 == In a hurry? ==
     53        <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" />
    2654
    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.
     55       </td>
    2856
    29 '''Visit [https://www.pgeni.gpolab.bbn.com/newproject.php3 new GENI project page] to start a new project as the project lead.'''
     57    </tr>
     58 </table>
    3059
    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.)
     60}}}
    3261
    33 == GENI Projects and Experimenters ==
     62=== If your Institution is not a member of InCommon ===
    3463
    35 Every GENI experimenter must be associated with at least one GENI project.
     64If 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].
    3665
    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
     66Once 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'.
    4067
    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.
     68== 2. Become a member of  a GENI Project ==
     69Now 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:
     70  * a faculty member
     71  * or a senior technical member in a company or a university
     72you can become a Project Lead and [#a2b.CreateaGENIProject create your own projects].
    4273
    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.
     74Everyone 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].
    4775
    48 == Getting your credentials, step-by-step ==
     76=== 2a. Join a GENI Project === 
     77After a project is created, you can try and join the project. In order to do that, do the following:
    4978
    50 GENI credentials identify you as an experimenter and enable you to request GENI resources. Your credentials are for your personal use only.
    5179
    52 If you are starting a new project, follow the instructions under "New projects."
     80{{{
     81#!html
     82<table border="0">
     83   
     84      <tr>
     85        <td>
    5386
    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."
     87        <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>
     88       </td>
     89       <td >
     90         <ol>
     91            <li> In the <i>Home tab</i> click the <b> Join Project</b> button.</li>
     92           <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/>
     93Please make sure you select the right name.</li>
     94           
     95          </ol>
     96       </td>
     97       
     98    </tr>
     99 </table>
     100}}}
    55101
    56 If you run into trouble along the way, contact the GENI help team at [mailto:help@geni.net].
     102=== 2b. Create a GENI Project ===
     103A 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.
     104{{{
     105#!html
     106<table border="0">
     107   
     108      <tr>
     109        <td>
    57110
    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.
     111        <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>
     112       </td>
     113       <td >
     114         <ol>
     115            <li> In the first page of the portal, press the button <b>Ask to be a Project Lead</b>.</li>
     116           <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>
     117            <li> Wait until you receive an email that your request has been approved.</b>
     118            </li>
     119            <li> In the ''Projects'' tab click the <b>Create New Project</b> button.</li>
     120            <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.
     121           
     122            <li> <FONT COLOR="black">Press the <b>Create Project</b> button</font>. </li>
     123          </ol>
     124       </td>
     125       
     126    </tr>
     127 </table>
     128}}}
     129 
     130==== Add members to your Project ====
     131When you create a new project for your class you can invite other people to join your project.
     132{{{
     133#!html
     134<table border="0">
     135   
     136      <tr>
     137        <td>
    65138
    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.
     139        <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>
     140       </td>
     141       <td >
     142         <ol>
     143           <li> From the <i>Project</i> page press the button <b>Invite New Project Members</b>.</li>
     144            <li> <FONT COLOR="black">Fill in the form using both email addresses and press the <b>Invite</b> button.</font>
     145            </li>
     146           
     147            <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>
     148          </ol>
     149       </td>
     150       
     151    </tr>
     152 </table>
     153}}}
    72154
    73155== Now what? ==
    74156
    75 Congratulations! You have your GENI credentials and you're good to go.
     157Congratulations! You have your GENI credentials and you're good to go. Start with trying this simple [wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example Layer 2 example].
    76158
    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].
     159The portal is still under development and we would love to [mailto:portal-help@geni.net hear your feedback]!