Code And Data Tips

If you're unfamiliar with Mercurial the following Quick Starts are recommended

• http://mercurial.selenic.com/quickstart/
• http://mercurial.selenic.com/guide/
• http://hginit.com/

If you're unfamiliar with Maven please read the following:

• http://www.javaworld.com/javaworld/jw-12-2005/jw-1205-maven.html
• http://maven.apache.org/guides/getting-started/index.html

Setting up a server deployment

The following has been tested on a Windows workstation.

Before starting please ensure you have a JDK installed. You can obtain this from here (ensure it's the JDK not the JRE):

• http://www.oracle.com/technetwork/java/javase/downloads/index.html

Eclipse can be downloaded from the following site ("Eclipse IDE for Java EE Developers" is recommended):

• http://www.eclipse.org/downloads/

Once both have been installed change the eclipse.ini file in the Eclipse installation directory to add the -vm argument with the location of the JDK bin/javaw.exe you just installed. See also:

• http://help.eclipse.org/help33/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/running_eclipse.htm

You'll also have to configure the installed JREs setting within Eclipse when that's loaded. These steps are required if

From within Eclipse install these two plugins:

MercurialEclipse plugin

• http://javaforge.com/project/HGE

M2eclipse Maven Eclipse plugin

• http://m2eclipse.sonatype.org/
• http://m2eclipse.sonatype.org/installing-m2eclipse.html

The following documentation may be useful:

• http://www.sonatype.com/books/m2eclipse-book/reference/

To checkout the project from the bitbucket repository click the menus File | New | Other… and on the dialogue box select "Clone Existing Mercurial Repository" from the Mercurial section. Fill out the various details as per the above section on server installation. Then you should be able to compile and test the project using the Maven workflow tools.