2004-12-05 04:42:04 +08:00
|
|
|
.TH SLAPO-SYNCPROV 5 "RELEASEDATE" "OpenLDAP LDVERSION"
|
2005-01-02 04:49:32 +08:00
|
|
|
.\" Copyright 2004-2005 The OpenLDAP Foundation All Rights Reserved.
|
2004-12-05 04:42:04 +08:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
|
|
|
|
.\" $OpenLDAP$
|
|
|
|
|
.SH NAME
|
|
|
|
|
slapo-syncprov \- Syncrepl Provider overlay
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The Syncrepl Provider overlay implements the provider-side support for
|
|
|
|
|
syncrepl replication, including persistent search functionality. The overlay
|
|
|
|
|
can be used with any backend that maintains entryCSN and entryUUID
|
|
|
|
|
attributes for its entries. It also creates a contextCSN attribute in
|
|
|
|
|
the root entry of the database.
|
|
|
|
|
|
|
|
|
|
The contextCSN is updated for every write operation performed against the
|
|
|
|
|
database. To reduce database contention, the contextCSN is only updated in
|
|
|
|
|
memory. The value is written to the detabase on server shutdown and read into
|
|
|
|
|
memory on startup, and maintained in memory thereafter. Checkpoints may be
|
|
|
|
|
configured to write the contextCSN into the underlying database to minimize
|
|
|
|
|
recovery time after an unclean shutdown.
|
|
|
|
|
|
|
|
|
|
Note that due to deadlock constraints in the LDBM database, this overlay
|
|
|
|
|
will only work in RefreshOnly mode, and cannot perform checkpoints, on LDBM.
|
|
|
|
|
|
|
|
|
|
On databases that support inequality indexing, it is helpful to set an
|
|
|
|
|
eq index on the entryCSN attribute when using this overlay.
|
|
|
|
|
.SH CONFIGURATION
|
|
|
|
|
These
|
|
|
|
|
.B slapd.conf
|
|
|
|
|
options apply to the Syncrepl Provider overlay.
|
|
|
|
|
They should appear after the
|
|
|
|
|
.B overlay
|
|
|
|
|
directive and before any subsequent
|
|
|
|
|
.B database
|
|
|
|
|
directive.
|
|
|
|
|
.TP
|
|
|
|
|
.B syncprov-checkpoint <ops> <minutes>
|
|
|
|
|
After a write operation has succeeded, write the contextCSN to the underlying
|
|
|
|
|
database if <ops> write operations or more than <minutes> time have passed
|
|
|
|
|
since the last checkpoint. Checkpointing is disabled by default.
|
2004-12-08 12:57:43 +08:00
|
|
|
.TP
|
|
|
|
|
.B syncprov-sessionlog <sid> <size>
|
|
|
|
|
Specify a session log for recording information about entries that have been
|
|
|
|
|
scoped out of the content identified by
|
|
|
|
|
.BR <sid> .
|
|
|
|
|
The number of entries in the log is limited by
|
|
|
|
|
.BR <size> .
|
|
|
|
|
Both
|
|
|
|
|
.B <sid>
|
|
|
|
|
and
|
|
|
|
|
.B <size>
|
|
|
|
|
must be non-negative integers, and
|
|
|
|
|
.B <sid>
|
|
|
|
|
can have no more than three decimal digits.
|
|
|
|
|
When using the session log, it is helpful to set an eq index on the
|
|
|
|
|
entryUUID attribute in the underlying database.
|
2004-12-05 04:42:04 +08:00
|
|
|
.SH FILES
|
|
|
|
|
.TP
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
default slapd configuration file
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR slapd.conf (5).
|
2004-12-08 12:57:43 +08:00
|
|
|
OpenLDAP Administrator's Guide.
|
