X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fman%2Fman5%2Fslapo-syncprov.5;h=c23d4404961f3f6cbca90f8f209def1358d3e642;hb=3164c73276a9d4af56c81f315199acecbb207217;hp=c0b611d834d365af0678dcdbcebc513927e5bd7d;hpb=dc0eacd40b625258355eea866d62188e5aa7ce3b;p=openldap diff --git a/doc/man/man5/slapo-syncprov.5 b/doc/man/man5/slapo-syncprov.5 index c0b611d834..c23d440496 100644 --- a/doc/man/man5/slapo-syncprov.5 +++ b/doc/man/man5/slapo-syncprov.5 @@ -1,21 +1,22 @@ .TH SLAPO-SYNCPROV 5 "RELEASEDATE" "OpenLDAP LDVERSION" -.\" Copyright 2004-2005 The OpenLDAP Foundation All Rights Reserved. +.\" Copyright 2004-2006 The OpenLDAP Foundation All Rights Reserved. .\" Copying restrictions apply. See COPYRIGHT/LICENSE. .\" $OpenLDAP$ .SH NAME -slapo-syncprov \- Syncrepl Provider overlay +slapo-syncprov \- Sync 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 +The Sync Provider overlay implements the provider-side support for the +LDAP Content Synchronization (RFC4533) as well as syncrepl replication +support. 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. The value is written to the database 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. @@ -28,37 +29,47 @@ eq index on the entryCSN attribute when using this overlay. .SH CONFIGURATION These .B slapd.conf -options apply to the Syncrepl Provider overlay. +options apply to the Sync Provider overlay. They should appear after the .B overlay -directive and before any subsequent -.B database directive. .TP .B syncprov-checkpoint After a write operation has succeeded, write the contextCSN to the underlying -database if write operations or more than time have passed +database if +.B +write operations or more than +.B +time have passed since the last checkpoint. Checkpointing is disabled by default. .TP -.B syncprov-sessionlog -Specify a session log for recording information about entries that have been -scoped out of the content identified by -.BR . -The number of entries in the log is limited by -.BR . -Both -.B -and -.B -must be non-negative integers, and -.B -can have no more than three decimal digits. +.B syncprov-sessionlog +Specify a session log for recording information about write operations made +on the database. The +.B +specifies the number of operations that are recorded in the log. All write +operations (except Adds) are recorded in the log. When using the session log, it is helpful to set an eq index on the entryUUID attribute in the underlying database. +.TP +.B syncprov-nopresent TRUE | FALSE +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 +.B syncprov-reloadhint TRUE | FALSE +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 +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 +delta-based syncrepl replication support. The default is FALSE. .SH FILES .TP ETCDIR/slapd.conf default slapd configuration file .SH SEE ALSO -.BR slapd.conf (5). +.BR slapd.conf (5), +.BR slapo-accesslog (5). OpenLDAP Administrator's Guide.