SLURPD(8C) SLURPD(8C)
NAME
slurpd - Standalone LDAP Update Replication Daemon
SYNOPSIS
/usr/libexec/slurpd [-d debug-level] [-f slapd-config-file] [-r slapd-replog-file] [-t temp-dir] [-o]
DESCRIPTION
Slurpd is used to propagate changes from one slapd database to another. If slapd is configured to
produce a replication log, slurpd reads that replication log and sends the changes to the slave slapd
instances via the LDAP protocol. slurpd is typically invoked at boot time, usually out of
/etc/rc.local.
Upon startup, slurpd normally forks and disassociates itself from the invoking tty, then reads the
replication log (given either by the replogfile directive in the slapd config file, or by the -r com-mand-line command-line
mand-line option). If the replication log file does not exist or is empty, slurpd goes to sleep. It
periodically wakes up and checks to see if there are any changes to be propagated.
When slurpd notices that there are changes to propagate to slave slapd instances, it locks the repli-cation replication
cation log, makes its own private copy, releases the lock, and forks one copy of itself for each
replica slapd to be updated. Each child process binds to the slave slapd as the DN given by the
binddn option to the replica directive in the slapd config file, and sends the changes.
See slapd(8) for details on the standalone LDAP daemon.
Note that slurpd reads replication directive from slapd.conf(5), but uses ldap.conf(5) to obtain
other configuration settings (such as TLS settings).
OPTIONS
-d debug-level
Turn on debugging as defined by debug-level. If this option is specified, even with a zero
argument, slurpd will not fork or disassociate from the invoking terminal. Some general oper-ation operation
ation and status messages are printed for any value of debug-level. debug-level is taken as a
bit string, with each bit corresponding to a different kind of debugging information. See
<ldap.h> for details.
-f slapd-config-file
Specifies the slapd configuration file. The default is /etc/openldap/slapd.conf.
-r slapd-replog-file
Specifies the name of the slapd replication logfile. Normally, the name of the replication
log file is read from the slapd configuration file. The file should be located in a directory
with limited read/write/execute access. The -r option allows you to override this. In con-junction conjunction
junction with the -o option, you can process a replication log file in a "one-shot" mode. For
example, if slurpd has encountered errors in processing a replication log, you can run it in
one-shot mode and give the rejection file name as the argument to the -r option, once you've
resolved the problem which caused the replication to fail.
-o Run in "one-shot" mode. Normally, slurpd processes the replog file and then watches for more
replication entries to be appended. In one-shot mode, slurpd processes a replication log and
exits.
-t temp-dir
slurpd copies the replication log to a working directory before processing it. The directory
permissions should limit read/write/execute access as temporary files may contain sensitive
information. This option allows you to specify the location of these temporary files. The
default is /var/db/openldap/openldap-slurp.
EXAMPLES
To start slurpd and have it fork and detach from the terminal and process the replication logs gener-ated generated
ated by slapd, just type:
/usr/libexec/slurpd
To start slurpd with an alternate slapd configuration file, and turn on voluminous debugging which
will be printed on standard error, type:
/usr/libexec/slurpd -f /etc/openldap/slapd.conf -d 255
SEE ALSO
ldap(3), ldap.conf(5), slapd.conf(5), slapd.replog(5), slapd(8)
"OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
ACKNOWLEDGEMENTS
OpenLDAP is developed and maintained by The OpenLDAP Project (http://www.openldap.org/) OpenLDAP is
derived from University of Michigan LDAP 3.3 Release.
OpenLDAP 2.3.27 2006/08/19 SLURPD(8C)
|