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 https://s3.amazonaws.com/bssoftworks/foam-pkg/ lucid/stable/all/

Debian (6.0 and later)

Code Block
deb https://s3.amazonaws.com/bssoftworks/foam-pkg/ 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
  • 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 admin:bundle-certs
  • Start the services
Code Block
% sudo service nginx start
% sudo service foam start
  • Setup your admin account (the default password is 'admin'):
Code Block
% sudo foamctl auth:set-admin-passwd
Password: 
New foamadmin password: 
Enter new password again: 
  • Remove the default nginx site (if you're not running it intentionally):
Code Block
% sudo rm /etc/nginx/sites-enabled/default
  • 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 config: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).