1SLURPD(8C)                                                          SLURPD(8C)
2
3
4

NAME

6       slurpd - Standalone LDAP Update Replication Daemon
7

SYNOPSIS

9       /usr/lib64/slurpd   [-d   debug-level]   [-f   slapd-config-file]   [-r
10       slapd-replog-file] [-t temp-dir] [-o]
11

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

SEE ALSO

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

ACKNOWLEDGEMENTS

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)
Impressum