1Installing Bluebird
1.1 Binary Installation

There is currently no "installation" procedure. You can run the current code "in-place" by setting the BB_HOME environment variable to point to the BlueBird-X.X directory you get when uncompressing the archive.

1.2 Building From The Source
1.2.1 Building on Win32

All you should have to do is run the 'build.bat' file from the main bluebird directory and it should configure a classpath and start the Ant build installation process for you.

1.2.2 Building on UNIX or Compatible Systems

Just run the 'build.sh' script with any bourne-compatible shell, and it should start the build process for you.

Building on a Linux system includes compilation of some binary modules for the PostgreSQL database (the modules' source is located in the sql/native/PostgreSQL/ directory of the CVS tree). For these to build correctly, the following steps are required:

  • Install PostgreSQL version 7.0.x. Taking all defaults in the installation process for PostgreSQL works for us. PostgreSQL is available from http://www.postgresql.org

  • Edit the arch/Linux.properties file to reflect the correct 'lib' and 'include' directories for your particular PostgreSQL installation. By default, these directories are:

    • /usr/local/pgsql/lib

    • /usr/local/pgsql/include

    If you opted for a non-default installation, the Linux.properties file must reflect these changes.

1.2.3 Building on Other Systems

If your system configuration doesn't match any of the others, or the build scripts will not run for you, you will need to follow these (manual) steps.

  • Set the CLASSPATH environment variable so that it includes the following files:

    • ant.jar
    • JCup-ONMS.jar
    • JLex.jar
    • xerces.jar
    • bsf.jar
    • bsfengines.jar

    Please note that you may already have some of these in your classpath. JCup-ONMS.jar is a hacked version of the standard JCup distribution, so please make sure that our version from the contrib directory is in your path before any others.

    NOTE: We have contributed our changes back to the JCup author and anxiously await their inclusion in the mainstream production release.

  • Run the following command:

    'java -mx32m -Dpwd=<PWD> -Dant.home=<ANT_HOME> org.apache.tools.ant.Main <command>'

    Where PWD is the full path to the current directory you are in, and ANT_HOME is the location of your Ant distribution. If you do not have Ant installed on your system, you can use the ant directory in the contrib section of the repository.

1.3 Prerequisites

The following Prerequisites are required for the proper execution of the BlueBird software.

Please note that PostgreSQL versions before 7.0 are not supported. They may or may not work, however.

Also note that original development was completed using Sun's JDK 1.2.2, but due to significant problems with Swing behavior on Linux, we have transitioned to IBM's 1.3 release for all development. It too has its problems, but it's usable.