Version 40 (modified by, 13 years ago) (diff)


Enterprise GENI Evaluation

The Enterprise-GENI solution is composed of four main entities:

  • OpenFlow-based Substrate Version ??: Switches that communicate using the OpenFlow protocol to the OpenFlow controller. Software version available include
  • FlowVisor Version : Custom-build OpenFlow controller that isolates experiment control traffic.
  • Opt In Manager Version 0.2.5 : Administrative application for OpenFlow-based network.
  • Expedient Version 4.0.2: Portal for defining experiment resources.
  • NOX Zaku branch: An OpenFlow Controller providing flow level control of network traffic.
  • SNAC An OpenFlow Controller which is a NOX module. Not covered here.
  • FOAM Version 0.2.x will replace the Expedient Aggregate Manager and Opt In Manager. Version? Location?

Evaluation Time Frame: September 26, 2011

Enterprise GENI Findings

Initial review of the FlowVisor deployment page and FlowVisor found the following issues.

Reviewed several versions of the foam package (0.2.9, 0.2.11). Ran into several issues:

  • Advertisement rspecs do not have the component_manager_id in the openflow:datapath element
  • Advertisement rspecs have dpid attribute in the datapath element.
  • Foam package was corrupted in re-install due to process not being stopped before uninstall.

The expedient review ran into to blocking issues that could not be resolved and evaluation was stopped.

Enterprise GENI How-to

FlowVIsor Installation and Configuration

Using instructions from, installed the Ubuntu package FlowVisor Version First, add the following to /etc/apt/sources.list file:

   deb unstable/binary-$(ARCH)/

Install package:

   sudo apt-get update && sudo apt-get install flowvisor

Before proceeding to configuration step, should modify the SSL_KEYPASSWD in the file /usr/etc/flowvisor/ to define the password to be used by the fv-admin profile:

You can now start the FlowVisor, note if this is a new FlowVisor installation, the SSL keystor must be generated, below is a capture of the process:

  $ sudo /usr/sbin/flowvisor /usr/etc/flowvisor/config.xml 
  Starting FlowVisor
  Running with FV_JVM_ARGS=-server -Xms100M -Xmx1000M -XX:OnError=flowvisor-crash-logger -XX:+UseConcMarkSweepGC
  --- Setting logging level to NOTE
  java.lang.RuntimeException: SSL Key Store file not found: '/usr/etc/flowvisor/mySSLKeyStore'
  Please generate with `fvconfig generateCert`
        at org.flowvisor.api.APIServer.spawn(
        at org.flowvisor.FlowVisor.main(

  $ sudo fvconfig generateCert
  Trying to generate SSL Server Key with passwd from scripts/
  Generating cert with common name ==

  $ sudo /usr/sbin/flowvisor /usr/etc/flowvisor/config.xml &
  [1] 1283
  Starting FlowVisor
  Running with FV_JVM_ARGS=-server -Xms100M -Xmx1000M -XX:OnError=flowvisor-crash-logger -XX:+UseConcMarkSweepGC
  --- Setting logging level to NOTE

The FlowVisor configuration that is delivered includes sample slices that should be deleted:

  fvctl --passwd-file=/root/.fvp  deleteSlice alice
  fvctl --passwd-file=/root/.fvp  deleteSlice bob

Issues found, captured in email. (and bugs?)

FOAM Installation and Configuration

Followed the install from package instruction found at the [ FOAM install] page. Created a file foam.list in the directory /etc/apt/sources.list.d/ containing the following:

   deb unstable/all/

Installed the foam package and initialize the FOAM database:

   $ sudo apt-get update 
   $ sudo apt-get install foam
   $ sudo -u www-data foamctl init-db
   Certificates Directory [/opt/foam/etc/gcf-ca-certs]: 
   Site Tag []:
   FlowVisor Hostname:
   FlowVisor XMLRPC Port [8080]: 
   FlowVisor JSON RPC Port [8081]: 
   fvadmin user password: 

Set up the FOAM administrative account password:

  sudo foamctl set-password

Removed the default nginx site:

sudo rm /etc/nginx/sites-enabled/default 

Installed a trusted root certificate from, bundled the certificate and started the FOAM services:

  $ sudo wget -O /opt/foam/etc/gcf-ca-certs/
  $ sudo wget -O /opt/foam/etc/gcf-ca-certs/emulab.pem --no-check-certificate
  $ sudo foamctl bundle-certs
  $ sudo service nginx start
  $ sudo service foam start 

Once the FOAM services are started generated a simple RSPEC using instructions from the Example RSPEC and Convert Expedient to FOAM RSPEC page:

<?xml version="1.1" encoding="UTF-8"?>
<rspec  xmlns=""

    <openflow:sliver description="Luisa sliver description"

        <openflow:controller url="" type="primary" />
        <openflow:group name="mygroup">

            <openflow:datapath component_id="" component_manager_id="urn:publi" > 
                <openflow:port name="GBE0/22" num="22"/>

              <openflow:use-group name="mygroup" />
                     <openflow:dl_dst value="00:0c:29:9a:28:00,00:0c:29:1f:75:b0"/>

              <openflow:use-group name="mygroup" />
                 <openflow:dl_src value="00:0c:29:9a:28:00,00:0c:29:1f:75:b0"/> 

Using omni tools created a slice and got OF resources:

$  ./src/ -n -a createslice foamslice1
INFO:omni:Loading config file omni_config
INFO:omni:Using control framework pgeni
INFO:omni:Created slice with Name foamslice1, URN, Expiration 2011-09-30 00:26:18
INFO:omni: ------------------------------------------------------------
INFO:omni: Completed createslice:

  Options as run:
                framework: pgeni
                native: True

  Args: createslice foamslice1

  Result Summary: Created slice with Name foamslice1, URN, Expiration 2011-09-30 00:26:18
INFO:omni: ============================================================

 ./src/ -n -a createsliver foamslice1 FOAM.rspec      
INFO:omni:Loading config file omni_config
INFO:omni:Using control framework pgeni
INFO:omni:Slice expires within 1 day on 2011-09-30 00:26:18 UTC
INFO:omni:Creating sliver(s) from rspec file FOAM.rspec for slice
INFO:omni:Asked to reserve resources. Result:
INFO:omni:<?xml version="1.0" ?>
INFO:omni:<!-- Reserved resources for:
        Slice: foamslice1
        At AM:
<rspec type="manifest" xmlns="" xmlns:openflow="" xmlns:xs="" xs:schemaLocation="               ">  

      <openflow:sliver description="Luisa sliver description" email="" ref="">    

            <openflow:controller type="primary" url=""/>    

            <openflow:group name="mygroup">      

                  <openflow:datapath component_id="" component_manager_id="">         
                        <openflow:port name="GBE0/22" num="22"/>        


                    <openflow:use-group name="mygroup"/>      
                             <openflow:dl_dst value="00:0c:29:9a:28:00,00:0c:29:1f:75:b0"/>        

                    <openflow:use-group name="mygroup"/>      
                         <openflow:dl_src value="00:0c:29:9a:28:00,00:0c:29:1f:75:b0"/>         

INFO:omni: ------------------------------------------------------------
INFO:omni: Completed createsliver:

  Options as run:
                framework: pgeni
                native: True

  Args: createsliver foamslice1 FOAM.rspec

  Result Summary: Slice expires within 1 day(s) on 2011-09-30 00:26:18 UTC
Reserved resources on  
INFO:omni: ============================================================

NOX Installation

Followed the NOX Installation instructions from the web site. only evaluated Ubuntu instructions. Install dependencies:

$ cd /etc/apt/sources.list.d
$ sudo wget
$ sudo apt-get update
$ sudo apt-get install nox-dependencies

Downloaded the NOX source code, but had to install the following undocumented packages for the instruction to work:

$ sudo apt-get install git-core

NOX installation

$ git clone git://
$ cd nox
$ git checkout zaku 
$ ./ 
$ mkdir build/
$ cd build/
$ ../configure
$ make -j 5

Followed the Using NOX instructions from the web site.

$ cd nox/build/src
$ ./nox_core -v -i ptcp:6633

Installed the nox-gui pre-requisites and started nox-gui:

$ sudo apt-get install python-qt4 python-simplejson

Expedient Installation

Installed Expedient using the git repository instructions found in the Checkout Repository section of the Installing Expedient page, but first had to install pre-requisites:

  $ sudo apt-get install python-2.6
  $ sudo apt-get install xmlsec1
  $ sudo apt-get install libxmlsec1-devel
  $ sudo apt-get install python-setuptools 
  $ sudo apt-get install python-django
  $ sudo apt-get install python-django-registration
  $ sudo apt-get install python-decorator
  $ sudo apt-get install m2crypto
  $ sudo apt-get install python-imaging (PIL)
  $ sudo apt-get install python-dateutil
  $ sudo apt-get install python-crypto
  $ sudo apt-get install python-paramiko
  $ sudo apt-get install python-webob            
  $ sudo apt-get install python-OpenSSL
  $ sudo apt-get install python-pyquery
  $ sudo apt-get install sphinxsearch
  $ sudo apt-get install python-pygments
  $ sudo apt-get install libxslt-dev   
  $ sudo apt-get install python-zsi 
  $ sudo apt-get install python-mysqldb
  $ sudo easy_install django-autoslug
  & sudo easy_install django-renderform

Checked out the code:

  $ git clone git://
  $ cd expedient/src/python
  $ PYTHONPATH=. python expedient/clearinghouse/ expedient/clearinghouse/
Traceback (most recent call last):
  File "expedient/clearinghouse/", line 10, in <module>
    from expedient.clearinghouse.commands.utils import bootstrap_local_settings
  File "/home/lnevers/expedient/src/python/expedient/clearinghouse/commands/", line 12, in <module>
    from expedient.clearinghouse.defaultsettings.django import CONF_DIR
  File "/home/lnevers/expedient/src/python/expedient/clearinghouse/defaultsettings/", line 104, in <module>
  File "/home/lnevers/expedient/src/python/expedient/clearinghouse/defaultsettings/", line 31, in append_to_local_setting
    import localsettings
ImportError: No module named localsettings

After running into several issues, stopped evaluation due to the documentation and source not being maintained.

Attachments (1)

Download all attachments as: .zip