RUNNING THE TUTORIAL:
=====================

1. NEEDED JARS
(note that tutorial project includes them already, so the list below is given for the reference)

* cayenne-server.jar
* cayenne-agent.jar
* derby.jar (v. 10.2.2.0 or newer is required; example is built against 10.3.1.4)
* jpa.jar (e.g. Geronimo JPA jar from here: http://mirrors.ibiblio.org/pub/mirrors/maven2/org/apache/geronimo/specs/geronimo-jpa_3.0_spec/1.0/geronimo-jpa_3.0_spec-1.0.jar)
* asm.jar (v. 3.0)
* asm-commons.jar (v. 3.0)
* all Cayenne distro "third-party/" jars

2. Import Tutorial project in Eclipse.

3. Set desired Derby DB location in "persistence.xml" and "sql/derbydb.sql" files.

4. Create test Derby database, use Derby "ij" client tool (again, the example is tested on Derby 10.3.1.4):

   $ export DERBY_HOME=[path to derby]
   $ export PATH=$DERBY_HOME/bin:$PATH
   $ ij cayenne-jpa-tutorial/sql/derbydb.sql

5. Run the tutorial from Eclipse:

  * Main class is 'cayenne.jpa.tutorial.Main'
  * In the "Arguments" tab of the "Run" panel set the following VM argument  (edit for the proper agent jar location):

  -javaagent:/path/to/cayenne-jpa-tutorial/lib/cayenne-agent-3.0-SNAPSHOT.jar