wiki:GENIExperimenter/Tutorials/RunHelloGENI

Version 56 (modified by nriga@bbn.com, 10 years ago) (diff)

--

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:

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

Step-by-step Instructions

Design/Setup

Step 1: Get Ready:

The first thing we need to do is login to the portal.
  1. Go to the GENI Experimenter Portal press the Use GENI button
  2. and from the Drop Down menu select your institution. If you got an account through the GENI Identity Provider, please select GENI Project Office.
    Tip: Start typing the name of your institution and see the list become smaller.
  • You will be transferred to the Login Page of your institution. Fill in your username and password.
  • Step 2: Launch your experiment:

    1. At the portal home page press the create slice from your project.
      Tip: If you are not a member of any project and you don't know how to procede, email us
    2. Name your slice something like xxxhello (where xxx are your initials)
    3. When the slice page loads up, press the Launch Flack button, and wait until Flack finishes loading; this might take a while.
    4. Once Flack finishes loading, on the top of the empty canvas on the right, from the Import menu choose the Import from the web option.
    5. Paste this url http://www.gpolab.bbn.com/experiment-support/HelloGENI/hellogeni.rspec and click Ok
    6. A topology will come up. Your topology should look like Login to Flack Video. Press the Submit button and confirm that you want to reserve these resources.
    7. 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.
    Import RSpec in Flack
    Execute

    Step 3: View 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:
    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.

    Optional Step 4: 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.
    1. Follow these instructions and log in to the client node
    2. 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.
    3. Scroll all the way down the server iperf log, and look at the logs for your transfers
    Execute

    Step 5: Cleanup experiment:

    After you are done with your experiment, you should always release your resources so that other experimenters can use the 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.

    What's next?

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