Experiment Scripts

The reference experiment is run using two scripts:

  • Topology builder: reserve.py

  • Experiment run: runexp.py

Topology Builder: reserve.py

The topoplogy builder uses the geni-lib libraries to reserve resources on the infrastructure of choice within the GENI Federation. In this reference experiment, reserve.py builds using the VTS. The options of this script is listed in the table below, most of which are optional:

--site

Site to deploy topology, as a site name (vts-gpo, etc.)

--slice

Slice name

--project

Project name (typically the geni-lib default)

--context-path

Path to context JSON, if not default location

--delete

Delete any pre-existing sliver with same slice name

--config-path

SSH Config file location for constructed topology

--uhexpurl

URL for uhexp repository

--uhexpbranch

Branch in supplied repository

Only slice is a required argument if you have a properly set up geni-lib context. You can use the URLs and branches to supply your own modification to the experiment. You may delete your existing sliver on the slice at the site if you are reserving at the same site again. A different ssh configuration file path can be specified by config-path if needed.

InstaGENI Topology Builder: reserve-ig.py

The topology builder has hard-coded site-url to be used to reserve resources at the University of Hawaii InstaGENI rack.

Warning

This topology builder requires that the uhexp be installed in the system in order to create the ssh config file for the experiment run phase.

Here are its options in the table below:

--site

Site to deploy topology, as a site name (ig-gpo, etc.)

--site-url

Site URL to deploy topology

--slice

Slice name

--project

Project name (typically the geni-lib default)

--context-path

Path to context JSON, if not default location

--delete

Delete any pre-existing sliver with same slice name

--config-path

SSH Config file location for constructed topology

--uhexpurl

URL for uhexp repository

--uhexpbranch

Branch in supplied repository

--image

Image URL to use at the end nodes

--user

User name in the form of a GENI URN

Experiment Run: runexp.py

The experiment run script does not have any options and runs the experiment on the VTS infrastructure for a given ssh configuration file named expconfig to be found in the same path as the script.