git.sur5r.net Git - openldap/blob - doc/man/man8/slurpd.8

   1 .TH SLURPD 8C "22 September 1998" "OpenLDAP LDVERSION"
   2 .\" $OpenLDAP$
   3 .\" Copyright 1998-1999 The OpenLDAP Foundation All Rights Reserved.
   4 .\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
   5 .SH NAME
   6 slurpd \- Standalone LDAP Update Replication Daemon
   7 .SH SYNOPSIS
   8 .B LIBEXECDIR/slurpd [\-d debug\-level]
   9 .B [\-f slapd\-config\-file] [\-r slapd\-replog\-file]
  10 .B [\-t temp\-dir] [\-o] [\-k srvtab\-file]
  11 .B
  12 .SH DESCRIPTION
  13 .LP
  14 .B Slurpd
  15 is used to propagate changes from one slapd database to another.  If
  16 slapd is configured to produce a replication log,
  17 .B slurpd
  18 reads that
  19 replication log and sends the changes to the slave
  20 .B slapd
  21 instances
  22 via the LDAP protocol.
  23 .B slurpd
  24 is typically invoked at boot time, usually out of
  25 .BR  /etc/rc.local .
  26 .LP
  27 Upon startup,
  28 .B slurpd
  29 normally forks and disassociates itself from the invoking tty,
  30 then reads the replication log (given either by the
  31 .I replogfile
  32 directive in the
  33 .B slapd
  34 config file, or by the
  35 .RB \- r
  36 command-line option).
  37 If the replication log file does not exist or is empty,
  38 .B slurpd
  39 goes to sleep.  It periodically wakes up and checks to see if there
  40 are any changes to be propoagated.
  41 .LP
  42 When
  43 .B slurpd
  44 notices that there are changes to propagate to slave
  45 .B slapd
  46 instances, it locks the replication log, makes its own private copy,
  47 releases the lock, and forks one copy of itself for each replica
  48 .B slapd
  49 to be updated.  Each child process binds to the slave
  50 .B slapd
  51 as the
  52 DN given by the
  53 .I binddn
  54 option to the
  55 .I replica
  56 directive in the
  57 .B slapd
  58 config file, and sends the changes.
  59 .LP
  60 See
  61 .BR slapd (8)
  62 for details on the standalone LDAP daemon.
  63 .SH OPTIONS
  64 .TP
  65 .BI \-d " debug\-level"
  66 Turn on debugging as defined by
  67 .I debug\-level.
  68 If this option is specified, even with a zero argument,
  69 .B slurpd
  70 will not fork or disassociate from the invoking terminal.  Some general
  71 operation and status messages are printed for any value of \fIdebug\-level\fP.
  72 \fIdebug\-level\fP is taken as a bit string, with each bit corresponding to a
  73 different kind of debugging information.  See <ldap.h> for details.
  74 .TP
  75 .BI \-f " slapd\-config\-file"
  76 Specifies the slapd configuration file.  The default is
  77 .BR ETCDIR/slapd.conf .
  78 .TP
  79 .BI \-r " slapd\-replog\-file"
  80 Specifies the name of the
  81 .B slapd
  82 replication logfile.  Normally, the name
  83 of the replication log file is read from the
  84 .B slapd
  85 configuration file.
  86 The
  87 .B \-r
  88 option allows you to override this.  In conjunction with the
  89 .B \-o
  90 option, you can process a replication log file in a "one\-shot" mode.  For
  91 example, if
  92 .B slurpd
  93 has encountered errors in processing a replication log,
  94 you can run it in one\-shot mode and give the rejection file name as
  95 the argument to the \-r option, once you've resolved the problem which caused
  96 the replication to fail.
  97 .TP
  98 .B \-o
  99 Run in "one\-shot" mode.  Normally,
 100 .B slurpd
 101 processes the replog file
 102 and then watches for more replication entries to be appended.  In
 103 one\-shot mode,
 104 .B slurpd
 105 processes a replication log and exits.
 106 .TP
 107 .BI \-t " temp\-dir"
 108 .B slurpd
 109 copies the replication log to a working directory before processing it.
 110 This option allows you to specify the location of these temporary files.
 111 The default is
 112 .BR /usr/tmp .
 113 .TP
 114 .BI \-k " srvtab\-file"
 115 Specify the location of the kerberos srvtab file which contains keys
 116 for the replica
 117 .I slapd
 118 instances.  Overrides the srvtab argument to the
 119 replica directive in the
 120 .I slapd
 121 configuration file.
 122 .SH EXAMPLES
 123 To start
 124 .I slurpd
 125 and have it fork and detach from the terminal and process
 126 the replication logs generated by
 127 .I slapd,
 128 just type:
 129 .LP
 130 .nf
 131 .ft tt
 132         LIBEXECDIR/slurpd
 133 .ft
 134 .fi
 135 .LP
 136 To start
 137 .I slurpd
 138 with an alternate
 139 .I slapd
 140 configuration file, and turn
 141 on voluminous debugging which will be printed on standard error, type:
 142 .LP
 143 .nf
 144 .ft tt
 145         LIBEXECDIR/slurpd -f ETCDIR/slapd.conf -d 255
 146 .ft
 147 .fi
 148 .LP
 149 .SH "SEE ALSO"
 150 .BR ldap (3),
 151 .BR slapd.replog (5),
 152 .BR slapd (8)
 153 .LP
 154 "The SLAPD and SLURPD Administrator's Guide"
 155 .SH ACKNOWLEDGEMENTS
 156 .B      OpenLDAP
 157 is developed and maintained by The OpenLDAP Project (http://www.openldap.org/).
 158 .B      OpenLDAP
 159 is derived from University of Michigan LDAP 3.3 Release.