Installation

These steps will quickly get JumpStart 6.8.n running and editable.

  1. Unzip the download.
    • Unzip the downloaded file, which will give you a directory called jumpstart-6.8.n or similar.
    • Move it to your development area, eg. /devel/jumpstart-6.8.n/ .
    • DO NOT choose a directory whose path contains any spaces, eg. do not use a directory whose path includes C:/Documents and Settings/.
  2. Open it in Eclipse.
    • Eclipse 4.2 ("Juno") is preferred. The Eclipse IDE for Java EE Developers package is good (JumpStart is developed with it).
      Eclipse 3.7 ("Indigo") or 3.6 ("Helios") are OK, but they display many warnings that 4.2 does not (due to changes from Bug 365437).
    • In Eclipse, choose File > Import..., then choose General > Existing Projects into Workspace, click Next >, set the root directory to your jumpstart directory eg. /devel/jumpstart-6.8.n/, click Finish.
    • The project can't build just yet so it will show errors.
  3. Ensure the project is using Java 1.6.
    • In Eclipse, right-click on the project and choose Properties then Java Compiler and ensure Compiler compliance level is 1.6. You may have to turn on Enable project specific settings.
    • Be wary of Sun-JDK version 1.6.0_18. It may upset OpenEJB (see OPENEJB-1131).
  4. Run get-dependent-files.
    The project has an Ant build file, build.xml, with a get-dependent-files target. To run it in Eclipse:
    • Open the Ant view and drag build.xml onto it.
    • If your internet connection is through a proxy then modify the setproxy tag in build.xml, eg.
        <setproxy proxyhost="proxy.mycompany.com" proxyport="8080"></setproxy>
      This may also be necessary in business/build.xml and web/build.xml.
    • Run the get-dependent-files target in the project's build.xml file (find the target in the Ant view and double-click on it). If Ant has problems due to the maven repository being slow or inaccessible, open the project's build.properties and choose a different maven.repo.root, then try running the target again.
    • The new files won't be visible in the project just yet.
  5. Refresh the project.
    • In Eclipse, right-click on the project and choose Refresh. This should build the project successfully and show no errors.
    • It also runs collapser.xml, which builds the collapsed/ directory containing a WAR in "collapsed EAR" format. You can see how has this been configured by displaying the project's properties and choosing Builders.
    • You can see now that the previous step, Run get-dependent-files, populated the following directories with JARS: 
      	business/src/main/lib-compile/
	business/src/main/lib-provided/
	business/src/main/lib-runtime/
	business/src/test/lib-test/
	business/src/test/lib-test-hibernate/
	tools/lib/
	web/src/main/lib-compile/
	web/src/main/lib-provided/
	web/src/main/lib-runtime/
	web/src/test/lib-test/
  6. Set the collapsed directory to derived.
    • In Eclipse, right-click on the collapsed directory, choose Properties, and tick the derived checkbox. Then click OK.
  7. Get Jetty.
    Jetty will be your web server during development.
    • Go to Codehaus Downloads and download jetty-6.1.26.zip (or, if you prefer, go to Jetty and navigate to the download).
    • Once downloaded, unzip it. Move it to a suitable location (eg. /devel/jetty-6.1.26).
    • In Eclipse, choose Window > Preferences > Java > Build Path > User Libraries (or in OS X, choose Eclipse > Preferences... > Java > Build Path > User Libraries), and
    • Click New... and create a new user library called jetty-6.1.26-lib, then
    • Click Add External Jars... and add the following jars from Jetty's lib/ directory to the new user library: 
      	jetty-6.1.26.jar 
	jetty-util-6.1.26.jar 
	plus/jetty-plus-6.1.26.jar 
	naming/jetty-naming-6.1.26.jar
  8. Get OpenEJB.
    OpenEJB will be your embedded EJB container during development.
    • Go to Maven repo1 and download openejb-standalone-4.5.1.zip (or, if you prefer, go to Apache TomEE & OpenEJB and navigate to the download).
    • Once downloaded, unzip it. Move it to a suitable location (eg. /devel/apache-openejb-4.5.1).
    • In Eclipse, choose Window > Preferences > Java > Build Path > User Libraries (or in OS X, choose Eclipse > Preferences... > Java > Build Path > User Libraries), and
    • Click New... and create a new user library called apache-openejb-4.5.1-lib, then
    • Click Add External Jars... and add every JAR in OpenEJB's lib/ directory to the new user library.
  9. If your previous installation of JumpStart was 6.5.4...
    In OpenEJB's lib/, see whether you have hsqldb-2.2.9.jar. If yes, then:
    • Delete OpenEJB's lib/hsqldb-2.2.9.jar and copy JumpStart's tools/lib/hsqldb-2.2.8.jar to OpenEJB's tools/lib/.
    • In Eclipse, choose Window > Preferences > Java > Build Path > User Libraries (or in OS X, choose Eclipse > Preferences... > Java > Build Path > User Libraries), and
    • Remove the old hsqldb-2.2.9.jar from your apache-openejb User Library and add the new hsqldb-2.2.8.jar.
    • In OpenEJB's data/hsqldb/, open hsqldb.script for edit, delete the line SET DATABASE SQL REGULAR NAMES TRUE (probably line 6), save and exit.
You now have the following environment available to Eclipse:

Web Server Business Server Persistence Database Server Logger
Jetty OpenEJB Hibernate HSQLDB Log4j
(As a user library) (As a user library) (As jars in project) (Within OpenEJB) (As jars in project)

Here's how to use it:

Next steps.
Visit Orientation, Debugging, Tips, and Troubleshooting for more info.





©2006, 2012 Geoff Callender, Sydney, Australia