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


Ignore:
Timestamp:
06/06/13 10:59:30 (7 years ago)
Author:
sedwards@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/Tutorials/GREESC13/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/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/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/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/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/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://portal.geni.net"> https://portal.geni.net </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://portal.geni.net">
     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/portal_login.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 provided 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 the same 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:
     121<pre>
     122$ mv ~/Downloads/id_geni_ssh_rsa ~/.ssh/.
     123$ chmod 600 ~/.ssh/id_geni_ssh_rsa
     124$ ssh-add ~/.ssh/id_geni_ssh_rsa
     125</pre>
     126Later in the tutorial, this will allow you to log into your nodes securely without a password. </li>
     127
     128          </ol>
     129       </td>
     130       
     131    </tr>
     132 </table>
     133}}}
     134
     135== 3. Join a Project ==
     136In order to use the portal to reserve resources, you must join a project.  We have created a project for this tutorial. 
     137
     138{{{
     139#!html
     140<table border="0">
     141   
     142      <tr>
     143       <td >
     144         <ol>
     145            <li> Check your email, you should have an invitation to join a project for this tutorial.<b>*</b></li>
     146            <li>Follow the instructions about joining the project.</li>
     147          </ol>
     148       </td>
     149       
     150    </tr>
     151 </table>
     152}}}
     153
     154Congratulations, you have joined a project!
     155
     156'''*''' 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.
     157
     158=  [wiki:GENIExperimenter/Tutorials/PortalSimpleLayer2Example/ObtainResources Next: Obtain Resources] =