wiki:GENIExperimenter/Tutorials/RunHelloGENI

Version 20 (modified by nriga@bbn.com, 11 years ago) (diff)

--

Wiki Home Welcome GENI Experimenters Sign Up For a GENI Account Run Hello GENI example Image Map

Welcome to GENI. This page will guide you through your first GENI experiment. The only thing you will need is a GENI account. If you don't already have one, sign up!

1. Configure your GENI account

For our first experiment 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.

Login to Flack Video
  1. Go to http://www.protogeni.net/flack and press the Log in button
  2. 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
  3. Answer yes in the pop-up window
  4. Login to the new window using your GENI account
  5. Reload the Flack tab and repeat steps 1 and 2
  6. After your private key and certificate are loaded, type your GENI passphrase in the box
  7. Select the sites you want. For this tutorial we only need the utahemulab.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.

Launch Experiment Video
  1. 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)
  2. 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
  3. Find the copy of this rspec file that you downloaded earlier and press ok
  4. A topology will come up, it will look different than the topology on the video. Your topology should look like Login to Flack Video. Press the Submit button and confirm that you want to reserve these resources.
  5. 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. View your results

For this example experiment we used the install script facility to automatically install the necessary software and kick-off the experiment. In this very simple setup, we have installed and launched a web server as well as an iperf server, on the server host. On the client, we have started some processes to test both of these services. To view the results of this experiment:

Hello GENI index
  1. After the background of your slice turns green, press the (i) button that is on the server node icon.
  2. In the information tab that came up, press the Visit button. A new tab should come up that looks like the picture on the side.
  3. Click the Web Server Statistics link to look at statistics. Refresh the page a couple of times to see how the statistics change as the client requests documents.
  4. Click the Logs from the iperf Server link to see the statistics from the iperf transfers.
  1. Optional: Manually generate traffic While conducting experiments in GENI, you will often want to run commands directly on the nodes. In this optional step, you will log in to a node and issue commands directly to it.
    • Follow these instructions and log in to the client node
    • When you have successfully logged in, run this command
      iperf -c server -P 2
      
      This task shouldn't take more than 30 seconds. Change the number after the -P argument and watch how the performance is affected while you change the number of parallel TCP connections.
    • Scroll all the way down the server iperf log, and look at the logs for your transfers

4. Cleanup

After you are done with your experiment, you should always release your resources so that other experimenters can use the resources. As shown at the end of the video for reserving resources, in order to cleanup your slice :

  1. Press the Delete button in the bottom of your canvas
  2. select "Delete at used managers" and confirm your selection.

Wait and after a few moments all the resources will have been released and you will have an empty canvas again. Notice that your slice is still there. There is no way to delete a slice, it will be removed automatically after its expiration date, but remember that a slice is just an empty container so it doesn't take up any resources.

5. What's next?

Congratulations! You have finished your first GENI Experiment. Now that you are more familiar with GENI concepts you can: