Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Biological Data Recording System (BDRS), also known as the ALA Citizen Science project
JavaScript Java Python Other
Tree: 7f4eb65e1c

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src
.gitignore
LICENSE
README.md
pom.xml
webdefault.xml

README.md

Biological Data Recording System

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

Getting Started

  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 -P dev -D skipTests clean package 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>
    

    Also open src/main/webapp/WEB-INF/climatewatch-hibernate-datasource.xml and place the same settings in the dataSource bean:

    <property name="driverClassName" value="org.postgresql.Driver"/>
    <property name="url" value="jdbc:postgresql://localhost:5432/bdrs-dev"/>
    <property name="username" value="develop"/>
    <property name="password" value="develop"/>
    
  6. Run it:

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

Deployment

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

Dependencies

Contributed dependency installation information:

Mac OS X:

License

Released under the Mozilla Public License 1.0 by Gaia Resources.

Something went wrong with that request. Please try again.