Installation

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

  1. Unzip the download.
    • Unzip the downloaded file, which will give you a directory called jumpstart-6.11.n or similar.
    • Move it to your development area, eg. /devel/jumpstart-6.11.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.5 ("Mars"), 4.4 ("Luna"), 4.3 ("Kepler"), or 4.2 ("Juno") is preferred. The Eclipse IDE for Java EE Developers package is good (JumpStart is developed with it).
    • 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.11.n/, click Finish.
    • The project can't build just yet so it will show errors.
  3. Ensure the project is using Java 7.
    • In Eclipse, right-click on the project and choose Properties then Java Compiler and ensure Compiler compliance level is 1.7. You may have to turn on Enable project specific settings.
  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 OpenLogic and download jetty-6.1.24.zip.
    • Once downloaded, unzip it. Move it to a suitable location (eg. /devel/jetty-6.1.24).
    • 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.24-lib, then
    • Click Add External Jars... and add the following jars from Jetty's lib/ directory to the new user library: 
      	jetty-6.1.24.jar 
	jetty-util-6.1.24.jar 
	plus/jetty-plus-6.1.24.jar 
	naming/jetty-naming-6.1.24.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