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

• Download OpenTaps (1.0.0-preview6) from https://sourceforge.net/project/showfiles.php?group_id=145855 and unzip
• Install Java and Ant

$ apt-get install sun-java5-jdk ant

• Woodchip is developed against Sun's JDK version 5. To see if that's the version you are using

  $ /usr/sbin/update-alternatives --display java

  • If you are not using Sun's version and you would like to, make the change with

    $ /usr/sbin/update-alternatives --config java

  • OR set your local JAVA_HOME environment variable

    $ export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun/

• Configure Postgres. This creates a new user and schema called 'acq' – assuming a database called 'evergreen'

$ psql evergreen # as the Postgres admin
evergreen=# CREATE USER acq WITH ENCRYPTED PASSWORD 'acqpass' ; CREATE SCHEMA AUTHORIZATION acq;

• 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

      schema-name="acq"
      jdbc-uri="jdbc:postgresql://127.0.0.1/evergreen"
      jdbc-username="acq"
      jdbc-password="acqpass"

• 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!