Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/ScalingUp/Procedure/DesignSetup

Timestamp:

05/22/15 15:07:50 (9 years ago)

Author:

sedwards@bbn.com

Comment:

--

GENIExperimenter/Tutorials/ScalingUp/Procedure/DesignSetup

@@ +1 @@
+= [.. Scaling Up: How to Grow the Topology of an Existing Experiment] =
+{{{
+#!html
+
+
+<div style="text-align:center; width:495px; margin-left:auto; margin-right:auto;">
+<img id="Image-Maps_5201305222028436" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Setup.jpg?format=raw" usemap="#Image-Maps_5201305222028436" border="0" width="495" height="138" alt="" />
+<map id="_Image-Maps_5201305222028436" name="Image-Maps_5201305222028436">
+<area shape="rect" coords="18,18,135,110" href="./DesignSetup" alt="" title=""    />
+<area shape="rect" coords="180,18,297,111" href="./Execute" alt="" title=""    />
+<area shape="rect" coords="344,17,460,110" href="./Finish" alt="" title=""    />
+<area shape="rect" coords="493,136,495,138" href="http://www.image-maps.com/index.php?aff=mapped_users_5201305222028436" alt="Image Map" title="Image Map" />
+</map>
+<!-- Image map text links - End - -->
+
+</div>
+}}}
+
+
+
+== 1.  Design the Experiment ==
+  
+{{{
+#!html
+<table border="0">
+   <tr>
+     <td >
+        <ol type='a'><li>In today's experiment you will use resources at the aggregate listed on the worksheet. If you don't have a worksheet use <i>Wisconsin InstaGENI</i> </li>
+        <li>Note that the instructor has already <a href="../BackboneSetup">reserved a backbone with shared VLANs</a> for your slice to connect to. </li>
+        </ol>
+     </td>
+   </tr>
+</table>
+}}}
+
+== 2.  Establish the Environment ==
+
+
+
+=== 2.1  Pre-work: Install geni-lib ===
+ 1. Install the `geni-lib` tool using the [http://geni-lib.readthedocs.org/en/latest/intro/install.html installation instructions] for your operating system.
+ 1. Install [https://networkx.github.io/ `networkx`] on your system.
+{{{
+pip install networkx
+}}}
+ 1. On mac and UNIX you may need to add geni-lib to your path:
+{{{
+    export PYTHONPATH="/PATH/TO/geni-lib:$PYTHONPATH"
+}}}
+
+== 3.  Obtain Resources ==
+
+Now we will generate a topology and reserve it.
+
+=== 3.1 Generate RSpec based on existing smaller topology ===
+
+  a. Download this [http://www.gpolab.bbn.com/exp/scalingup/tutorial/site.txt config file] to use with the `scaleup` tool distributed
+  with `geni-lib`.
+  a. Open the file using your favorite text editor (e.g. `vi` or `emacs`).
+  a. Replace each value of `X` with the value on your worksheet. Use search and replace in your text editor if possible. ''If you are doing this outside a tutorial, replace `X` with `1`.''
+  a. Run the `scaleup` script on the configuration file.
+     * On Mac and UNIX-like systems run:
+{{{
+cd /to/your/geni-lib
+tools/scaleup/rspec_gen.py -r site.txt
+}}}
+     * On Windows:
+{{{
+cd C:\\Development\geni-lib
+tools\scaleup\rspec_gen.py -r site.txt
+}}}
+  a. Look at the generated file using your favorite tool (`less`,
+  `more`, `emacs`, `vi`).  (Or you can look at an example of the generated file: [http://www.gpolab.bbn.com/exp/scalingup/tutorial/site-1.xml site-1.xml].)
+      i. Can you find each node?  Can you find the router node?  The host nodes? 
+  a. Load the RSpec in your favorite tool (e.g. Jacks, jFed).  Find the shared VLAN (it usually looks like a link with only one end point). 
+      i. Change the IP address of the shared VLAN as directed on your worksheet. 
+  a. Bind the topology to the aggregate listed on your worksheet.
+  a. '''Save this RSpec.'''  In a real experiment, if this topology works, you would save the RSpec in version control.
+
+=== 3.3 Reserve Topology ===
+  a. Create a slice and reserve the resources
+  a. Wait for the topology to come up.
+
+
+----
+= [..  Introduction] =
+= [../Execute Next:  Execute] =