wiki:GEC21Agenda/ScalingUp/Procedure/DesignSetup

Version 29 (modified by sedwards@bbn.com, 5 years ago) (diff)

--

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

Image Map

1. Design the Experiment

  1. 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. Add geni-lib to your path:
        export PYTHONPATH="/PATH/TO/geni-lib:$PYTHONPATH"
    

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

  1. 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.
  2. Download this config file to use with the scaleup tool distributed with geni-lib.
  3. Open the file using your favorite text editor (e.g. vi or emacs).
  4. Replace X with the value on your worksheet. If you are doing this outside a tutorial, replace X with 1.
  5. 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
  1. 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?
  2. 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.
  3. Bind the topology to the aggregate listed on your worksheet.
  4. Save this RSpec.

3.3 Reserve Topology

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

Introduction

Next: Execute