Building Catacomb on Cygwin

By Ivan Todoroski, Sat 11/22/2003 2:39 PM

Prerequisites:

Catacomb source code (latest from CVS with Cygwin patch applied)
Apache 2.x source code (the Unix source package, not Win32)
MySQL 4.x source code
MySQL 4.x binary distribution for Win32
Make sure you have a recent Cygwin with the basic development packages installed (libtool, automake, autoconf must be present - only devel versions and wrapper scripts, not stable versions)

MySQL

We download both source and binary distributions because MySQL cannot be built completely on Cygwin. Install the binary distribution as usual, we will use the source only to compile the MySQL client library on Cygwin.

Unpack MySQL source, and:

$ ./configure --disable-dependency-tracking --without-server
$ make
$ make install

After that, copy or symlink /usr/local/lib/mysql/libmysqlclient.a to /usr/lib, in order for ld to find it later.

Apache

Forget about loadable Apache modules on Cygwin, it doesn't work (atleast I wasn't able to do it). You will have to build Apache 2.x with Catacomb and the rest of the modules linked statically into one big httpd.exe.

I'm assuming you are going to install Apache in the default location /usr/local/apache2 (i.e. without specifying any --prefix arguments to Apache's configure), and that you checked out Catacomb in /usr/local/src/catacomb.

Open a bash window and let's go:

$ cp /usr/autotool/devel/share/aclocal/* /usr/share/aclocal
$ export AUTO_DEVEL=/usr/autotool/devel
$ export AUTO_STABLE=$AUTO_DEVEL
$ cd /usr/local/src
$ tar xzf /tmp/httpd-2.0.47.tar.gz
$ cd httpd-2.0.47
$ mkdir -p /usr/local/apache2/bin
$ touch /usr/local/apache2/bin/apxs
$ cp -r ../catacomb modules/dav/catacomb
$ cd modules/dav/catacomb
$ ./buildconf.sh
$ ./configure --with-mysql=/usr/local --with-apache=/usr/local/apache2 --with-static
$ cd -
$ ./buildconf
$ ./configure --enable-modules=most --enable-dav
$ make

Now, the Apache build will fail on the very last command which does the final link of httpd.exe. Scroll up past the errors, and locate the last command. It is huge, spanning about ten lines, and starts with "/bin/bash /usr/local/src/httpd-2.0.47/srclib/apr/libtool --silent --mode=link gcc ....". Paste this in notepad, edit it back into one long line, and append "-lmysqlclient" at the very end. Then paste it back in the bash window and run it. That should create the httpd.exe and conclude the Apache build.

After that:

$ make install

This will choke again and fail to copy all the executables in their target location (I'm guessing it is confused by the unexpected .exe extensions). To complete the install, do:

$ cp httpd.exe support/*.exe /usr/local/apache2/bin

You should now have a working Apache installation in /usr/local/apache2.

All that is left is to edit httpd.conf to enable Catacomb, instructions for that are in Catacomb's README, but with two caveats:

The directive DavDBMSHost directive MUST specify an IP address 127.0.0.1 instead of localhost. If localhost is specfied, the MySQL client lib will try to connect via shared memory which doesn't work under Cygwin. Specifying an IP address forces it to fall back to TCP/IP connections.
The directive DavDBMSTmpDir must contain a Win32 pathname with a drive letter but with forward slashes, instead of a Cygwin pathname, e.g. c:/cygwin/tmp instead of /tmp.

That should be it.