This is the Atlas of Living Australia Citizen Science project codebase.

1. Make sure you have a Java SDK, Maven, and PostgreSQL with PostGIS 1.5 all installed. Check out Dependencies below if you're not sure how.

2. Generate the database definitions:

   mvn -D skipTests hibernate3:hbm2ddl
   

   This can take a while as it downloads all the project dependencies for the first time. Don't worry, they'll be cached. We skip tests as there's no database set up yet.

3. If you haven't already, create a template PostGIS database:

   createdb template_postgis
   createlang plpgsql template_postgis
   psql -d template_postgis -f /usr/share/postgresql/8.4/contrib/postgis-1.5/postgis.sql
   psql -d template_postgis -f /usr/share/postgresql/8.4/contrib/postgis-1.5/spatial_ref_sys.sql
   

   Adjust the locations to PostGIS as necessary. On Mac, installed via homebrew, the PostGIS SQL scripts should be in /usr/local/share/postgis/.

4. Create the project database:

   If you haven't already, create a database user:

   createuser <user>
   

   Then create the database for this user based on the PostGIS template:

   createdb <database> -O <user> -T template_postgis
   

   And import the schema we just generated:

   psql -U <user> <database> 
   

5. Configure your database:

   Open pom.xml and edit the "Database properties" near the bottom in the dev profile, or copy and paste a new profile and use maven with -P <profile>:

   <!-- Database properties -->
   <bdrs.db.user.name>bdrs</bdrs.db.user.name>
   <bdrs.db.user.password>password</bdrs.db.user.password>
   <bdrs.db.url>jdbc:postgresql://localhost:5432/bdrs</bdrs.db.url>
   <bdrs.db.driver>org.postgresql.Driver</bdrs.db.driver>
   

6. Run it:

   mvn jetty:run
   

   This will automatically run package for you. If you just want to deploy at this stage, run mvn package instead.

   Make sure you use -P <profile> if you've added another profile. You might need to mvn -P <profile> clean package if you want to change profiles.

7. Check it out: open http://localhost:8080/BDRS and login with username admin and password password.

The BDRS is packaged up as a standard WAR in target/bdrs-core.war. Deploy this via your application server of choice!

Contributed dependency installation information:

• Java SDK: http://www.apple.com/downloads/macosx/development_tools/javaee5sdk.html
• Using Homebrew:
  • Maven: brew install maven
  • PostgreSQL: brew install postgresql
  • PostGIS: brew install postgis

Released under the Mozilla Public License 1.0 by Gaia Resources.