213 | | We automate the installation and running of the software using install and execute scripts in the RSpec. |
| 213 | We 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 | |
| 215 | Most 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 | |
| 220 | Likewise, 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> |
| 228 | You <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/> |
| 230 | In general, one should be very careful when entering this information -- these commands will not |
| 231 | be executed yet, so it will be some time before you will see any relevant |
| 232 | error messages if there is a mistake here. |
| 233 | </td></tr></table> |
| 234 | }}} |
| 235 | |
| 236 | |
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/> |
| 245 | The <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> |
| 247 | We will continue to use the node <tt>ccnx-router</tt> as the barrier node. |
| 248 | <br/><br/> |
| 249 | We will add two nodes to the topology, so go ahead and change the number of nodes from 3 to 5. |
| 250 | The 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> |
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> |
| 324 | The <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 | |
| 327 | Edit the new <tt>ccnx-router-1</tt> node to point to <tt>ccnx-router</tt>. |
| 328 | <br/><br/> |
| 329 | The 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> |
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 | | |
| 333 | Edit the new <tt>user-0</tt> node to point to <tt>ccnx-router-1</tt>. |
| 334 | <br/><br/> |
| 335 | The 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 | }}} |