This page will guide you through Running a Complete Experiment in GENI as seen in the plenary demo!

For this experiment you will need :

1. A GENI Account. If you don't have one sign up. If you are at the GEC, get a temporary account.
2. An Irods Account
3. The tutorial VM. If you do not have it please find us and we will give you a copy.

That's, you are ready to run this experiment!

1. Account Configuration

First we are going to configure all the tools that we will need for this experiment. More specifically we will use :

• ​Flack to reserve our resources
• GEMINI to instrument our experiment
• ​OMNI to orchestrate the experiment

We are going to start the configuration in the reverse direction.

1a. Configure Omni on the VM

Omni is already installed in the tutorial VM, but we will need to configure it with your account. Follow these instructions using your personal username, password and passphrase.

Add the Omni script for orchestrating the experiment

For orchestrating our experiment we used Omni scripting. You need to place a copy of this script​ under /usr/local/bin/gcf/examples/ in the VM, as well as copy this version of the readyToLogin script​ also under /usr/local/bin/gcf/examples/.

1b. Configure GEMINI on the VM

These steps are based on these instructions.

1. Place your GENI passphrase in a file under ~/.ssl/password

   echo "<passphrase>" > ~/.ssl/password
   

   and verify that it is correct

   cat ~/.ssl/password
   

2. Add your ssh key to the ssh-agent:

   ssh-add ~/.ssh/geni_key
   

1c. Login to Flack

We are going to use ​Flack a web-based graphical tool for reserving GENI resources. Your first step is to log in to Flack. ​This video will guide you through the steps of logging in.

Go to http://www.protogeni.net/flack and press the Log in button From the select authority drop down menu, select the site authority for your GENI account, most probably pgeni.gpolab.bbn.com and press the Download button Answer yes in the pop-up window Login to the new window using your GENI account Reload the Flack tab and repeat steps 1 and 2 After your private key and certificate are loaded, type your GENI passphrase in the box Select the sites you want. For this tutorial we only need the utaemulab.cm site.

2. Launch your experiment

Now that you are logged in to Flack, we are ready to design our experiment. ​This video will guide you through the process of setting up the resources for the Hello GENI experiment. To complete the setup you will need to save a copy of this file on your computer. This is a Resource Specification (rspec) file that contains a description of this experiment for Flack.

After Flack finishes loading all the information, create a new slice by clicking New on the left of the screen, right under your user name. Name your slice something like xxxhello (where xxx are your initials) When an empty canvas shows up, you are ready to create an experiment. Click at the Import button on the top of the canvas and select Import from file Find the copy of this rspec file that you downloaded earlier and press ok A topology will come up, it will look different than the topology on the video. Your topology should look like . Press the Submit button and confirm that you want to reserve these resources. Wait while your resources are being reserved. This will take several minutes so be patient. When your sliver is ready the background will be green.

3. Enable Instrumentation In your Experiment

The next step before we actually start running our experiment, is to start the instrumentation in our slice. For this example we are going to use GEMINI.

3a. Configure GEMINI on the VM

First we need to configure GEMINI with the information from our account.