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

Timestamp:

05/06/13 15:41:11 (11 years ago)

Author:

Josh Smift

Comment:

--

OpenFlow/FOAM/Testing

@@ -1068 +1068 @@
 = GENI AM API =
 
-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.
+This 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.
 
 Pre-requisites/assumptions:
@@ -1074 +1074 @@
  * 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).
  * 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.
+ * You have rspeclint in your path.
 
 You can run these tests wherever you usually use Omni; they don't need to run on the FOAM/FV server.
 
-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.
-
-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.
+As 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.
+
+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-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.
 
 == Setup ==
@@ -1087 +1088 @@
 {{{
 foamserver=foam.example.edu
-}}}
-
-Set the AM API URL:
-
-{{{
-am=https://${foamserver}:3626/foam/gapi/1
 }}}
 
@@ -1108 +1103 @@
 If you don't already have the latest version of Omni, you can get it from http://www.gpolab.bbn.com/local-sw/.
 
-The rest of these docs assume that you have GCF 1.6.2 in ~/src/gcf-1.6.2.
-
-Change into that directory, and copy in your rspec files:
-
-{{{
-cd ~/src/gcf-1.6.2/acceptance_tests/AM_API
+The rest of these docs assume that you have GCF 2.2.1 in ~/src/gcf-2.2.1.
+
+Change into that directory, set your Python path, and copy in your rspec files:
+
+{{{
+cd ~/src/gcf-2.2.1/acceptance_tests/AM_API
+export PYTHONPATH=~/src/gcf-2.2.1/src
 cp $rspec_request1 request1.xml
 cp $rspec_request3 request2.xml
@@ -1121 +1117 @@
 }}}
 
-Set your Python path, and run the tests:
-
-{{{
-export PYTHONPATH=~/src/gcf-1.6.2/src
-./am_api_accept.py -a $am
+Set the V1 AM API URL, and run the V1 tests:
+
+{{{
+am=https://${foamserver}:3626/foam/gapi/1
+rm acceptance.log
+./am_api_accept.py -V1 -a $am
+}}}
+
+Set the V2 AM API URL, and run the V2 tests:
+
+{{{
+am=https://${foamserver}:3626/foam/gapi/2
+rm acceptance.log
+./am_api_accept.py -V2 -a $am
 }}}
 
 If you'd like more verbose details about what tests it's running, you can add '--v'.
 
-When not in verbose mode, this will run for a few minutes, and should produce output like
+When not in verbose mode, each of those will run for a few minutes, and should produce output like
 
 {{{
 .............
 ----------------------------------------------------------------------
-Ran 13 tests in 202.744s
+Ran 13 tests in 718.018s
 
 OK