1SLURPD(8C) SLURPD(8C)
2
3
4
6 slurpd - Standalone LDAP Update Replication Daemon
7
9 /usr/lib64/slurpd [-d debug-level] [-f slapd-config-file] [-r
10 slapd-replog-file] [-t temp-dir] [-o]
11
13 Slurpd is used to propagate changes from one slapd database to another.
14 If slapd is configured to produce a replication log, slurpd reads that
15 replication log and sends the changes to the slave slapd instances via
16 the LDAP protocol. slurpd is typically invoked at boot time, usually
17 out of /etc/rc.local.
18
19 Upon startup, slurpd normally forks and disassociates itself from the
20 invoking tty, then reads the replication log (given either by the
21 replogfile directive in the slapd config file, or by the -r command-
22 line option). If the replication log file does not exist or is empty,
23 slurpd goes to sleep. It periodically wakes up and checks to see if
24 there are any changes to be propagated.
25
26 When slurpd notices that there are changes to propagate to slave slapd
27 instances, it locks the replication log, makes its own private copy,
28 releases the lock, and forks one copy of itself for each replica slapd
29 to be updated. Each child process binds to the slave slapd as the DN
30 given by the binddn option to the replica directive in the slapd config
31 file, and sends the changes.
32
33 See slapd(8) for details on the standalone LDAP daemon.
34
35 Note that slurpd reads replication directive from slapd.conf(5), but
36 uses ldap.conf(5) to obtain other configuration settings (such as TLS
37 settings).
38
40 -d debug-level
41 Turn on debugging as defined by debug-level. If this option is
42 specified, even with a zero argument, slurpd will not fork or
43 disassociate from the invoking terminal. Some general operation
44 and status messages are printed for any value of debug-level.
45 debug-level is taken as a bit string, with each bit correspond‐
46 ing to a different kind of debugging information. See <ldap.h>
47 for details.
48
49 -f slapd-config-file
50 Specifies the slapd configuration file. The default is
51 /etc/openldap/slapd.conf.
52
53 -r slapd-replog-file
54 Specifies the name of the slapd replication logfile. Normally,
55 the name of the replication log file is read from the slapd con‐
56 figuration file. The file should be located in a directory with
57 limited read/write/execute access. The -r option allows you to
58 override this. In conjunction with the -o option, you can
59 process a replication log file in a "one-shot" mode. For exam‐
60 ple, if slurpd has encountered errors in processing a replica‐
61 tion log, you can run it in one-shot mode and give the rejection
62 file name as the argument to the -r option, once you've resolved
63 the problem which caused the replication to fail.
64
65 -o Run in "one-shot" mode. Normally, slurpd processes the replog
66 file and then watches for more replication entries to be
67 appended. In one-shot mode, slurpd processes a replication log
68 and exits.
69
70 -t temp-dir
71 slurpd copies the replication log to a working directory before
72 processing it. The directory permissions should limit
73 read/write/execute access as temporary files may contain sensi‐
74 tive information. This option allows you to specify the loca‐
75 tion of these temporary files. The default is /var/openldap-
76 slurp.
77
79 To start slurpd and have it fork and detach from the terminal and
80 process the replication logs generated by slapd, just type:
81
82 /usr/lib64/slurpd
83
84 To start slurpd with an alternate slapd configuration file, and turn on
85 voluminous debugging which will be printed on standard error, type:
86
87 /usr/lib64/slurpd -f /etc/openldap/slapd.conf -d 255
88
90 ldap(3), ldap.conf(5), slapd.conf(5), slapd.replog(5), slapd(8)
91
92 "OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin/)
93
95 OpenLDAP is developed and maintained by The OpenLDAP Project
96 (http://www.openldap.org/). OpenLDAP is derived from University of
97 Michigan LDAP 3.3 Release.
98
99
100
101OpenLDAP 2.3.34 2007/2/16 SLURPD(8C)