Building From Source
Building the Bruce replication system from the source code is relatively simple. However, there are a few prerequisites you'll need to take care of before you start.
- Ant, version 1.7 or better.
- Java 1.5 JDK
- Make & GCC
- Postgres 8.1 or 8.2.
You'll probably do fine with a 1.6.x version, but we've developed the system using 1.7, so it's up to you. Get it from http://ant.apache.org
We use annotations and other 1.5 features. There's no getting around this one. Download from http://java.sun.com/j2se/1.5.0/. If you use Java 6, please let us know how it goes by sending a message to the email@example.com.
Make & GCC
Bruce uses a C-based PostgreSQL extension. You'll need to compile and install this. In our development environments we use GCC version 4.0.1 and GNU Make version 3.8.
This one is important. When the unit and acceptance tests run as a part of the build, the bruce extension is compiled and installed. You will need to have read/write access to the PostgreSQL lib directory. We have found that, for development purposes, it's best to have a personal installation of PostgreSQL in your home directory. The postgres.properties file in the root directory of the source tree contains paths and other configurable properties so that you can customize your build to use a custom PostgreSQL install location. Just remember - wherever it's installed, you'll need to have read and write access to the lib directory!