Berkeley DB XML Reference Guide: Building Berkeley DB XML Libraries for UNIX/POSIX

Berkeley DB XML Reference Guide:
Building Berkeley DB XML for UNIX/POSIX systems

Building Berkeley DB XML Libraries for UNIX/POSIX

The buildall.sh script is a wrapper around separate build procedures for each third-party library. If there are problems using the script, or if it is necessary to build libraries individually, it is possible to build manually. Building manually gives you finer control over configuration, build and installation. If you are able to build successfully using buildall.sh, the information on this page is not necessary.

Building Individual Libraries

These instructions assume that the third-party libraries are in the directory, dbxml-2.2.13. They apply regardless of actual location.

Berkeley DB

Berkeley DB XML requires Berkeley DB 4.3.28 or newer. Adjust the path below to match the version bundled with the distribution.

When you build Berkeley DB, you must specify the --enable-cxx configuration option, so the minimal build commands for Berkeley DB are:

cd dbxml-2.2.13/db-4.3.28/build_unix
../dist/configure --enable-cxx
make
make install

This will install Berkeley DB in /usr/local/BerkeleyDB.4.3. If you want to install in a different directory, add --prefix=/path/to/install to the configure line.

If you want to use the Berkeley DB XML Java API, you must also build Berkeley DB with Java support by adding --enable-java to the configure line.

Xerces

Xerces is the Apache implementation of XML parsing technology and DOM. The build requires a source release of Xerces, not just a binary release. This release of Berkeley DB XML requires the Xerces 2.7.0 release or newer. Building Xerces requires GNU make.

Example Bourne shell build commands for Xerces are:

cd dbxml-2.2.13/xerces-c-src2_6_0
export XERCESCROOT=`pwd`
cd src/xercesc
./runConfigure -plinux -d -cgcc -xg++ -minmem -nsocket -tnative -rnone
make
make install

You may have to adjust your system type and compiler information, of course.

This will install Xerces under /usr/local. If you want to install in a different directory, add -P/path/to/install to the configure line.

Pathan

Pathan is an XPath 2.0 implementation using Xerces DOM. Berkeley DB XML requires a version of Pathan that is not publicly available and is distributed with Berkeley DB XML. Building Pathan requires GNU make.

An example Bourne shell build command for Pathan is:

cd dbxml-2.2.13/pathan
./configure --with-xerces=../xerces-c-src
make
make install

This will install Pathan under /usr/local. If you want to install in a different directory, add --prefix=/path/to/install to the configure line. The --with-xerces directive is required, and must point to a compiled Xerces source tree (vs. an install tree).

XQuery

XQuery is an XQuery 1.0 processor implemented with Pathan and Xerces DOM. Berkeley DB XML requires a version of XQuery that is not publicly available and is distributed with Berkeley DB XML. Building XQuery requires GNU make.

An example Bourne shell build command for XQuery are:

cd dbxml-2.2.13/xquery-1.2.0/build_unix
../dist/configure
make
make install

This will install XQuery under /usr/local/BerkeleyDB.XQuery.1.2. If you want to install in a different directory, add --prefix=/path/to/install to the configure line.

The --with-pathan and --with-xerces configuration options can be used to specify the location of the install trees if they are not in their default locations.

Configuring and building Berkeley DB XML

The --with-berkeleydb, --with-pathan, --with-xerces, and --with-xquery configuration options can be used to specify the location of the install trees. Alternatively, the CFLAGS, LDFLAGS and other standard environment variables can be used to specify the location of the already installed include and library files.

To do a standard UNIX build of Berkeley DB XML using default paths and installations of the third-party libraries, change to the build_unix directory and then enter the following two commands, adjusting the paths as necessary:

cd dbxml-2.2.13/dbxml/build_unix
../dist/configure
make

If you have changed the locations where Berkeley DB, Pathan, Xerces, or XQuery are installed from the defaults, add the arguments --with-berkeleydb=/path/to/db, --with-xquery=/path/to/xquery, --with-pathan=/path/to/pathan and/or --with-xerces=/path/to/xerces to configure.

By default, Berkeley DB XML is installed in /usr/local/BerkeleyDBXML.2.2. To change that, add --prefix=/path/to/install to configure. To install the Berkeley DB XML library, enter the following command:

make install

To rebuild Berkeley DB XML, enter:

make clean
make

If you change your mind about how Berkeley DB XML is to be configured, you must start from scratch by entering the following command:

make distclean
../dist/configure
make

To build multiple UNIX versions of Berkeley DB XML in the same source tree, create a new directory at the same level as the build_unix directory, and then configure and build in that directory as described previously.

Building the Java API

To build the DB XML Java API, make sure there is a working javac in your PATH, and specify --enable-java when running both the Berkeley DB and Berkeley DB XML configure scripts. When you run make, the Java support library for Berkeley DB XML will be built, creating the file dbxml.jar in your build directory.

To make use of the DB XML Java API set your environment variable CLASSPATH to include the full pathname of the dbxml.jar file, as well as the db.jar file from Berkeley DB, and your environment variable LD_LIBRARY_PATH (or equivalent) to include the .libs subdirectory of your build directory.

Reporting problems

If you have trouble with any of these commands, please send email to support@sleepycat.com In that email, please include the following information:

The version of Berkeley DB XML you are trying to build.
The name and version of the C++ compiler you are using. If you are running g++, the output from running g++ --version.
The name and version of the operating system you are using, including the output from running uname -a.
A screen snapshot of the commands you entered to do configuration and compilation, and any output they produced.
A copy of the all config and build output generated by buildall.sh and individual build commands.
A copy of the config.log (found in the build_unix directory) file created during Berkeley DB XML configuration.
Information regarding building third-party libraries from non-default locations.