24-May-2010
+7-July-2011
Overview
In order to demonstrate compliance with the Java Data Objects specification, an implementation must successfully run all of the TCK @@ -42,11 +42,11 @@ configuration information and test results. For an example of the required posting, please see http://db.apache.org/jdo/tck/final.
Prerequisites
-In order to run the TCK, you must install maven 1.x.x. +
In order to run the TCK, you must install maven 2.x.x. Maven -http://maven.apache.org/maven-1.x/ +http://maven.apache.org/docs/2.2.1/release-notes.html is the -driver of the test programs. Note that Maven 2 is not supported.
+driver of the test programs. Note that Maven 3 is not supported.You must test the IUT on all configurations that the IUT supports. This includes different hardware and operating systems, different versions of Java, and different datastores. The TCK supports Java @@ -130,12 +130,8 @@
Modifying the Configuration
The Implementation Under Test (IUT) can be installed into the -iut_jars directory in the TCK directory. Any .jar files in this +lib/iut directory above the TCK directory. Any .jar files in this directory are added to the class path used to run the tests.
-There are properties in the build.properties file in the TCK -directory that must be changed to configure the IUT execution and -enhancement (optional) environment. These properties begin with -iut.runtck and iut.enhancer.
There is are three properties files that must be modified to be IUT-specific, all located in the TCK src/conf directory. The @@ -152,12 +148,12 @@
Running the Tests
From the installation directory, change to the TCK directory. From -the TCK directory, call "maven build" which will build the +the TCK directory, call "mvn integration-test" which will build the jar files used in the tests, create the Derby database, install the schema into the Derby database, and run the TCK on the Reference Implementation. Success indicates that the TCK was installed correctly.
-Then call "maven runtck.iut" to run the tests on the +
Then call "mvn -Djdo.tck.impl=iut runtck" to run the tests on the Implementation Under Test. This will produce console output plus a directory in the TCK/target/logs directory whose name contains the date/time the tests were started. This directory contains the output @@ -167,7 +163,7 @@ simultaneously.
Debugging the IUT while Running TCK tests
-Execute "maven help" in the TCK directory in order to +
Execute "mvn jdo-exectck:help" in the TCK directory in order to get information on running the TCK tests with a debugger. In particular, properties jdo.tck.cleanupaftertest, jdo.tck.cfglist, jdo.tck.identitytypes, and jdo.tck.dblist may be useful.