VEGBANK: Vegatation Plots Database and Archival System

to https://github.com/NCEAS/vegbank2

Project Status: Moved to https://github.com/NCEAS/vegbank2 – The project has been moved to https://github.com/NCEAS/vegbank2, and the version at that location should be considered authoritative.

The remainder of this README is for historical reference from the first phase of Vegbank development.

• Version: 1.2.1

• Send feedback and bugs to: vegbank-dev@ecoinformatics.org http://bugzilla.ecoinformatics.org

• Contributors:

  • Robert K. Peet
  • Michael D. Jennings
  • Dennis Grossman
  • Marilyn D. Walker
  • Mark Anderson (anderson@nceas.ucsb.edu)
  • Gabriel Farrell (farrell@nceas.ucsb.edu)
  • John Harris (harris@nceas.ucsb.edu)
  • Micheal Lee (mikelee@email.unc.edu)
  • Chad Berkley (berkley@nceas.ucsb.edu)
  • Matthew B. Jones (jones@nceas.ucsb.edu)

VegBank is the vegetation plot database of the Ecological Society of America's Panel on Vegetation Classification. VegBank consists of three modules that contain (1) the actual plot records, (2) vegetation types recognized in the U.S. National Vegetation Classification and other vegetation types submitted by users, and (3) all plant taxa recognized by ITIS/USDA as well as all other plant taxa recorded in plot records. Vegetation records, community types and plant taxa may be submitted to VegBank and may be subsequently searched, viewed, annotated, revised, interpreted, downloaded, and cited.

Installation

See INSTALL file in this directory.

PROPERTIES FILES:

./build.properties - edit for your environment

DATABASE SETUP:

For more information, see the INSTALL file and Deployment.md

Vegbank has a single database for Plots, Plant Taxonomy and Plant Community. It also includes information about users of the VegBank system and their personal datasets.

Initializing PostgresSQL:

Install PostgresSQL on the system ...

# Associate a file with the database ( e.g /home/username/pgdata )
initdb [databasefile]

# Start database ( with debuging output )
postmaster -d2 -i -D databasefile 

# Create the database users as follows:
In an account that has rights to the database ( e.g. postgres )
> createuser  datauser
> createuser [ your unix username ]
> createuser qa

# Build the databases
Some of the sql is auto generated using an ant task.
In the vegclass directory run:
> ant createdb

# Edit the pg_hba.conf file so that connections may be made to the database 
# add the following:
local      all                                               trust
host       all  127.0.0.1                 255.255.255.255    trust
#host       all  ip of RMI server etc.    255.255.255.255    trust

Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)

If you discover a bug please report it, either by email (above) or by using our bug tracking system (http://bugzilla.ecoinformatics.org). There is a list of currently unimplemented features in Bugzilla that we are working on for the next release.

Legalese

This software is copyrighted by The Regents of the University of California and the National Center for Ecological Analysis and Synthesis and licensed under the GNU GPL; see the 'LICENSE' file for details.

This material is based upon work supported by the National Science Foundation, Grant Nos. DBI-9905838 and DBI-0213794. Any opinions, findings and conclusions or recomendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the National Science Foundation (NSF).

This product includes software developed by the Apache Software Foundation (http://www.apache.org/). See lib/apache-licence.txt for details.

The Struts workflow extension is also included see lib/workflow-extension-licence.txt for details.