wiki:GENIExperimenter/Tutorials/RunHelloGENI

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

--

This page is under construction! Please come back in a while

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

Hello GENI

Overview:

Welcome to GENI. This page will guide you through your first GENI experiment.
This is a very simple tutorial with one server and one client that are connected with a Layer 2 link.
Hello GENI topology
   

Prerequisites:

The only thing you need for this first tutorial is a GENI account.
  • For this tutorial you need a GENI Experimenter Portal account and be a member of at least one project.
  • If you have a ProtoGENI (emulab) account, then you can follow
  • this version of the tutorial.
  • If you don't have an account yet sign up!

Tools:

All the tools will already be installed at your nodes. For your reference we are going to use:
   

Where to get help:

For any questions or problem with the tutorial please email help@geni.net

1. Configure your GENI account

This experiment assumes that you have an account in the GENI Experimenter Portal and that you are already a member of at least one project.

The first thing we need to do is login to the portal.

Login to GENI Experimenter Portal
  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: