0.6 Install Guide
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) deb http://updates.flowvisor.org/openflow /downloads/GENI/DEB/ lucid/stable/all/
Debian (6.0 and later) deb http://updates.flowvisor.org/openflow /downloads/GENI/DEB/ squeeze/stable/all/
Update apt packages list and install FOAM:
% sudo apt-get update % sudo apt-get install foam
Agree to install foam without verification:
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: % 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:
% sudo foamctl set-password FOAM Admin Password:
Remove the default nginx site (if you're not running it intentionally):
% sudo rm /etc/nginx/sites-enabled/default
Get some trusted root certs and bundle them:
% 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
% 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.)
% foamctl setup-email Password:
Make sure port 3626 is reachable by experimenters (i.e. isn't blocked by network firewalls, iptables, etc).