Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/PortalSimpleLayer2Example/ObtainResources


Ignore:
Timestamp:
03/04/13 17:02:50 (11 years ago)
Author:
sedwards@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GENIExperimenter/Tutorials/PortalSimpleLayer2Example/ObtainResources

    v1 v1  
     1= [wiki:SarahEdwards/Gec16PortalTutorial Getting Started with GENI using the GENI Portal] =
     2{{{
     3#!html
     4<table border="0">
     5   
     6<tr>
     7<td>
     8<img border="0" src="http://groups.geni.net/syseng/attachment/wiki/SarahEdwards/Gec16PortalTutorial/Graphics/design_1.png?format=raw" alt="Experiment Workflow"  height="200" title="Experiment Workflow" />
     9</td>
     10       <td >
     11          <ul>
     12             <li>Part I: Design/Setup</li>
     13             <ul>
     14                 <li><a href="http://groups.geni.net/syseng/wiki/SarahEdwards/Gec16PortalTutorial/SetupAccount">Step 1: Establish Management Environment: Setup your GENI account and join a GENI Project</a></li>
     15                 <li><b><a href="http://groups.geni.net/syseng/wiki/SarahEdwards/Gec16PortalTutorial/ObtainResources">Step 2: Obtain Resources: Create a slice and reserve resources</a></b></li>
     16             </ul>
     17             <li>Part II: Execute</li>
     18             <ul>
     19                 <li> <a href="http://groups.geni.net/syseng/wiki/SarahEdwards/Gec16PortalTutorial/ExecuteExperiment">Execute Experiment: Login to nodes and execute a simple layer 2 experiment</a> </li>
     20             </ul>
     21             <li>Part III: Finish</li>
     22             <ul>
     23                 <li><a href="http://groups.geni.net/syseng/wiki/SarahEdwards/Gec16PortalTutorial/TeardownExperiment">Teardown Experiment: Delete Resources</a></li>
     24             </ul>
     25          </ul>
     26       </td>
     27    </tr>
     28 </table>
     29}}}
     30
     31
     32= Obtain Resources: create a slice and reserve resources =
     33
     34Now that you are a member of a project, you are ready to run your first GENI experiment. For the purpose of this tutorial we are going to do a simple layer 2 experiment. 
     35
     36== 1. Create a slice ==
     37
     38{{{
     39#!html
     40<table border="0">
     41   
     42      <tr>
     43        <td>
     44
     45        <img border="0" src="http://groups.geni.net/syseng/attachment/wiki/SarahEdwards/Gec16PortalTutorial/Graphics/createslice_1.png?format=raw" alt="Create a GENI Slice"  height="200" title="Create a GENI Slice" /> </a>
     46       </td>
     47       <td >
     48         <ol>
     49            <li> Go to the <i>Home</i> tab. </li>
     50           <li> Press the <b>Create Slice</b> button for this project.</li>
     51            <li> <FONT COLOR="black">As a slice name use <code>XXportal</code> where XX is your initials (eg on the left replace ...FIXEME...), you can leave the description empty and press <b>Create Slice</b></font>
     52            </li>
     53 
     54
     55          </ol>
     56       </td>
     57       
     58    </tr>
     59 </table>
     60}}}
     61
     62
     63== 2. Generate and Download SSH Keypair ==
     64Once the slice is created, you will be redirected to a ''Slice'' page.
     65
     66{{{
     67#!html
     68<table border="0">
     69      <tr>
     70        <td>
     71        <img border="0" src="" alt="Generate an SSH Key Pair"  height="120" title="Generate an SSH Key Pair" /> </a>
     72       </td>
     73       <td >
     74         <ol>
     75            <li>From the slice page, select <b>Add Resources</b>.</li>
     76            <li>Since this if the first time you are trying to reserve resources, you should see a warning on the top about not having an SSH key in your account. Access 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.) Click on the <b>Generate and Download SSH Keypair</b> button.</li>
     77           
     78            <li>Press the <b>Download Private Key</b> button</li>
     79            <li> Open a terminal and execute <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>
     80
     81          </ol>
     82       </td>
     83       
     84    </tr>
     85 </table>
     86}}}
     87
     88== 3. Reserve Virtual Machine at First Aggregate ==
     89
     90For this tutorial, we have manually reserved a VLAN (a layer 2 circuit) from a GENI rack in Utah to one in Massachusetts.
     91
     92Reserve a virtual machine connected to the Utah end of the manually configured VLAN.
     93
     94{{{
     95#!html
     96<table border="0">
     97      <tr>
     98        <td>
     99        <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/add-resources-portal.png?format=raw" alt="Create a GENI Project"  height="120" title="Create a GENI Project" /> </a>
     100       </td>
     101       <td >
     102         <ol>
     103           <li> <FONT COLOR="black">Go to the <i>Slices</i> tab and again press the <b>Add Resources</b> button. This time there should be no warning. Complete the form as shown in the picture on the left and press the <b>Reserve Resources</b> button. </font>  This may take awhile (in excess of 30 seconds).  Do not reload the page or press the back button while waiting.</li>
     104         </ol>
     105       </td>
     106      </tr>
     107      <tr>
     108        <td>
     109        <img border="0" src="http://groups.geni.net/syseng/attachment/wiki/SarahEdwards/Gec16PortalTutorial/Graphics/resourcestatus_1.png?format=raw" alt="A VM that is READY"  height="200" title="A VM that is READY" /> </a>
     110       </td>
     111       <td >
     112         <ol>
     113           <li><FONT COLOR="black">Return to the Slice page. Press the <b>Resource Status</b> button in the slice table row for <i>GPO InstaGENI</i>.</font></li>
     114           <li>Periodically reload this page until it says <b>READY</b> with a green background as shown on the left.  </li>
     115          </ol>
     116       </td>
     117    </tr>
     118 </table>
     119}}}
     120
     121
     122== 4. Reserve Virtual Machine at Second Aggregate ==
     123
     124Reserve a virtual machine connected to the Massachusetts end of the manually configured VLAN.
     125
     126{{{
     127#!html
     128<table border="0">
     129      <tr>
     130        <td>
     131        <img border="0" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Graphics/add-resources-portal.png?format=raw" alt="Create a GENI Project"  height="120" title="Create a GENI Project" /> </a>
     132       </td>
     133       <td >
     134         <ol>
     135            <li> <FONT COLOR="black">Go to the <i>Slices</i> tab and again press on the <b>Add Resources</b> button. Complete the form as shown in the picture on the left and press the <b>Reserve Resources</b> button</font>.  Again, this may take awhile.  Do not reload the page or press the back button while waiting.</li>
     136            <li> As before, check the status of this VM until it is <b>READY</b>.</li>
     137          </ol>
     138       </td>
     139       
     140    </tr>
     141 </table>
     142}}}
     143
     144
     145= [wiki:SarahEdwards/Gec16PortalTutorial/ExecuteExperiment Next Part: Execute a Simple Layer 2 Experiment] =