Changes between Version 36 and Version 37 of OpenFlow/FOAM


Ignore:
Timestamp:
01/18/13 11:34:29 (11 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