
How to Build, Run, and Profile the Java TWS Benchmark
-----------------------------------------------------

The benchmark is being built and run with
-> Ant >= 1.7 (project scripts generated by Netbeans)
-> JDK >= 1.5

0)  Configure external dependencies paths

    Copy the configuration sample files
        $ cd ./nbproject

        $ cp -vr configs_sample configs
        configs_sample -> configs
        configs_sample/server-dbg.properties -> configs/server-dbg.properties
        configs_sample/server-opt.properties -> configs/server-opt.properties

        $ cp -vr private_sample private
        private_sample -> private
	...
        private_sample/private.properties -> private/private.properties

    Edit the files
        ./configs/server-dbg.properties
        ./configs/server-opt.properties
        ./private/private.properties
    for the paths to TWS's external software dependencies.

    Edit the file
        ./private/config.properties
    to select the JVM run configuration (debug/optimized settings).

    Important: the JVM's -d32/-d64/default machine type settings must match
    the architecture type of the NDB libraries.

1)  Build the classfiles

    Standard project targets:
        $ ant default
        $ ant compile
        $ ant clean
        $ ant jar
        $ ant javadoc
        $ ant deps-jar
        $ ant deps-clean

2) Run the benchmark

    Edit the benchmark's settings (copy from ../run.properties.sample)
        ../run.properties

    Have a running NDB Cluster with loaded schema file: ../schema.sql.

    Run (and Profiling?) targets:
        $ ant run

    The benchmark's result data is written to a generated log_XXX file.

Comments or questions appreciated.
martin.zaun@oracle.com
