2.2. Build and install the mysql driver

First you have to unpack the libdbi-drivers archive in a suitable directory. Unpacking will create a new subdirectory libdbi-drivers-X.Y where "X.Y" denotes the version:

$ tar -xzf libdbi-drivers-X.Y.tar.gz

The libdbi-drivers project consists of several drivers that use a common build system. Therefore you must tell configure explicitly that you want to build the mysql driver (you can list as many drivers as you want to build):

$ cd libdbi-drivers
$ ./configure --with-mysql

Run ./configure --help to find out about additional options.

Then build the driver with the command:

$ make

Note: Please note that you may have to invoke gmake, the GNU version of make, on some systems.

Then install the driver with the command (you'll need root permissions to do this):

$ make install

To test the operation of the newly installed driver, use the command:

$ make check

This command creates and runs a test program that performs a few basic input and output tests. The program will ask for an administrator username and password. This user can be any user who has database creation priveleges. Be sure to provide the name of a database which does not already exist (avoid 'test' which is used on many systems).

Note: If for some reason you need to re-create the autoconf/automake-related files, try running ./autogen.sh. I've found out that the current stable autoconf/automake/libtool versions (as found in FreeBSD 4.7 and Debian 3.0) do not cooperate well, so I found it necessary to run the older autoconf 2.13. If necessary, edit autogen.sh so that it will catch the older autoconf version on your system.