LucidDbBuildFromSourceDistribution

From Eigenpedia

Jump to: navigation, search

Building LucidDB from a source distribution is almost identical to building LucidDB from a Perforce sandbox.

First, obtain and unpack a source distribution of the Eigenbase platform; this includes the source code for LucidDB and all of its dependencies, including third-party libraries and build tools. You can get the latest release from the sourceforge.net download page for Eigenbase.

The archive will be named something like eigenbase-src-0.6.0.tar.bz2. Unpack it with this command:

tar xjf eigenbase-src-0.6.0.tar.bz2

When the tar command completes, you will have a directory like eigenbase-src-0.6.0. Underneath will be a luciddb subdirectory, plus a number of sibling subdirectories for the other Eigenbase and third-party components needed to build LucidDB.

Now, follow the instructions in LucidDbBuildFromPerforce, using eigenbase-src-0.6.0 where the instructions refer to dev.

If you're feeling either lucky or impatient, these are the fast-track steps for a full build on Linux:

  1. Make sure you have JDK 1.5 installed, with JAVA_HOME environment variable set
  2. Make sure you have either g++ 3.3.x or 4.1.x installed (3.4 through 4.0 don't work well)
  3. Make sure you have recent versions of autoconf, automake and libtool installed (if you don't, easiest is to follow the instructions for installing from the supplied thirdparty archives, since those are known to work)
  4. If you are building on a machine which supports both 32-bit and 64-bit builds, follow the instructions from Fennel64Bit#Build Machine Setup Notes.
  5. cd dev/farrago
  6. echo 'release.gpl=true' > customBuild.properties
  7. <tt>cd ../luciddb
  8. ./initBuild.sh --with-optimization --without-debug

This may actually work for you, but if you encounter errors, you'll need to go step-by-step through the full instructions. And even if it works, you should still read through those instructions to familiarize yourself with what's going on. In particular, you must follow the steps for setting up the correct environment variables for running executables after the build completes.

For builds intended for production use, be sure to specify --with-optimization --without-debug to initBuild.sh.

Building on Windows is currently a black art since it requires begging and pleading with the Cygwin installer to get the right mingw and autotools versions. You're probably better off with a binary release.