Scaling Up: How to Grow the Topology of an Existing Experiment

1. Design the Experiment

In today's experiment you will use resources at the aggregate listed on the worksheet. If you don't have a worksheet use Wisconsin InstaGENI

2. Establish the Environment

2.1 Pre-work: Install geni-lib

1. Install the geni-lib tool using the ​installation instructions for your operating system.
2. Install networkx on your system.

   pip install networkx
   

3. 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

1. Download this ​config file to use with the scaleup tool distributed with geni-lib.
2. Open the file using your favorite text editor (e.g. vi or emacs).
3. 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.
4. 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
     

5. Look at the generated file using your favorite tool (less, more, emacs, vi).
   1. Can you find each node? Can you find the router node? The host nodes?
6. 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).
   1. Change the IP address of the shared VLAN to be 10.100.Y.A where Y and A are provided on your worksheet.
7. Bind the topology to the aggregate listed on your worksheet.
8. Save this RSpec. In a real experiment, if this topology works, you would save the RSpec in version control.

3.3 Reserve Topology

1. Create a slice and reserve the resources
2. Wait for the topology to come up.

---

Introduction

Next: Execute