Building from within Eclipse

There are instructions for creating and deploying the web archive through Eclipse. This can also be done through the command line on the target server, Those instructions can be found here. If you want to build and deploy the archive remotely (on a client machine), these instructions will walk you through the teps. These assume you already have a working Sun App Server setup and the and working Eclipse environment with the source code setup. There is a ANT build file located in etc/buildWAR-eclipse.xml which will generate the WAR for you from Eclipse and place it in the base directory of your project. You can then copy this to the server and deploy or use another mechanism such as Sun App Server web administration interface.

  1. Configure your etc/org.sharedrecords.properties file to point to your (existing) target location for a FileStoreRoot on your server. The property name is org.sharedrecords.core.FileStoreRoot?. (Example: /var/SRCDataStore/)
  2. Right click on buildWAR-eclipse.xml and run the ANT task build-in-place. This is the default task of this ANT file. NOTE: The ANT script will temporarily move your SVN folder to create the WAR without including all of the SVN markup files. If for some reason the ANT process fails to complete, your SVN files will not be copied into your workspace properly. In order to copy for the files back in, run the ANT task restore-svn. This task is normally run by the the build-in-place task after the WAR has been created.
  3. If you choose to use Deploytool to deploy the WAR to Sun App Server, Open Deploytool from your Sun app server bin directory:
    1. Go to File->Open and locate the SRCDataStore.war file created which will be created in the top level directory of your source tree in your workspace.
    2. Go to Tools->Deploy and target your Sun App Server.
  4. If you choose to use the web interface, navigate to the Sun App server on port 4848 (e.g.  http://localhost:4848). Go to Applications -> Web Applications. Select Deploy, and find the WAR you created.
  5. Run the org.sharedrecords.tests.RemoteStorageProviderTest? to verify that your server was correctly deployed.