2004-12-05 04:42:04 +08:00
|
|
|
.TH SLAPO-SYNCPROV 5 "RELEASEDATE" "OpenLDAP LDVERSION"
|
2009-01-22 08:40:04 +08:00
|
|
|
.\" Copyright 2004-2009 The OpenLDAP Foundation All Rights Reserved.
|
2004-12-05 04:42:04 +08:00
|
|
|
.\" Copying restrictions apply. See COPYRIGHT/LICENSE.
|
|
|
|
|
.\" $OpenLDAP$
|
|
|
|
|
.SH NAME
|
2009-06-03 08:43:44 +08:00
|
|
|
slapo\-syncprov \- Sync Provider overlay to slapd
|
2004-12-05 04:42:04 +08:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
.SH DESCRIPTION
|
2006-07-30 00:44:29 +08:00
|
|
|
The Sync Provider overlay implements the provider-side support for the
|
|
|
|
|
LDAP Content Synchronization (RFC4533) as well as syncrepl replication
|
|
|
|
|
support. The overlay
|
2004-12-05 04:42:04 +08:00
|
|
|
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
|
2005-07-04 14:57:10 +08:00
|
|
|
memory. The value is written to the database on server shutdown and read into
|
2004-12-05 04:42:04 +08:00
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
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
|
2006-07-30 00:44:29 +08:00
|
|
|
options apply to the Sync Provider overlay.
|
2004-12-05 04:42:04 +08:00
|
|
|
They should appear after the
|
|
|
|
|
.B overlay
|
|
|
|
|
directive.
|
|
|
|
|
.TP
|
2009-06-03 08:43:44 +08:00
|
|
|
.B syncprov\-checkpoint <ops> <minutes>
|
2004-12-05 04:42:04 +08:00
|
|
|
After a write operation has succeeded, write the contextCSN to the underlying
|
2005-08-14 16:20:54 +08:00
|
|
|
database if
|
|
|
|
|
.B <ops>
|
|
|
|
|
write operations or more than
|
|
|
|
|
.B <minutes>
|
|
|
|
|
time have passed
|
2004-12-05 04:42:04 +08:00
|
|
|
since the last checkpoint. Checkpointing is disabled by default.
|
2004-12-08 12:57:43 +08:00
|
|
|
.TP
|
2009-06-03 08:43:44 +08:00
|
|
|
.B syncprov\-sessionlog <ops>
|
2008-11-14 06:06:21 +08:00
|
|
|
Configures an in-memory session log for recording information about write
|
|
|
|
|
operations made on the database. The
|
2005-08-14 16:35:31 +08:00
|
|
|
.B <ops>
|
2005-08-14 16:20:54 +08:00
|
|
|
specifies the number of operations that are recorded in the log. All write
|
|
|
|
|
operations (except Adds) are recorded in the log.
|
2004-12-08 12:57:43 +08:00
|
|
|
When using the session log, it is helpful to set an eq index on the
|
|
|
|
|
entryUUID attribute in the underlying database.
|
2005-10-18 11:25:57 +08:00
|
|
|
.TP
|
2009-06-03 08:43:44 +08:00
|
|
|
.B syncprov\-nopresent TRUE | FALSE
|
2005-10-18 11:25:57 +08:00
|
|
|
Specify that the Present phase of refreshing should be skipped. This value
|
|
|
|
|
should only be set TRUE for a syncprov instance on top of a log database
|
|
|
|
|
(such as one managed by the accesslog overlay).
|
|
|
|
|
The default is FALSE.
|
|
|
|
|
.TP
|
2009-06-03 08:43:44 +08:00
|
|
|
.B syncprov\-reloadhint TRUE | FALSE
|
2006-07-30 00:44:29 +08:00
|
|
|
Specify that the overlay should honor the reloadHint flag in the Sync
|
|
|
|
|
Control. In OpenLDAP releases 2.3.11 and earlier the syncrepl consumer did
|
2005-10-18 11:25:57 +08:00
|
|
|
not properly set this flag, so the overlay must ignore it. This option
|
|
|
|
|
should be set TRUE when working with newer releases that properly support
|
|
|
|
|
this flag. It must be set TRUE when using the accesslog overlay for
|
2006-07-30 00:44:29 +08:00
|
|
|
delta-based syncrepl replication support. The default is FALSE.
|
2004-12-05 04:42:04 +08:00
|
|
|
.SH FILES
|
|
|
|
|
.TP
|
|
|
|
|
ETCDIR/slapd.conf
|
|
|
|
|
default slapd configuration file
|
|
|
|
|
.SH SEE ALSO
|
2005-10-18 11:25:57 +08:00
|
|
|
.BR slapd.conf (5),
|
2009-01-30 08:23:58 +08:00
|
|
|
.BR slapd\-config (5),
|
2009-06-03 08:43:44 +08:00
|
|
|
.BR slapo\-accesslog (5).
|
2004-12-08 12:57:43 +08:00
|
|
|
OpenLDAP Administrator's Guide.
|
2007-01-03 04:25:16 +08:00
|
|
|
.SH ACKNOWLEDGEMENTS
|
|
|
|
|
.so ../Project
|
