Installation

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

  1. Unzip. Unzip the downloaded file, which will give you a directory called jumpstart-5.8.n or similar.
    • Move it to your development area, eg. /devel/jumpstart-5.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 3.6 (Helios). Open Eclipse, choose File > Import..., then choose General > Existing Projects into Workspace, click Next >, set the root directory to your jumpstart directory eg. /devel/jumpstart-5.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. 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.
      If it cannot get the kaptcha jar from nexus.sourcesense.com then modify web/build.xml to get http://savant.inversoft.org/com/google/code/kaptcha/kaptcha/2.3/kaptcha-2.3.jar instead, then run the target again.
    The result is that the following directories become populated with fresh 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-local-openejb/
	web/src/main/lib-compile/
	web/src/main/lib-provided/
	web/src/main/lib-runtime/
	web/src/test/lib-test/
  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 will also run collapser.xml, which will build 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.
  6. Set 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 WebServer. This 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 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. This will be your embedded EJB container during development.
    • Go to Apache Download Mirrors and download openejb-3.1.4.zip .
    • Once downloaded, unzip it. Move it to a suitable location (eg. /devel/openejb-3.1.4).
    • 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 openejb-3.1.4-lib, then
    • Click Add Jars... and add every JAR in OpenEJB's lib/ directory to the new user library.
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, 2007 Geoff Callender, Sydney, Australia