Changes between Version 43 and Version 44 of GENIExperimenter/Tutorials/jacks/GettingStarted_PartII_ccn/Procedure/Setup


Ignore:
Timestamp:
06/13/15 10:07:16 (9 years ago)
Author:
sedwards@bbn.com
Comment:

Systematic Experimentation version

Legend:

Unmodified
Added
Removed
Modified

  • GENIExperimenter/Tutorials/jacks/GettingStarted_PartII_ccn/Procedure/Setup

    v43 v44  
    154154  <td>
    155155     <img border="0"
    156         src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/JacksLab1_3.png?format=raw"
     156        src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_7_v2.png"
    157157        width="400" alt="Import an RSpec into Jacks"  title="Import an RSpec into Jacks" />
    158158     <br />
    … …  
    165165  <ol type='a' start='4'>
    166166    <li>Enter the URL for the RSpec: <br>
    167        <tt> http://www.gpolab.bbn.com/experiment-support/ccnx-xen/LabOneCCNX_request_rspec.xml </tt> <br>
     167       <tt> http://www.gpolab.bbn.com/exp/labone/lab1ccn-3node.xml </tt> <br>
    168168    then click <b>Select</b>.<br/>
    169169    </li>
    … …  
    195195   * Script that setup up ccnx protocol routes (add-precip-routes)
    196196
    197 We automate the installation and running of the software using install and execute scripts in the RSpec.
     197We automate the installation and running of the proper software using `install` and `execute` scripts in the RSpec. These can be added by selecting the '''Add''' button under the '''Install Scripts''' and '''Execute Scripts''' fields for each node.
     198
     199Most of the nodes have an install script specified for each of the three pieces of software listed above which loads a tarball of software onto each node:
     200 * `http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-0.6.2.tar.gz`
     201 * `http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-atmos.tar.gz`
     202 * `http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-setup.tar.gz`
     203
     204Likewise, the nodes have execute scripts to configure the software on each node:
     205 * `cd /tmp/ccnx-setup && ./node-setup`
     206 * `cd /tmp/ccnx-setup && ./add-precip-routes rsrchr`
     207 * `cd /tmp/ccnx-setup && ./ccnx-setup router 4`
     208
     209{{{
     210#!html
     211<table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/warning-icon-hi.png?format=raw" width='50' height='50'/></td><td>
     212You <i> DO NOT </i> have to specify install and execute scripts for the nodes as they have already been done for you.  You can check this by clicking on the icons for these nodes.
     213<br/><br/>
     214In general, one should be very careful when entering this information -- these commands will not
     215be executed yet, so it will be some time before you will see any relevant
     216error messages if there is a mistake here.
     217</td></tr></table>
     218}}}
     219
     220
    198221
    199222{{{
    … …  
    202225<td colspan=2>
    203226  <ol type='a'>
    204      <li>Click on the <b>collab node</b> (see figure) to manipulate details of the node configuration.
     227     <li>Click on each node to manipulate details of the node configuration.
     228<br/><br/>
     229The <tt>ccnx-setup</tt> execute command takes as parameters the name of a single "barrier" node, which must be up in order for the experiment to start, and the number of nodes in the topology as follows:
     230<pre>ccnx-setup BARRIER_NODE NUM_NODES</pre>
     231We will continue to use the node <tt>ccnx-router</tt> as the barrier node.
     232<br/><br/>
     233We will add two nodes to the topology, so go ahead and change the number of nodes from 3 to 5.
     234The new <tt>ccnx-router</tt> execute command on <b>all three nodes</b> should be:
     235<pre>cd /tmp/ccnx-setup && ./ccnx-setup ccnx-router 5</pre>
    205236
    206237
    … …  
    223254
    224255<td colspan=2>
    225   <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/JacksLab1_5.png?format=raw" width='500'/>
    226      <br />
    227      <b>Figure 3-2</b> <i>Edit the nodes</i>
    228 </td>
    229 </tr>
    230 </table>
    231 
    232 <table>
    233 <tr><td>
     256  <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_5_v2.png" width='500'/>
     257     <br />
     258     <b>Figure 3-2</b> <i>Edit all three nodes</i>
     259</td>
     260</tr>
     261</table>
     262
     263
     264
     265<table><tr>
     266<td colspan=2>
    234267  <ol type='a' start='2'>
    235 
    236 <li>The way we will request installation of the proper software and execution
    237 of our experiment is to add <i>install</i> and <i>execute</i> services.
     268     <li>Copy the <tt>user</tt> node by:
     269<ul>
     270<li>Click on the <tt>user</tt> node. </li>
     271<li>Press the <b>Duplicate Nodes Only</b> button. </li>
     272<li>A node <tt>user-0</tt> should appear. Look at the install and execute scripts.  They should be the same as on the original <tt>user</tt> node.</li>
     273</ul>
     274     </li>
     275     <li>Copy the <tt>ccnx-router</tt> node the same way.  The new node should be <tt>ccnx-router-1</tt>.</li>
     276  </ol>
     277</td>
     278
     279<td colspan=2>
     280  <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_20_v2.png" width='500'/>
     281     <br />
     282     <b>Figure 3-3</b> <i>Copy the <tt>ccnx-router</tt> and <tt>user</tt> nodes.</i>
     283</td>
     284</tr>
     285</table>
     286<table><tr>
     287<td colspan=2>
     288  <ol type='a' start='4'>
     289     <li>Draw a link between the <tt>ccnx-router</tt> and <tt>ccnx-router-1</tt> nodes.</li>
     290     <li>Draw another link between the new <tt>ccnx-router-1</tt> node and the <tt>user-0</tt> node.</li>
     291     <li>The topology should look like Figure 3-4</li>
     292  </ol>
     293</td>
     294
     295<td colspan=2>
     296  <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_21_v2.png" width='500'/>
     297     <br />
     298     <b>Figure 3-4</b> <i>Draw links to connect the nodes.</i>
     299</td>
     300</tr>
     301</table>
     302
     303<table><tr>
     304<td colspan=2>
     305  <ol type='a' start='7'>
     306     <li>Press the <b>Auto-IP</b> button to automatically assign IP addresses to each interface in the topology.</li>
     307     <li>
     308The <tt>add-precip-routes</tt> execute command takes as a parameter the name of the "next hop" node, which is the next node on the path to the <tt>data</tt> node:
     309<pre>add-precip-routes NEXT_HOP_NODE</pre>
     310<br/><br/>
     311Edit the new <tt>ccnx-router-1</tt> node to point to <tt>ccnx-router</tt>.
     312<br/><br/>
     313The new <tt>add-precip-routes</tt> execute command on <b>ccnx-router-1</b> should be:
     314<pre>cd /tmp/ccnx-setup && ./add-precip-routes ccnx-router</pre>
    238315</li>
    239 </td>
    240 <td>
    241 <img width='500' src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/JacksLab1_6.png?format=raw" />
    242      <br />
    243      <b>Figure 3-3</b> <i>Specify the install and execute scripts </i>
    244 </td></tr>
    245 
    246 
    247 </table>
    248 
    249 <table>
    250 
    251 <tr>
    252 <td colspan=2>
    253 <ol  type='a' start='3'>
    254316<li>
    255 You will be adding three install scripts.  First, select "<tt>Add</tt>" under the <b>Install Scripts</b> sections as shown.  In the box in the <b>URL</b> field enter (cut-and-paste): <br>
    256 <pre>http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-0.6.2.tar.gz</pre>
    257 and enter
    258 <pre>/</pre>
    259 in the box under it (labeled 'Install Path:').
    260 <br>
    261 <br>
    262 Now, select "<tt>Add</tt>" under the <b>Install Scripts</b> again.  This time add: <br>
    263 <pre>http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-atmos.tar.gz</pre>
    264 and enter <br>
    265 <pre>/</pre>
    266 in the box under it (labeled 'Install Path:').
    267 <br>
    268 <br>
    269 Similarly, add a third install service:
    270 <pre>http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-setup.tar.gz</pre>
    271 and enter <br>
    272 <pre>/tmp</pre>
    273 in the box under it (labeled 'Install Path:').  <strong> Note the different install directory this time. </strong>
    274 <br>
    275 <br>
    276 
    277   <li>In a similar manner, use the "<tt>Add</tt>" button under the <b>Execute Scripts</b> section to add three execute services on this node:
    278 <br>
    279 <pre>
    280 cd /tmp/ccnx-setup &&  ./node-setup
    281 cd /tmp/ccnx-setup &&  ./add-precip-routes rsrchr
    282 cd /tmp/ccnx-setup && ./ccnx-setup router 4
    283 </pre>
    284   </li>
    285 
    286 <table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/warning-icon-hi.png?format=raw" width='50' height='50'/></td><td>Be very careful when entering this information -- these commands will not
    287 be executed yet, so it will be some time before you will see any relevant
    288 error messages if there is a mistake here.</td></tr></table>
    289   </li>
    290 </ol>
    291 </td>
    292 </tr>
    293 </table>
    294 
    295 <table>
    296 <tr><td>
    297   <ol type='a' start='5'>
    298   <li> You <i> DO NOT </i> have to specify install and execute scripts for the other nodes as they have already been done for you.  You can check this by clicking on the icons for these nodes.
    299 
    300  
    301 </ol>
    302 </td>
    303 </tr>
    304 
    305 </table>
    306 }}}
    307 
     317Edit the new <tt>user-0</tt> node to point to <tt>ccnx-router-1</tt>.
     318<br/><br/>
     319The new <tt>add-precip-routes</tt> execute command on <b>user-0</b> should be:
     320<pre>cd /tmp/ccnx-setup && ./add-precip-routes ccnx-router-1</pre>
     321
     322</li>
     323  </ol>
     324</td>
     325
     326<td colspan=2>
     327  <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_22_v2.png" width='500'/>
     328     <br />
     329     <b>Figure 3-5</b> <i>Edit the next hop on <tt>ccnx-router-1</tt> and <tt>user-0</tt>.</i>
     330</td>
     331</tr>
     332</table>
     333}}}
    308334
    309335
    … …  
    328354   </td>
    329355   <td>
    330       <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/JacksLab1_7.png?format=raw" width='500'/>
     356      <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_24_v2.png" width='500'/>
    331357         <br/>
    332358         <b>Figure 3-4</b> View and save the final request RSpec