Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/jacks/GettingStarted_PartII_ccn/Procedure/AppendixStitching


Ignore:
Timestamp:
06/14/15 19:22:06 (9 years ago)
Author:
sedwards@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GENIExperimenter/Tutorials/jacks/GettingStarted_PartII_ccn/Procedure/AppendixStitching

    v1 v1  
     1= Creating Inter-aggregate Links =
     2
     3{{{
     4#!html
     5<table border="0" >
     6 <tr>
     7    <td width="350" valign="top">
     8
     9<h3 align="left"> <u>Overview: </u> </h3>
     10In this experiment you will learn how to draw topologies that connect nodes at different aggregates (in different geographic locations). We will use the following network topology for this experiment:
     11<br>
     12<img border="0" src="http://groups.geni.net/geni/raw-attachment/wiki/Tutorials/Stitching/Procedure/Topology.png" alt="route topology"  align="center" width="350" title="topology" />
     13     </td>
     14 <td> <pre>   </pre> </td>
     15    <td width="350" valign="top">
     16<h3 align="left"> <u>Prerequisites: </u></h3>
     17 For this tutorial you need :
     18   <ul>
     19       <li> <b> access to the <a href="https://portal.geni.net"> GENI Experimenter Portal </a></b> and be a <b> member of a GENI project </b>. <br/>Please see the <a href="http://groups.geni.net/geni/wiki/SignMeUp"> Sign Me Up page for more information. </a></li>
     20       <li>  be familiar with <b><a href="http://groups.geni.net/geni/wiki/HowTo/LoginToNodes" > logging in to GENI resources </a> </b> </li>
     21       <li> This is intended as a logical follow on to introductory exercises like do the <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/RunHelloGENI"> Hello GENI </a> or <a href="http://groups.geni.net/geni/wiki/GENIExperimenter/Tutorials/jacks/GettingStarted_PartI/Procedure"> Lab Zero </a> </li>
     22   </ul>
     23
     24</td>
     25  </tr>
     26  <tr>
     27    <td width="350" valign="top">
     28<h3 align="left"> <u>Tools: </u></h3>
     29We will use the following tools:
     30<ul><li><a href="https://portal.geni.net">the GENI Portal</a> </li> </ul>
     31
     32</td>
     33 
     34 <td> <pre>   </pre> </td>
     35    <td width="350" valign="top">
     36    <h3 align="left"> <u>Where to get help: </u></h3>
     37      <ul>
     38           <li> Contact your TA and/or Professor for help. If you are doing this exercise outside the context of a course, please email <a href="mailto:geni-users@googlegroups.com?Subject=Help%20with%20Stitching%20tutorial"> geni-users@googlegroups.com </a> </li>
     39      </ul>
     40    </td>
     41  </tr>
     42</table>
     43}}}
     44----
     45
     46{{{
     47#!html
     48<table  border="0" cellpadding="0" cellspacing="0">
     49  <tr>
     50     <td valign="top" align="left">
     51        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design.png?format=raw" width="150" alt="Design/Setup"></a>
     52      </td>
     53      <td>
     54         <h3><u>1. Verify your Environment Setup: </u></h3>
     55   This exercise assumes you have already setup your account at the GENI Portal. In particular ensure that:
     56   <ol>
     57      <li> You can login to the <a href="https://portal.geni.net"> GENI Portal </a></li>
     58       <li> You are a member of a GENI Project (there is at least one project listed under the <a href="https://portal.geni.net/secure/projects.php">''Projects''</a> tab) </li>
     59        <li> You have setup your ssh keys (there is at least one key listed under the <a href="https://portal.geni.net/secure/profile.php#ssh">''Profile->SSH Keys''</a> tab) </li>
     60    </ol>
     61<h3><u> 2. Setup the Topology: </u></h3>
     62<table>
     63<tr>
     64<td>
     65   <ol>
     66      <li>Login to the <a href="https://portal.geni.net"> GENI Portal </a> </li>
     67      <li>Create a new slice with the name of your choice.</li>
     68      <li>Click the <i>Add Resources</i> button on the Slice page.</li>
     69      <li>Drag two VMs (the black icons) onto the canvas.</li>
     70      <li>Draw a link between them.</li>
     71      <li>Drag a second site onto the canvas.</li>
     72      <li>Drag one of the existing VMs to the second site.</li>
     73      <li>Click on the unlabeled box in the middle of the link.  Select "Stitched Ethernet" as the link type.</li>
     74   </ol>
     75</td>
     76<td>
     77<img border="0" src="http://groups.geni.net/geni/raw-attachment/wiki/Tutorials/Stitching/Procedure/SetLinkType.png" alt="route topology"  align="center" width="350" title="topology" />
     78<br/>
     79<b>Figure 1</b> Set the Link Type on the inter-aggregate link.
     80</td>
     81</tr>
     82</table>
     83<table>
     84<tr><td>
     85<img border="0" src="http://groups.geni.net/geni/raw-attachment/wiki/GENIExperimenter/Tutorials/Graphics/tip.png" width='75'/>
     86</td><td>
     87The link type you select will affect the aggregates you are allowed to bind to in the next step.
     88<ul>
     89<li> <b>Stitched Ethernet</b> gives you a layer 2 link (i.e. a VLAN) between aggregates.</li>
     90<li> <b>EGRE Tunnel</b> gives you a layer 3 tunnel between aggregates.</li>
     91<li> However, if you would like a Layer 2 link connecting only ExoGENI sites, instead set the Link Type to "(any)" and pick any two ExoGENI aggregates except "ExoGENI ExoSM".</li>
     92</ul>
     93</td></tr>
     94</table>
     95<table  border="0" cellpadding="0" cellspacing="0">
     96<tr>
     97<td>
     98
     99   <ol start=9>
     100      <li>Bind each site to an aggregate.  (If you are doing this as part of a tutorial, use the aggregates specified on your worksheet.)</li>
     101      <li>Click the <i>Auto-IP</i> button (it is below the Jacks pane). This will ensure that there are IP address assigned to the links.</li>
     102      <li>Click <i>Reserve Resources</i>.</li>
     103   </ol>
     104</td>
     105<td>
     106<img border="0" src="http://groups.geni.net/geni/raw-attachment/wiki/Tutorials/Stitching/Procedure/BoundStitched.png" alt="route topology"  align="center" width="350" title="topology" />
     107<br/>
     108<b>Figure 2</b> Bind the sites.  The aggregate choices will be limited based on the link type.
     109</td>
     110</tr>
     111<tr>
     112<td>
     113    <ol start=12>
     114      <li>The reservation may take a couple of minutes to complete. After the reservation completes, return to the slice page. </li>
     115      <li>While you are waiting for the nodes to be ready, click the <i>Geo Map</i> button.  Wait for this page to load to see where your nodes are geographically located.  <i>Note that it may take a moment for your nodes to be drawn.</i></li>
     116   </ol>
     117</td>
     118<td>
     119<img border="0" src="http://groups.geni.net/geni/raw-attachment/wiki/Tutorials/Stitching/Procedure/GeoView.png" alt="route topology"  align="center" width="350" title="topology" />
     120<br/>
     121<b>Figure 3</b> The geographical location of your nodes.
     122</td>
     123</tr>
     124<tr>
     125<td>
     126    <ol start=14>
     127      <li>Press the back button on your browser to return to the slice page. Wait for the nodes to be ready.</li>
     128    </ol> 
     129</td>
     130<td>
     131<img border="0" src="http://groups.geni.net/geni/raw-attachment/wiki/Tutorials/Stitching/Procedure/SlicePgWithManifest.png" alt="route topology"  align="center" width="350" title="topology" />
     132<br/>
     133<b>Figure 4</b> The stitched topology is ready and green.
     134</td>
     135</tr>
     136    <ol>
     137</td>
     138</tr>
     139</table>       
     140          </td>
     141       </tr>
     142</table>
     143}}}
     144
     145[[BR]]
     146
     147{{{
     148#!html
     149<table  border="0" cellpadding="0" cellspacing="0">
     150  <tr>
     151     <td valign="top" align="left">
     152        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" height="150" alt="Execute"></a>
     153      </td>
     154      <td>
     155         <h3><u> 3. Test Connectivity </u></h3>
     156             <ol>
     157              <li>Log into one of the nodes and ping the data plane interface of the other node. <i>Reminder: To figure out the IP address of the other node, either look at the properties of the link on the Slice page OR log in to the other node and run `/sbin/ifconfig`.</i></li>
     158             </ol>       
     159          </td>
     160       </tr>
     161</table>
     162}}}
     163[[BR]]
     164{{{
     165#!html
     166<table  border="0" cellpadding="0" cellspacing="0">
     167  <tr>
     168     <td valign="top" align="left">
     169        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw"  width="150" alt="Finish"></a>
     170      </td>
     171       <td>
     172             
     173               <h3><u> 4. Cleanup </u></h3>
     174           After you are done with the exercise, delete your resources:
     175              <ol>
     176                 <li>Click on a blank part of the canvas, then press the <i>Delete</i> button.  When prompted, confirm you want to delete all of the resources in the slice.</li>
     177                 <li>After a few moments all the resources will have been released and you will have an empty canvas again. </li>
     178              </ol>
     179
     180         </td>
     181       </tr>
     182</table>
     183}}}