JET - Java Engine for Testing
=============================

1.0 LICENCE

See the LICENCE and COPYING files.


2.0 Editing

Open the jet-framework/pom.xml file in NetBeans 6.7 or newer.

3.0 BUILD

JET is build with Maven 2.0. You can download it from
http://maven.apache.org/, or use the software installation tool for
your operating system.

To build JET you should run:

   export JAVA_HOME=/path/to/java6
   path/to/apache-maven/bin/mvn clean install site

(If you think this is slow, you can skip "site". install is enough to
generate the .jar files, "site" will generate documentation and lots
of QA reports on the source code as well.)

The first time you run maven, it will download a lot of dependencies
to your ~/.m2 directory. This can take some time, depending on if you
have used maven before and on the speed of your internet connection.
Times up to ten minutes has been reported, so have some patience the
first time you build.

The result will be a set of JAR files containing the compiled JET:

   jet/target/jet-1.0-SNAPSHOT.jar
   jag/target/jag-1.0-SNAPSHOT.jar
   jet-batch/target/jet-batch-1.0-SNAPSHOT.jar
   jet-load/target/jet-load-1.0-SNAPSHOT.jar
   jet-util/target/jet-util-1.0-SNAPSHOT.jar
   jag-ops/target/jag-ops-1.0-SNAPSHOT.jar

And HTML pages containing a description of the project:

   target/site/index.html
   jet/target/site/index.html
   jag/target/site/index.html
   jet-batch/target/site/index.html
   jet-load/target/site/index.html
   jet-util/target/site/index.html
   jag-ops/target/site/index.html

If you get the following:

   [ERROR] BUILD ERROR
   [INFO] [INFO] Failed to resolve artifact.

For JMXRemote_optional and JDMK, follow the guidance in the error message.
Especially this part:

   Try downloading the file manually from:
   http://java.sun.com/products/JavaManagement/download.html

   Then, install it using the command:
   mvn install:install-file -DgroupId=javax.management \
                            -DartifactId=jmxremote_optional \
                            -Dversion=1.2.1 \
                            -Dpackaging=jar \
                            -Dfile=/path/to/jmxremote_optional.jar

This must be done for the jmxremote_optional and
jmxtools artifacts.

You will have to do this for both packages that is missing from
the standard repositories (because of click-through-licenses).