The objective of this document is to describe how to test speedo with the Java Data Objects Technology Compatibility Kit (JDOTCK).
The distribution of the JDOTCK incudes the JDO Reference Impementation (jdori.jar) and the launcher of the test suite (javatest.jar) but does not include the required tools:
1. Create the jdotck directory and place the jdotck.zip ant the antlr-2.7.0.zip files into it.
2. Modify the properties in the file speedo/test/tck/build.properties (define your jdotck.dir and systemname).
3. Ensure that ant and JDK are in $PATH
4. Run the ant task "install_tck".
ant install_tck
Creates directories ${jdotck}/[classes, database, enhanced, iut_jars]
Generates the testsuite.jte (JavaTest Environment file)
Generates the jdotck.policy file which declares the security policy of the test.
Builds all the files
Enhances all test classes for datastore identity
Generates the javadoc for all the test classes
Ant is used to invoke JavaTest and the JavaTest Agent which build and execute the JDOTCK tests. Words and phrases in Italic in this section refer to User Interface elements.
For information on JavaTest, please see jdotck/README-javatest.
ant javatest
Starts the GUI JavaTest Harness
Once the JavaTest is up running:
Click Create Work Directory from the Welcome to JavaTest dialog box
Enter the name of a new work directory (for test data and results)
Wait until totals have been calculated...
Select Tasks->Monitor Agent Activity from the options bar
Click on check box Listening from the JavaTest: Agent Monitor window
Click Test Manager tab at the bottom of the JavaTest: Agent Monitor window
Select Configure->Configuration Editor from the JavaTest window
From the JavaTest Configuration Editor window:
Click next > (2nd button) from the Welcome! panel
Select No and click continue > from the Specify Tests to Run? panel
Click continue > from the Filters panel
Select No and click continue > from the Specify an Exclude List? panel
Select No and click continue > from the Specify Keywords? panel
Select No and click continue > from the Specify Status? panel
Click add in the Environment Files
Use the scroll bar to locate the testsuite.jte file. select testsuite.jte and click Add File
click continue > (the greater sign)
Select jdo-runtime-singleJVM in the Test Environment panel. Use the pull down menu.
Click continue > from the Concurrency panel
Click continue > from the Time Factor panel
Take the default ("report") or type in a directory name for the directory into which test reports will be written in the Report Directory panel
click continue >
click the check button (3rd button) in the Congratulations panel
Open another console window, and type:
ant runagent
This will start the JavaTest Agent
Now go back to the JavaTest window, select Run Tests ->Start
Click ok to confirm configuration. The tests will now run until all tests have been attempted.
1. Modify the properties in the file jdotck/speedo.properties. Configure the data source type with the jdbc driver and the jdo options:
2. Copy the jdbc driver in the jdotck/iut_jars directory (pg74jdbc3.jar).
3. Choose a type of object identity (datastore or application).
To run the JDOTCK with test classes enhanced for application identity:
ant useapplicationidentity
To run the JDOTCK with test classes enhanced for datastore identity:
ant usedatastoreidentity
4. Run the ant task "enhance_speedo".
ant enhance_speedo
If you get OutOfMemory error then try this with ant 1.5
java -Xms128MB -Xmx256MB -cp %JAVA_HOME%\lib\tools.jar;%ANT_HOME%\lib\ant.jar;%ANT_HOME%\lib\xercesImpl.jar;..\..\output\dist\speedo.jar org.apache.tools.ant.Main enhance_speedo
If you get OutOfMemory error then try this with ant 1.6
java -Xms128MB -Xmx256MB -cp %JAVA_HOME%\lib\tools.jar;%ANT_HOME%\lib\ant.jar;%ANT_HOME%\lib\xercesImpl.jar;..\..\output\dist\speedo.jar org.apache.tools.ant.launch.Launcher enhance_speedo
If you use a jdk 1.4.2 replace 128MB and 256MB with 128M and 256M