Changes between Version 39 and Version 40 of OpenFlow/FOAM/Testing


Ignore:
Timestamp:
05/06/13 15:41:11 (6 years ago)
Author:
Josh Smift
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OpenFlow/FOAM/Testing

    v39 v40  
    10681068= GENI AM API =
    10691069
    1070 This section tests whether a given FOAM server is compliant with the GENI AM API, using Omni's built-in acceptance test suite. Stanford/ONLab and the GPO generally run these tests when new versions of FOAM are released, but you can run them yourself too, if you want.
     1070This section tests whether a given FOAM server is compliant with the GENI AM API, using Omni's built-in acceptance test suite. The GPO generally runs these tests when new versions of FOAM are released, but you can run them yourself too, if you want.
    10711071
    10721072Pre-requisites/assumptions:
     
    10741074 * You're set up to use Omni in general, and have it in your path as 'omni', i.e. you've successfully used Omni to reserve GENI resources (and have the latest version of the software, a user credential signed by a CA that's trusted by the FOAM server you intend to test, a working omni_config file, etc).
    10751075 * You have four rspec files needed to test with (three valid request rspecs, and one valid manifest rspec). We plan to make some sample rspecs available.
     1076 * You have rspeclint in your path.
    10761077
    10771078You can run these tests wherever you usually use Omni; they don't need to run on the FOAM/FV server.
    10781079
    1079 As of this writing, the current version of GCF is 1.6.2; some of these steps may need to be different if you have a more recent version than that.
    1080 
    1081 Note that this is a streamlined summary of the full docs for running the GCF GENI AM API Acceptance Test Suite. The full docs for that suite are in .../gcf-1.6.2/acceptance_tests/AM_API/README-accept-AMAPI.txt; there's also much more information at http://trac.gpolab.bbn.com/gcf/wiki/AmApiAcceptanceTests.
     1080As of this writing, the current version of GCF is 2.2.1; some of these steps may need to be different if you have a more recent version than that.
     1081
     1082Note that this is a streamlined summary of the full docs for running the GCF GENI AM API Acceptance Test Suite. The full docs for that suite are in .../gcf-2.2.1/acceptance_tests/AM_API/README-accept-AMAPI.txt; there's also more information at http://trac.gpolab.bbn.com/gcf/wiki/AmApiAcceptanceTests.
    10821083
    10831084== Setup ==
     
    10871088{{{
    10881089foamserver=foam.example.edu
    1089 }}}
    1090 
    1091 Set the AM API URL:
    1092 
    1093 {{{
    1094 am=https://${foamserver}:3626/foam/gapi/1
    10951090}}}
    10961091
     
    11081103If you don't already have the latest version of Omni, you can get it from http://www.gpolab.bbn.com/local-sw/.
    11091104
    1110 The rest of these docs assume that you have GCF 1.6.2 in ~/src/gcf-1.6.2.
    1111 
    1112 Change into that directory, and copy in your rspec files:
    1113 
    1114 {{{
    1115 cd ~/src/gcf-1.6.2/acceptance_tests/AM_API
     1105The rest of these docs assume that you have GCF 2.2.1 in ~/src/gcf-2.2.1.
     1106
     1107Change into that directory, set your Python path, and copy in your rspec files:
     1108
     1109{{{
     1110cd ~/src/gcf-2.2.1/acceptance_tests/AM_API
     1111export PYTHONPATH=~/src/gcf-2.2.1/src
    11161112cp $rspec_request1 request1.xml
    11171113cp $rspec_request3 request2.xml
     
    11211117}}}
    11221118
    1123 Set your Python path, and run the tests:
    1124 
    1125 {{{
    1126 export PYTHONPATH=~/src/gcf-1.6.2/src
    1127 ./am_api_accept.py -a $am
     1119Set the V1 AM API URL, and run the V1 tests:
     1120
     1121{{{
     1122am=https://${foamserver}:3626/foam/gapi/1
     1123rm acceptance.log
     1124./am_api_accept.py -V1 -a $am
     1125}}}
     1126
     1127Set the V2 AM API URL, and run the V2 tests:
     1128
     1129{{{
     1130am=https://${foamserver}:3626/foam/gapi/2
     1131rm acceptance.log
     1132./am_api_accept.py -V2 -a $am
    11281133}}}
    11291134
    11301135If you'd like more verbose details about what tests it's running, you can add '--v'.
    11311136
    1132 When not in verbose mode, this will run for a few minutes, and should produce output like
     1137When not in verbose mode, each of those will run for a few minutes, and should produce output like
    11331138
    11341139{{{
    11351140.............
    11361141----------------------------------------------------------------------
    1137 Ran 13 tests in 202.744s
     1142Ran 13 tests in 718.018s
    11381143
    11391144OK