wiki:GiB-gettingStarted

Version 11 (modified by Vic Thomas, 7 years ago) (diff)

--

Table of Contents

  1. Using GENI-in-a-Box

Using GENI-in-a-Box

This page describes how to install and use GENI-in-a-Box on your computer.

Installing GENI-in-a-Box

Please make sure you have VirtualBox Version 4.1.16 or later installed on your computer.

  1. Start up VirtualBox and from the VirtualBox "File" menu, select "Import Appliance...".
  1. The VirtualBox Appliance Wizard will start up and guide you through the import of the GENI-in-a-Box virtual machine image you downloaded. Please accept the default VM settings during the import.
  1. When the import is done, and entry for GENI-in-a-Box will appear in the Oracle VM VirtualBox Manager window. Select this entry and click the green arrow labeled Start at the top of this window. A new window will open up and you will see Linux boot up in this window. You will automatically be logged into this Linux virtual machine when it is booted.

Getting Started

  1. You will be automatically logged into the GENI-in-a-Box virtual machine when it starts up. Open up a terminal window by clicking on the icon for a terminal on top of the screen.
  1. In the terminal window, use Omni to list the aggregates available to you using the command omni.py listaggregates. You should see something like this in your terminal window:
    $ omni.py listaggregates
    INFO:omni:Loading config file /home/gibuser/.gcf/omni_config
    INFO:omni:Using control framework gib_ch
    INFO:omni:Listing 1 aggregates...
    INFO:omni:  Aggregate 1:
    urn:publicid:IDN+geni:gpo:gcf:am1+authority+am 
    http://geni-in-a-box.net:8001
    INFO:omni: ------------------------------------------------------------
    INFO:omni: Completed listaggregates:
    
        Options as run:
                    framework: gib_ch
    		getversionCacheName: /home/gibuser/.gcf/get_version_cache.json
    
        Args: listaggregates
    
        Result Summary: Found 1 aggregate. URN: urn:publicid:IDN+geni:gpo:gcf:am1+authority+am; URL: http://geni-in-a-box.net:8001 
    INFO:omni: ============================================================
    $ 
    

Look at the Result Summary from Omni. You'll see that Omni found one aggregate available to you at URL http://geni-in-a-box.net:8001. This is the aggregate you will use to run your experiments.

  1. Now, let's find out the GENI AM API version and GENI Rspecs version supported by this aggregate using the command omni.py -a http://geni-in-a-box.net:8001:
    $omni.py  -a http://geni-in-a-box.net:8001 getversion
    INFO:omni:Loading config file /home/gibuser/.gcf/omni_config
    INFO:omni:Using control framework gib_ch
    INFO:omni:AM URN: unspecified_AM_URN (url: http://geni-in-a-box.net:8001) has version:
    INFO:omni:{   'geni_ad_rspec_versions': [   {   'extensions': [],
                                          'namespace': 'http://www.geni.net/resources/rspec/3',
                                          'schema': 'http://www.geni.net/resources/rspec/3/ad.xsd',
                                          'type': 'geni',
                                          'version': '3'}],
        'geni_api': 2,
        'geni_api_versions': {   '2': 'https://127.0.0.1:8001/'},
        'geni_request_rspec_versions': [   {   'extensions': [],
                                               'namespace': 'http://www.geni.net/resources/rspec/3',
                                               'schema': 'http://www.geni.net/resources/rspec/3/request.xsd',
                                               'type': 'geni',
                                               'version': '3'}]}
    INFO:omni: ------------------------------------------------------------
    INFO:omni: Completed getversion:
    
      Options as run:
    		aggregate: ['http://geni-in-a-box.net:8001']
    		framework: gib_ch
    		getversionCacheName: /home/gibuser/.gcf/get_version_cache.json
    		noGetVersionCache: True
    
      Args: getversion
    
      Result Summary: 
    Got version for http://geni-in-a-box.net:8001
     
    INFO:omni: ============================================================
    $ 
    

The results of this command tell you that the GENI-in-a-Box aggregate manager implements the GENI AM API version 2 and GENI Rspecs version 3.

  1. In the terminal window, cd to the directory geni-in-a-box in your home directory and list the contents of that directory. You will see a number of
       $ cd geni-in-a-box
       $ ls
       click-example.rspec  four-nodes.rspec       islands.rspec  README.txt             two-nodes.rspec
       example-scripts      install-example.rspec  log.test        three-nodes-lan.rspec
    
  1. List the contents of the directory (ls). You will see a number of example request rspec files you can use to get started. We'll walk you through an experiment using one of these rspecs in section sampleExperiment.
  1. Before you try running an experiment verify everything is set up right. Use the http://trac.gpolab.bbn.com/gcf/wiki/Omni omni] experiment tool to list the aggregates available to you: omni.py listaggregates. This command lists the aggregates registered with the slice authority that ships with GENI-in-a-Box. You should see one aggregate listed:
  1. Check the version of the GENI AM API implemented by this aggregate: omni.py --