Changes between Version 36 and Version 37 of OpenFlow/FOAM


Ignore:
Timestamp:
01/18/13 11:34:29 (7 years ago)
Author:
Josh Smift
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OpenFlow/FOAM

    v36 v37  
    3737When you install FOAM for the first time (i.e. not an upgrade to an existing installation), you should configure its ability to send you administrative 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].
    3838
    39 We typically put the FOAM admin password into /opt/foam/etc/foampasswd, so you don't have to type it every time you run a foamctl command. Make sure that it's only readable by people who should have full admin access to FOAM on your system! (World-readable might be fine if only FOAM admins have accounts on your FOAM server; or you might want to make it only group-readable by a group that includes the FOAM admins.) The examples on the rest of this page assume that you've done that.
     39We typically put the FOAM admin password into /etc/foam.passwd, so you don't have to type it every time you run a foamctl command. Make sure that it's only readable by people who should have full admin access to FOAM on your system! (World-readable might be fine if only FOAM admins have accounts on your FOAM server; or you might want to make it only group-readable by a group that includes the FOAM admins.) The examples on the rest of this page assume that you've done that.
    4040
    4141You'll then need to configure FOAM to point to your FlowVisor, which you can do interactively with {{{foamctl config:set-flowvisor-info}}}, or non-interactively like this (with values that work for your installation):
    4242
    4343{{{
    44 foamctl config:set-value --key="flowvisor.hostname" --value="localhost" --passwd-file=/opt/foam/etc/foampasswd
    45 foamctl config:set-value --key="flowvisor.passwd" --value="$(cat /etc/flowvisor/fvpasswd)" --passwd-file=/opt/foam/etc/foampasswd
     44foamctl config:set-value --key="flowvisor.hostname" --value="localhost" --passwd-file=/etc/foam.passwd
     45foamctl config:set-value --key="flowvisor.passwd" --value="$(cat /etc/flowvisor/fvpasswd)" --passwd-file=/etc/foam.passwd
    4646}}}
    4747
     
    4949
    5050{{{
    51 foamctl config:set-value --key="geni.site-tag" --value="foam.gpolab.bbn.com" --passwd-file=/opt/foam/etc/foampasswd
     51foamctl config:set-value --key="geni.site-tag" --value="foam.gpolab.bbn.com" --passwd-file=/etc/foam.passwd
    5252}}}
    5353
     
    6262
    6363{{{
    64 foamctl config:set-value --key="site.admin.email" --value="foam-admin@gpolab.bbn.com" --passwd-file=/opt/foam/etc/foampasswd
    65 foamctl config:set-value --key="geni.max-lease" --value=9000 --passwd-file=/opt/foam/etc/foampasswd
     64foamctl config:set-value --key="site.admin.email" --value="foam-admin@gpolab.bbn.com" --passwd-file=/etc/foam.passwd
     65foamctl config:set-value --key="geni.max-lease" --value=9000 --passwd-file=/etc/foam.passwd
    6666}}}
    6767
     
    7878cd ~/tmp/foam-upgrade/before
    7979
    80 foamctl geni:list-slivers --passwd-file=/opt/foam/etc/foampasswd > list-slivers-active.txt
    81 foamctl geni:list-slivers --deleted --passwd-file=/opt/foam/etc/foampasswd > list-slivers-deleted.txt
     80foamctl geni:list-slivers --passwd-file=/etc/foam.passwd > list-slivers-active.txt
     81foamctl geni:list-slivers --deleted --passwd-file=/etc/foam.passwd > list-slivers-deleted.txt
    8282
    8383egrep '(email|desc|slice_urn|sliver_urn)' list-slivers-active.txt | sort > list-slivers-active-cooked.txt
     
    9797cd ~/tmp/foam-upgrade/after
    9898
    99 foamctl geni:list-slivers --passwd-file=/opt/foam/etc/foampasswd > list-slivers-active.txt
    100 foamctl geni:list-slivers --deleted --passwd-file=/opt/foam/etc/foampasswd > list-slivers-deleted.txt
     99foamctl geni:list-slivers --passwd-file=/etc/foam.passwd > list-slivers-active.txt
     100foamctl geni:list-slivers --deleted --passwd-file=/etc/foam.passwd > list-slivers-deleted.txt
    101101
    102102egrep '(email|desc|slice_urn|sliver_urn)' list-slivers-active.txt | sort > list-slivers-active-cooked.txt
     
    146146
    147147{{{
    148 foamctl config:set-value --key="geni.approval.approve-on-creation" --value="2" --passwd-file=/opt/foam/etc/foampasswd
     148foamctl config:set-value --key="geni.approval.approve-on-creation" --value="2" --passwd-file=/etc/foam.passwd
    149149}}}
    150150
     
    205205Here are some specific commands that we've found useful for performing common tasks.
    206206
    207 These commands all assume that you're running them on the FOAM server, and that you have a file /opt/foam/etc/foampasswd, containing the FOAM admin password.
     207These commands all assume that you're running them on the FOAM server, and that you have a file /etc/foam.passwd, containing the FOAM admin password.
    208208
    209209=== Get a list of slivers ===
     
    212212
    213213{{{
    214 foamctl geni:list-slivers -s Pending --passwd-file=/opt/foam/etc/foampasswd
     214foamctl geni:list-slivers -s Pending --passwd-file=/etc/foam.passwd
    215215}}}
    216216
     
    218218
    219219{{{
    220 foamctl geni:list-slivers --passwd-file=/opt/foam/etc/foampasswd
     220foamctl geni:list-slivers --passwd-file=/etc/foam.passwd
    221221}}}
    222222
     
    232232
    233233{{{
    234 foamctl geni:list-slivers --deleted --passwd-file=/opt/foam/etc/foampasswd
     234foamctl geni:list-slivers --deleted --passwd-file=/etc/foam.passwd
    235235}}}
    236236
     
    240240
    241241{{{
    242 foamctl geni:list-slivers --passwd-file=/opt/foam/etc/foampasswd | egrep sliver_urn.+exampleslice
     242foamctl geni:list-slivers --passwd-file=/etc/foam.passwd | egrep sliver_urn.+exampleslice
    243243}}}
    244244
     
    246246
    247247{{{
    248 slicename=exampleslice ; sliver_urn=$(foamctl geni:list-slivers --passwd-file=/opt/foam/etc/foampasswd | egrep sliver_urn.+$slicename | sed -e 's/ *"sliver_urn": "\(.*\)".*/\1/') ; flowvisor_slice=$(echo $sliver_urn | awk -F : '{print $NF}')
     248slicename=exampleslice ; sliver_urn=$(foamctl geni:list-slivers --passwd-file=/etc/foam.passwd | egrep sliver_urn.+$slicename | sed -e 's/ *"sliver_urn": "\(.*\)".*/\1/') ; flowvisor_slice=$(echo $sliver_urn | awk -F : '{print $NF}')
    249249}}}
    250250
     
    256256
    257257{{{
    258 foamctl geni:show-sliver -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     258foamctl geni:show-sliver -u $sliver_urn --passwd-file=/etc/foam.passwd
    259259}}}
    260260
     
    262262
    263263{{{
    264 foamctl geni:show-sliver -r -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     264foamctl geni:show-sliver -r -u $sliver_urn --passwd-file=/etc/foam.passwd
    265265}}}
    266266
     
    268268
    269269{{{
    270 foamctl geni:show-sliver -s -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     270foamctl geni:show-sliver -s -u $sliver_urn --passwd-file=/etc/foam.passwd
    271271}}}
    272272
     
    274274
    275275{{{
    276 foamctl geni:show-sliver -f -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     276foamctl geni:show-sliver -f -u $sliver_urn --passwd-file=/etc/foam.passwd
    277277}}}
    278278
     
    282282
    283283{{{
    284 foamctl geni:approve-sliver -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     284foamctl geni:approve-sliver -u $sliver_urn --passwd-file=/etc/foam.passwd
    285285}}}
    286286
     
    290290
    291291{{{
    292 foamctl geni:disable-sliver -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     292foamctl geni:disable-sliver -u $sliver_urn --passwd-file=/etc/foam.passwd
    293293}}}
    294294
     
    298298
    299299{{{
    300 foamctl geni:reject-sliver -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     300foamctl geni:reject-sliver -u $sliver_urn --passwd-file=/etc/foam.passwd
    301301}}}
    302302
     
    306306
    307307{{{
    308 foamctl geni:delete-sliver -u $sliver_urn --passwd-file=/opt/foam/etc/foampasswd
     308foamctl geni:delete-sliver -u $sliver_urn --passwd-file=/etc/foam.passwd
    309309}}}
    310310
     
    319319oldsliver=<old sliver URN>
    320320newsliver=<new sliver URN>
    321 foamctl geni:show-sliver -r -u $oldsliver --passwd-file=/opt/foam/etc/foampasswd > old.txt
    322 foamctl geni:show-sliver -r -u $newsliver --passwd-file=/opt/foam/etc/foampasswd > new.txt
     321foamctl geni:show-sliver -r -u $oldsliver --passwd-file=/etc/foam.passwd > old.txt
     322foamctl geni:show-sliver -r -u $newsliver --passwd-file=/etc/foam.passwd > new.txt
    323323diff -u old.txt new.txt
    324324}}}
     
    375375
    376376{{{
    377 foamctl config:set-value --key="flowvisor.passwd" --value="$(cat /etc/flowvisor/fvpasswd)" --passwd-file=/opt/foam/etc/foampasswd
     377foamctl config:set-value --key="flowvisor.passwd" --value="$(cat /etc/flowvisor/fvpasswd)" --passwd-file=/etc/foam.passwd
    378378}}}
    379379