=====Installing Woodchip=====

==== For Developers ====

=== Disclaimer ===

These will be changing over the next couple of months.
These instructions are for Debian/[K]Ubuntu.

=== Installing... ===

  * Download OpenTaps (1.0.0-preview6) from https://sourceforge.net/project/showfiles.php?group_id=145855 and unzip
  * Install Java and Ant
<code>$ apt-get install sun-java5-jdk ant</code>
  * Woodchip is developed against Sun's JDK version 5.  To see if that's the version you are using <code>$ /usr/sbin/update-alternatives --display java</code>
    * If you are not using Sun's version and you would like to, make the change with <code>$ /usr/sbin/update-alternatives --config java</code>
    * OR set your local JAVA_HOME environment variable <code>$ export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun/</code>
  * Configure Postgres.  This creates a new user and schema called 'acq' -- assuming a database called 'evergreen'
<code>
$ psql evergreen # as the Postgres admin
evergreen=# CREATE USER acq WITH ENCRYPTED PASSWORD 'acqpass' ; CREATE SCHEMA AUTHORIZATION acq;
</code>
  * Configure opentaps.
    *  edit framework/entity/config/entityengine.xml
      * change the first <delegator> section from datasource-name="localderby" to 'localpostgres'
      * search down the file for the 'localpostgres' section and make the following changes <code>
schema-name="acq"
jdbc-uri="jdbc:postgresql://127.0.0.1/evergreen"
jdbc-username="acq"
jdbc-password="acqpass"</code>
  * Remove .txt and run {{woodchip-build.sh.txt}}
  * Edit applications/woodchip/config/woodchip.properties to suit your Evergreen environment
  * See how it all looks by browsing to http://localhost:8080/ -- try clicking on 'Parties & Users'.  The default login is admin/ofbiz.
  * Happy Acquiring and Serializing!