GENIExperimenter/Tutorials/RunHelloGENI

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 geni-users@googlegroups.com

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 NCSA Identity Provider, please select NCSA.
    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, a faculty member or senior official at your institution will need to create one for you. If you are such a person, you can ask to become a Project Lead (look on the Profile page under your name on the top right of the page). Questions? Email us
    2. Name your slice something like xxxhello (where xxx are your initials)
    3. Once the slice page loads, click the Add Resources button placed at the top left part of the screen.
      NOTE: If you get a warning about not having uploaded ssh keys just follow the instructions on providing an ssh key before you proceed.
    4. In the Choose RSpec section, choose the Hello GENI entry. The selected RSpec file is stored in the Portal database, and a copy is available for viewing by selecting the "RSpecs" menu item under your name in the upper right corner of the GENI portal page.
    5. You will need to choose an aggregate where you want this topology to be instantiated. Click on the Site 0 box and a panel on the left side of the canvas will appear. Choose any aggregate with InstaGENI or ExoGENI in it's name.
    6. Click on the Reserve Resources button on them bottom left part of the screen.
    7. Wait while your resources are being reserved. This will take several minutes so be patient. The nodes will turn green to signify that your resources are ready.
    Add Aggregate
    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. Follow these instructions and log in to the server node. Get the control interface IP address by typing ifconfig. This IP address should be accessible from the internet. In a web browser, type the IP address found from ifconfig.
    2. 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.
    3. 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 Jacks canvas.
    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: