| 34 | |
| 35 | == Initial configuration == |
| 36 | |
| 37 | When you install FOAM for the first time (i.e. not an upgrade to an existing installation), you should configure FlowVisor and e-mail; those steps are part of the official [https://openflow.stanford.edu/display/FOAM/0.8.x+Install+Guide FOAM 0.8 install guide]. |
| 38 | |
| 39 | For GENI purposes, we recommend also configuring your site tag, admin e-mail (which causes it to show up in sliverstatus), and max lease: |
| 40 | |
| 41 | * Your site tag should be something that uniquely identifies this FOAM instance. We use foam.gpolab.bbn.com (a CNAME that points to our FOAM server) at BBN. |
| 42 | * The admin e-mail setting should generally be the same address you used when you set up e-mail. We use foam-admin@gpolab.bbn.com (a list with a couple of admins on it) at BBN. |
| 43 | * The max lease setting controls how the maximum value of the sliver expiration date (e.g. when an experimenter does a renewsliver). We use 9000 hours (about a year) at BBN, and recommend that; making this short just means that experimenters who want a long-lived sliver have to do a renewsliver more frequently. |
| 44 | |
| 45 | To set those with foamctl (replace the "value" part with the values you want to use): |
| 46 | |
| 47 | {{{ |
| 48 | foamctl config:set-value --key="geni.site-tag" --value="foam.gpolab.bbn.com" --passwd-file=/opt/foam/etc/foampasswd |
| 49 | foamctl config:set-value --key="site.admin.email" --value="foam-admin@gpolab.bbn.com" --passwd-file=/opt/foam/etc/foampasswd |
| 50 | foamctl config:set-value --key="geni.max-lease" --value=9000 --passwd-file=/opt/foam/etc/foampasswd |
| 51 | }}} |