Running this test:
------------------

Prerequisites (IMPORTANT):
openLDAP 2.3 with hdb-backend
Bundle::Net::LDAP perl modules

Short Story:

1. Make a new directory somewhere conveniant
2. Unpack tarball (or reunpack if you found this file in the tarball
and want to run the test from somewhere else)
3. Run setup.sh
4. Start test with bin/cached-dryrun start [simple|nodelete]

Setting it up:

Unless otherwise noted everything is assumed to be run from THE
DIRECTORY THIS TARBALL WAS UNPACKED IN.

Run ./setup.sh

Running:

start the test with:
bin/cached-dryrun start [simple|nodelete] [logfile=/some/file]

The test without the extra arguments build, move, and delete trees. If
the argument nodelete is added no deletion takes place. If the argument
simple is used only adding is done.

Note that starting up this way starts an underlying slapd process with
the right configuration file. This should not be done manually.

If no logfile is supplied var/log/cached.log is used.

Stopping:

bin/cached-dryrun stop

About prerequisites:

The necessary perl modules can be installed with:

perl -MCPAN -e shell

This will give you an interactive shell in which you can give commands
for managing installed modules. The actual command for doing installing
these modules is:

install Bundle::Net::LDAP

The version is given by:

slapd -V

If and how the hdb backend was compiled into slapd really has to be
deduced from the documentation of its source. If the module is loaded
dynamically the file is in all normal cases called back_hdb.la and
otherwise no filename is required.