Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Install from Packages

Modern apt-based systems:
  • Create the file foam.list and place it in /etc/apt/sources.list.d/:

Distribution

Path

Ubuntu (10.04 and later)

Code Block
deb http://updates.flowvisor.org/openflow/downloads/GENI/DEB/ lucid/stable/all/

Debian (6.0 and later)

Code Block
deb http://updates.flowvisor.org/openflow/downloads/GENI/DEB/ squeeze/stable/all/
  • Update apt packages list and install FOAM:
Code Block
% sudo apt-get update
% sudo apt-get install foam
  • Agree to install foam without verification:
Code Block
languagenone
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following extra packages will be installed:
  libxmlsec1 libxmlsec1-openssl libxslt1.1 nginx python-dateutil python-m2crypto python-pip python-pkg-resources python-setuptools xmlsec1
Suggested packages:
  python-distribute python-distribute-doc
The following NEW packages will be installed:
  foam libxmlsec1 libxmlsec1-openssl libxslt1.1 nginx python-dateutil python-m2crypto python-pip python-pkg-resources python-setuptools xmlsec1
0 upgraded, 11 newly installed, 0 to remove and 51 not upgraded.
Need to get 1,550kB of archives.
After this operation, 5,444kB of additional disk space will be used.
Do you want to continue [Y/n]? 
WARNING: The following packages cannot be authenticated!
  foam
Install these packages without verification [y/N]? y
  • Initialize the FOAM database:
Code Block
% sudo -u www-data foamctl init-db
Certificates Directory [/opt/foam/etc/gcf-ca-certs]: 
Site Tag [my.host.fqdn]: 
FlowVisor Hostname: localhost
FlowVisor XMLRPC Port [8080]: 
FlowVisor JSON RPC Port [8081]: 
fvadmin user password: 
  • Setup your admin account:
Code Block
% sudo foamctl set-password
FOAM Admin Password: 
  • Remove the default nginx site (if you're not running it intentionally):
Code Block
% sudo rm /etc/nginx/sites-enabled/default
  • Get some trusted root certs and bundle them:
Code Block
% sudo wget http://www.pgeni.gpolab.bbn.com/ca-cert/pgeni.gpolab.bbn.com.pem -O /opt/foam/etc/gcf-ca-certs/pgeni.gpolab.bbn.com.pem
...and/or any other root certs you might want - place them all in /opt/foam/etc/gcf-ca-certs/...
% sudo foamctl bundle-certs
  • Start the services
Code Block
% sudo service nginx start
% sudo service foam start
  • Setup email configuration:
    (Note that you don't have to set a value for Reply-To: unless you want it to be different from the From: address for some reason.)
Code Block
% foamctl setup-email
Password: <admin password> 
Admin email:                  
SMTP Server: 
From: 
Reply-To: 
  • Make sure port 3626 is reachable by experimenters (i.e. isn't blocked by network firewalls, iptables, etc).