Installation

These steps will quickly get JumpStart open, running, and editable. They apply to version 2.0.0 of JumpStart.

  1. Unzip. Unzip the downloaded file, which will give you a directory called jumpstart-min-2.0.0 or similar.
  2. Get JBoss Application Server.
    1. Go to JBoss Application Server Downloads, locate 4.2.2 GA and choose the Download link. Choose to download the jboss-4.2.2.GA.zip.
    2. Once downloaded, unzip it. Move it to a suitable location (eg. /devel/jboss-4.2.2.GA).
  3. Move JumpStart to your development projects location. Move jumpstart-min-2.0.0/ or jumpstart-max-2.0.0/ (or similar name) to your development area, eg. /devel/jumpstart-min-2.0.0/ .
  4. Open it in Eclipse. Open Eclipse and create a new Java Project over the jumpstart-min-2.0.0/ or jumpstart-max-2.0.0/ directory. The project can't build just yet so it will show errors.
  5. Edit the build.xml file. Open it in eclipse and replace this:
      tacos-core/4.1.1-SNAPSHOT/tacos-core-4.1.1-20070907.210105-1.jar
    with this:
      tacos-core/4.1.1/tacos-core-4.1.1.jar
    Save it.
  6. Run the get-dependent-files target in the project's build.xml file. You can do these steps in Eclipse...
    • If you haven't used Ant in Eclipse before, start by opening the Ant view and dragging build.xml onto it.
    • Open the build.properties file and modify the jboss.dir property.
    • 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>
    • Run the get-dependent-files target in the project's build.xml file.
    The result of this will be that fresh jars will be put in 4 directories:
    • web/src/main/webapp/jumpstart/min/web/lib/
    • enterprise/src/main/lib/
    • business/src/main/lib-compile/
    • business/src/test/lib-test/
  7. Refresh the project by right-clicking on the project in Eclipse and choosing Refresh. This should build the project successfully and show no errors. It will also run exploder.xml, which will build the exploded/ directory. You can see how has this been configured by displaying the project's properties ans choosing Builders.
  8. Point JBoss at the project. Locate the server's conf/jboss-service.xml file eg. jboss-4.2.2.GA/server/default/conf/jboss-service.xml. Edit it, replacing this:
      <attribute name="URLs">
       deploy/
      </attribute>
    with something like this:
      <attribute name="URLs">
       deploy/, /devel/jumpstart-min-2.0.0/exploded/
      </attribute>
    Be sure to include a slash after the word exploded, ie. exploded/ ; otherwise reload the entire app without restarting will not work! If you have both Min and Max, it's OK to have both deployed. They can run at the same time because they have different URLs and use different database tables.
  9. Start JBoss Start the JBoss server from the command line by going to JBoss's bin/ directory and using the run.bat or run.sh command.
  10. Check JumpStart is running by pointing your web browser at http://localhost:8080/jumpstart-min or http://localhost:8080/jumpstart-max, but don't expect to be able to log in yet.
  11. Drop existing tables. If you have a previous version of JumpStart already on the computer, then do this step. Otherwise, you can skip to the next step.
    • Open the Hypersonic Database Manager. To do this, point your web browser at http://localhost:8080/jmx-console/, click on database=localDB,service=Hypersonic, find the section labelled void startDatabaseManager() and click on Invoke. In a few moments a Java GUI called HSQL Database Manager will start up.
    • In Eclipse, locate business/src/main/examples/setup/drop_tables.sql in the project. Open it, then copy and paste its contents into the HSQL Database Manager and click on Execute SQL.
    • Stop JBoss Go to the window that is running JBoss and press Ctrl-C. Wait until JBoss has stopped.
    • Start JBoss Start the JBoss server from the command line by going to JBoss's bin/ directory and using the run.bat or run.sh command. This creates all the database tables automatically.
  12. Load initial data:
    • Open the Hypersonic Database Manager. To do this, point your web browser at http://localhost:8080/jmx-console/, click on database=localDB,service=Hypersonic, find the section labelled void startDatabaseManager() and click on Invoke. In a few moments a Java GUI called HSQL Database Manager will start up.
    • In Eclipse, locate business/src/main/examples/setup/initial_data.sql in the project. Open it, then copy and paste its contents into the HSQL Database Manager and click on Execute SQL.
  13. Confirm JumpStart is working by returning to http://localhost:8080/jumpstart-min or http://localhost:8080/jumpstart-max and logging in with secofr for the Login ID and secofr for the Password.
  14. Finished! There are 2 other users: admin and john, with passwords admin and john, respectively. In Max, these users are authorised to less functions than secofr.
  15. Try making a mod! As another quick test...
    • In Eclipse, locate the html template of the login page - web/src/main/webapp/WEB-INF/pages/login/LoginPage.html - and modify it a little.
      Remember - you can immediately preview the mod by opening the html file with a web browser, or in Eclipse try Open With > Web Browser if that option is available. This is one of Tapestry's many strengths.
    • Make JBoss notice the change by running the Ant target called touch-exploded-ear in JumpStart's build.xml file. JBoss will automatically reload the app.
    • In future you can avoid the need to reload - see Auto-reload web programs on the Tips page.
  16. Explore! Visit the Orientation, Tips, Troubleshooting and Bugs & Enhancements pages for more info.






©2006, 2007 Geoff Callender, Sydney, Australia