What does the "unable to join enviornment" error mean?

This error is caused if you build Berkley DB 4 with threading support, but do not then link the pthreads library to Cyrus. This is commonly caused by a Linux distribution which supplies the pre-threaded library version.

One workaround is to rebuild the db4 library without thread support. Another is provided by Scott Adkins (adkinss@ohio.edu):

I talked to SleepyCat about it and they suggested making sure that the threads library was being linked into the IMAP server. It used to be that when compiling db3 that the IMAP server would automatically link in the threads library, probably because of an rpath listed in the db3 shared library. They must have changed something with db4, since the threads library is no longer linked into applications if they link against the db4 library.

As it turns out, linking with threads (I believe I simply included the -pthread CC command line option to have that happen) caused the join errors to go away. I was still having some flakiness with db4 though...

Starting with Cyrus 2.2.1, it is possible to build without linking Berkeley DB at all, which may be a viable option for some sites.

-- RobSiemborski? - 27 Aug 2003