Changes between Version 33 and Version 34 of GENIExperimenter/Tutorials/jFed/GettingStarted_PartII_ccn/Procedure/Setup


Ignore:
Timestamp:
07/02/15 20:40:25 (9 years ago)
Author:
sedwards@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/Tutorials/jFed/GettingStarted_PartII_ccn/Procedure/Setup

    v33 v34  
    211211   * Script that setup up ccnx protocol routes (add-precip-routes)
    212212
    213 We automate the installation and running of the software using install and execute scripts in the RSpec.
     213We 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.
     214
     215Most 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:
     216 * `http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-0.6.2.tar.gz`
     217 * `http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-atmos.tar.gz`
     218 * `http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-setup.tar.gz`
     219
     220Likewise, the nodes have execute scripts to configure the software on each node:
     221 * `cd /tmp/ccnx-setup && ./node-setup`
     222 * `cd /tmp/ccnx-setup && ./add-precip-routes rsrchr`
     223 * `cd /tmp/ccnx-setup && ./ccnx-setup router 4`
     224
     225{{{
     226#!html
     227<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>
     228You <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.
     229<br/><br/>
     230In general, one should be very careful when entering this information -- these commands will not
     231be executed yet, so it will be some time before you will see any relevant
     232error messages if there is a mistake here.
     233</td></tr></table>
     234}}}
     235
     236
    214237
    215238{{{
     
    218241<td colspan=2>
    219242  <ol type='a'>
    220      <li>Click on the <b>collab node</b> (see figure) to manipulate details of the node configuration.
     243     <li>Click on each node to manipulate details of the node configuration.
     244<br/><br/>
     245The <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:
     246<pre>ccnx-setup BARRIER_NODE NUM_NODES</pre>
     247We will continue to use the node <tt>ccnx-router</tt> as the barrier node.
     248<br/><br/>
     249We will add two nodes to the topology, so go ahead and change the number of nodes from 3 to 5.
     250The new <tt>ccnx-router</tt> execute command on <b>all three nodes</b> should be:
     251<pre>cd /tmp/ccnx-setup && ./ccnx-setup ccnx-router 5</pre>
    221252
    222253
     
    227258               </td>
    228259<td>
    229 When you open the node information, you should see options like those
     260When you open the node information, you should see a new pane with fields to fill in like
    230261in the figure. 
    231262</td>
     
    239270
    240271<td colspan=2>
    241   <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/JFedLab1_5.png?format=raw" width='400'/>
    242      <br />
    243      <b>Figure 3-3</b> <i>Edit the nodes</i>
    244 </td>
    245 </tr>
    246 </table>
    247 
    248 <table>
    249 <tr><td>
     272  <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_5_v2.png" width='500'/>
     273     <br />
     274     <b>Figure 3-2</b> <i>Edit all three nodes</i>
     275</td>
     276</tr>
     277</table>
     278
     279
     280
     281<table><tr>
     282<td colspan=2>
    250283  <ol type='a' start='2'>
    251 
    252 <li>The way we will request installation of the proper software and execution
    253 of our experiment is to add <i>install</i> and <i>execute</i> services.
     284     <li>Copy the <tt>user</tt> node by:
     285<ul>
     286<li>Click on the <tt>user</tt> node. </li>
     287<li>Press the <b>Duplicate Nodes Only</b> button. </li>
     288<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>
     289</ul>
     290     </li>
     291     <li>Copy the <tt>ccnx-router</tt> node the same way.  The new node should be <tt>ccnx-router-1</tt>.</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_20_v2.png" width='500'/>
     297     <br />
     298     <b>Figure 3-3</b> <i>Copy the <tt>ccnx-router</tt> and <tt>user</tt> nodes.</i>
     299</td>
     300</tr>
     301</table>
     302<table><tr>
     303<td colspan=2>
     304  <ol type='a' start='4'>
     305     <li>Draw a link between the <tt>ccnx-router</tt> and <tt>ccnx-router-1</tt> nodes.</li>
     306     <li>Draw another link between the new <tt>ccnx-router-1</tt> node and the <tt>user-0</tt> node.</li>
     307     <li>The topology should look like Figure 3-4</li>
     308  </ol>
     309</td>
     310
     311<td colspan=2>
     312  <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_21_v2.png" width='500'/>
     313     <br />
     314     <b>Figure 3-4</b> <i>Draw links to connect the nodes.</i>
     315</td>
     316</tr>
     317</table>
     318
     319<table><tr>
     320<td colspan=2>
     321  <ol type='a' start='7'>
     322     <li>Press the <b>Auto-IP</b> button to automatically assign IP addresses to each interface in the topology.</li>
     323     <li>
     324The <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:
     325<pre>add-precip-routes NEXT_HOP_NODE</pre>
     326
     327Edit the new <tt>ccnx-router-1</tt> node to point to <tt>ccnx-router</tt>.
     328<br/><br/>
     329The new <tt>add-precip-routes</tt> execute command on <b>ccnx-router-1</b> should be:
     330<pre>cd /tmp/ccnx-setup && ./add-precip-routes ccnx-router</pre>
    254331</li>
    255 </td>
    256 
    257 <td>
    258 <img width='600' src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/JFedLab1_6.png?format=raw" />
    259      <br />
    260      <b>Figure 3-4</b> <i>Specify the install and execute scripts </i>
    261 </td></tr>
    262 
    263 <tr>
    264 <td colspan=2>
    265 <ol  type='a' start='3'>
    266332<li>
    267 You will be adding three install scripts. First, select "<tt>Boot Scripts</tt>" tab as shown and then the green "+" button after <b>Download sources:</b>.  In the URL box enter (cut-and-paste): <br>
    268 <pre>http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-0.6.2.tar.gz</pre>
    269 and enter
    270 <pre>/</pre>
    271 in the box next to it (labeled 'Install Path').
    272 <br>
    273 <br>
    274 Now, select the green "<tt>+</tt>" after <b>Download sources:</b> again.  This time add: <br>
    275 <pre>http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-atmos.tar.gz</pre>
    276 and enter <br>
    277 <pre>/</pre>
    278 in the box next to it (labeled 'Install Path').
    279 <br>
    280 <br>
    281 Similarly, add a third install service:
    282 <pre>http://www.gpolab.bbn.com/experiment-support/ccnx-xen/ccnx-setup.tar.gz</pre>
    283 and enter <br>
    284 <pre>/tmp</pre>
    285 in the box next to it (labeled 'Install Path').  <strong> Note the different install directory this time. </strong>
    286 <br>
    287 <br>
    288 
    289   <li>In a similar manner, use the green "<tt>+</tt>" button after <b>Execute commands:</b> to add three execute services on this node:
    290 <br>
    291 <pre>
    292 cd /tmp/ccnx-setup &&  ./node-setup
    293 cd /tmp/ccnx-setup &&  ./add-precip-routes rsrchr
    294 cd /tmp/ccnx-setup && ./ccnx-setup router 4
    295 </pre>
    296   </li>
    297 
    298 <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
    299 be executed yet, so it will be some time before you will see any relevant
    300 error messages if there is a mistake here.</td></tr></table>
    301   </li>
    302 </ol>
    303 </td>
    304 </tr>
    305 </table>
    306 
    307 <table>
    308 <tr><td>
    309   <ol type='a' start='5'>
    310   <li>Once both the <i>install</i> and <i>execute</i> services are specified, click anywhere in the main pane to have the options window disappear. 
    311   </li>
    312   <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 these nodes.
    313 
    314  
    315 </ol>
    316 </td>
    317 </tr>
    318 
    319 </table>
    320 }}}
    321 
     333Edit the new <tt>user-0</tt> node to point to <tt>ccnx-router-1</tt>.
     334<br/><br/>
     335The new <tt>add-precip-routes</tt> execute command on <b>user-0</b> should be:
     336<pre>cd /tmp/ccnx-setup && ./add-precip-routes ccnx-router-1</pre>
     337
     338</li>
     339  </ol>
     340</td>
     341
     342<td colspan=2>
     343  <img src="http://groups.geni.net/geni/raw-attachment/wiki/GENIEducation/SampleAssignments/LabZero/Graphics/JacksLab1_22_v2.png" width='500'/>
     344     <br />
     345     <b>Figure 3-5</b> <i>Edit the next hop on <tt>ccnx-router-1</tt> and <tt>user-0</tt>.</i>
     346</td>
     347</tr>
     348</table>
     349}}}
    322350
    323351