= [.. 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>Clemson InstaGENI (aka instageni.clemson.edu)</i> </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.

== 3.  Obtain Resources ==

Now that you are a member of a project, you can create a slice and reserve resources.

=== 3.1 Generate RSpec based on existing smaller topology ===

  a. This experiment already works using this [small topology].  Load
  (but do not reserve) this topology in your favorite editor to see what it
  looks like.
  a. Download this [config file] for the `scaleup` tool distributed
  with `geni-lib`.
  a. Open the file using your favorite text editor (`vi` or `emacs`).
  Replace `X` with the value on your worksheet.  If you are doing this
  outside a tutorial, replace `X` with `1`.
  a. Run the rspec_gen script on the configuration file:
{{{
./rspec_geni.py -r site.txt
}}}
  a. Look at the generated file using your favorite tools (`less`,
  `more`, `emacs`, `vi`).
      a. Can you find each node?  Can you find the router node?  The host nodes? 
  a. Load the RSpec in your favorite tool.  Find the shared VLAN (it usually looks like a link with only one end point). 
      a. Change the IP address of the shared VLAN to be `10.100.Y.X` where `Y` and `X` are provided on your worksheet. 
      a. Save this RSpec.
  a. Bind the Site to the aggregate listed on your worksheet.
  a. Reserve the resources

{{{
!#comment
For example, in the following snippet, the `scalingup` shared VLAN is on interface `rt-1:if3`:
{{{
  <link client_id="lan2">
    <interface_ref client_id="rt-1:if3"/>
    <link_type name="lan"/>
    <sharedvlan:link_shared_vlan name="scalingup"/>
  </link>
}}}

The corresponding interface section originally looks like:
{{{
    <interface client_id="rt-1:if3">
      <ip address="10.7.3.1" netmask="255.255.255.0" type="ipv4"/>
    </interface>
}}}

But will be modified to look like:
{{{
    <interface client_id="rt-1:if3">
      <ip address="10.100.2.107" netmask="255.255.255.0" type="ipv4"/>
    </interface>
}}}
}}}
   
=== 3.3 Reserve Topology ===
   a. Using your favorite tool (Jacks, jFed), reserve the generated RSpec (`siteX.xml`) at the aggregate
   listed on your worksheet.
   a. Wait for the topology to come up.


----
= [..  Introduction] =
= [../Execute Next:  Execute] =