Installation

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

  1. Unzip. Unzip the downloaded file, which will give you a directory called jumpstart-6.2.n or similar.
    • Move it to your development area, eg. /devel/jumpstart-6.2.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 3.7 ("Indigo") or 3.6 ("Helios") are preferred. 4.2 ("Juno") is OK, but it displays many warnings (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.2.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.
    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-hibernate/
	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-standalone-4.0.0.zip .
    • Once downloaded, unzip it. Move it to a suitable location (eg. /devel/apache-openejb-4.0.0).
    • 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.0.0-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, 2012 Geoff Callender, Sydney, Australia