197 | | We automate the installation and running of the software using install and execute scripts in the RSpec. |
| 197 | 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. |
| 198 | |
| 199 | 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: |
| 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 | |
| 204 | Likewise, 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> |
| 212 | 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. |
| 213 | <br/><br/> |
| 214 | In general, one should be very careful when entering this information -- these commands will not |
| 215 | be executed yet, so it will be some time before you will see any relevant |
| 216 | error messages if there is a mistake here. |
| 217 | </td></tr></table> |
| 218 | }}} |
| 219 | |
| 220 | |
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/> |
| 229 | 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: |
| 230 | <pre>ccnx-setup BARRIER_NODE NUM_NODES</pre> |
| 231 | We will continue to use the node <tt>ccnx-router</tt> as the barrier node. |
| 232 | <br/><br/> |
| 233 | We will add two nodes to the topology, so go ahead and change the number of nodes from 3 to 5. |
| 234 | The 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> |
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> |
| 308 | 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: |
| 309 | <pre>add-precip-routes NEXT_HOP_NODE</pre> |
| 310 | <br/><br/> |
| 311 | Edit the new <tt>ccnx-router-1</tt> node to point to <tt>ccnx-router</tt>. |
| 312 | <br/><br/> |
| 313 | The 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> |
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 | | |
| 317 | Edit the new <tt>user-0</tt> node to point to <tt>ccnx-router-1</tt>. |
| 318 | <br/><br/> |
| 319 | The 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 | }}} |