Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/SetupAccount


Ignore:
Timestamp:
03/12/13 05:16:29 (11 years ago)
Author:
nriga@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/SetupAccount

    v1 v1  
     1
     2= Part I/Step 1: Establish Management Environment =
     3== Table of Contents ==
     4Introduction: [wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example Getting Started with GENI using the GENI Portal]
     5{{{
     6#!html
     7<table id="Table_01" height="205" border="0" cellpadding="0" cellspacing="0">
     8        <tr>
     9                <td>
     10                        <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/SetupAccount"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design_on.png?format=raw" width="76" height="76" alt="Design/Setup"></a>
     11               </td>
     12               <td>
     13<ul>
     14             <li><b>Part I: Design/Setup</b></li>
     15             <ul>
     16                 <li><b><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/SetupAccount">Step 1: Establish Management Environment: Setup your GENI account and join a GENI Project</a></b></li>
     17                 <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/ObtainResources">Step 2: Obtain Resources: Create a slice and reserve resources</a></li>
     18             </ul></ul>
     19               </td>
     20        </tr>
     21        <tr>
     22                <td>
     23                        <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/ExecuteExperiment"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" width="76" height="72" alt="Execute"></a>
     24                </td>
     25                <td>
     26             <ul>
     27<li>Part II: Execute</li>
     28             <ul>
     29                 <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/ExecuteExperiment">Execute Experiment: Login to nodes and execute a simple layer 2 experiment</a> </li>
     30             </ul></ul>
     31                </td>
     32        </tr>
     33        <tr>
     34                <td>
     35                        <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/TeardownExperiment"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw" width="76" height="57" alt="Finish"></a>
     36                </td>
     37
     38                <td>
     39             <ul>
     40             <li>Part III: Finish</li>
     41             <ul>
     42                 <li><a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/TeardownExperiment">Teardown Experiment: Delete Resources</a></li>
     43             </ul></ul>
     44                </td>
     45
     46        </tr>
     47</table>
     48
     49}}}
     50
     51
     52= Instructions =
     53== 1.  Pre-work: Create a GENI account ==
     54{{{
     55#!html
     56<table border="0">
     57   
     58      <tr>
     59
     60       <td >
     61         <ol>
     62            <li> Go to <a href="https://panther.gpolab.bbn.com"> https://panther.gpolab.bbn.com </a> and press the <b> Use GENI </b> button</li>
     63            <li> From the Drop Down menu select your institution. If you got an account through the GENI Identity Provider, please select <b>GENI Project Office</b>.
     64                  <br/><b>Tip:</b> Start typing the name of your institution and see the list become smaller.
     65            </li>
     66            <li> You will be transferred to the Login Page of your institution. Fill in your username and password. </li>
     67            <li> <FONT COLOR="black">Complete the form that appears after you have successfully logged in and press <b>Continue</b>.</font></li>
     68            <li> <FONT COLOR="black">You will be transferred to an <b>Activation Page</b>. Make sure both checkboxes are checked and then press <b>Activate</b></font>. </li>
     69          </ol>
     70       </td>
     71         <td>
     72
     73        <a href="https://panther.gpolab.bbn.com">
     74        <!--img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/login.png?format=raw" alt="Login to GENI"  height="120" title="Use GENI" />  </a>
     75
     76        <br/--><img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/login_1.png?format=raw" alt="Use GENI"  height="200" title="Login to GENI" /> </a>
     77       </td>
     78    </tr>
     79 </table>
     80}}}
     81
     82Congratulations, you have successfully created a GENI account.
     83
     84== 2. Generate and Download SSH Keypair ==
     85
     86Access to compute resources in GENI is provide through ssh key pairs and thus the portal needs a public key to upload to compute resources. For the purposes of the tutorial we will have the portal create an SSH key pair for you. (However, if you prefer to use your personal public key you can choose to upload it.)
     87
     88{{{
     89#!html
     90<table border="0">
     91      <tr>
     92        <td>
     93        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/profile_sshkeys_3.png?format=raw" alt="Generate an SSH Key Pair"  height="180" title="Generate an SSH Key Pair" /> </a>
     94       </td>
     95       <td >
     96         <ol>
     97            <li>Once you are logged in, click on the <i>Profile</i> page.</li>
     98            <li>On the <i>Profile</i> page in the <i>SSH Keys</i> section, select <b>generate and download an SSH keypair</b> button.</li>
     99
     100          </ol>
     101       </td>
     102      </tr>
     103      <tr>
     104       <td >
     105         <ol start='3'>
     106            <li>Enter a passphrase twice, then press <b>Generate SSH private key</b>.</li>
     107          </ol>
     108       </td>
     109        <td>
     110        <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/generate_sshkeys_1.png?format=raw" alt="Generate an SSH Key Pair"  height="230" title="Generate an SSH Key Pair" /> </a>
     111       </td>
     112      </tr>
     113      <tr>
     114        <td>
     115        <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2Example/Graphics/download_sshkeys_1.png?format=raw" alt="Download an SSH Key Pair"  height="280" title="Download an SSH Key Pair" /> </a>
     116       </td>
     117       <td >
     118         <ol start='4'>
     119            <li>Now, press the <b>Download Private Key</b> button</li>
     120            <li>Open a terminal and execute <code>chmod 600 ~/Downloads/id_geni_ssh_rsa</code> and then <code>ssh-add ~/Downloads/id_geni_ssh_rsa</code>.  Later in the tutorial, this will allow you to log into your nodes securely without a password. </li>
     121
     122          </ol>
     123       </td>
     124       
     125    </tr>
     126 </table>
     127}}}
     128
     129== 3. Join a Project ==
     130In order to use the portal to reserve resources, you must join a project.  We have created a project for this tutorial. 
     131
     132{{{
     133#!html
     134<table border="0">
     135   
     136      <tr>
     137       <td >
     138         <ol>
     139            <li> Check your email, you should have an invitation to join a project for this tutorial.<b>*</b></li>
     140            <li>Follow the instructions about joining the project.</li>
     141          </ol>
     142       </td>
     143       
     144    </tr>
     145 </table>
     146}}}
     147
     148Congratulations, you have joined a project!
     149
     150'''*''' If you are not doing this exercise as part of an in-person tutorial please sign up for a [http://groups.geni.net/geni/wiki/SignMeUpPortal GENI account] and join a project.
     151
     152=  [wiki:GENIExperimenter/Tutorials/NSDI13/PortalSimpleLayer2Example/ObtainResources Next: Obtain Resources] =