X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fman%2Fman5%2Fslapo-syncprov.5;h=6f2d6a29499f8d78efe8e31f2d1e4be69b1a048d;hb=1e38e77364e7df05cd610db644aaf91e0d7abb2b;hp=6b12b4e7eaa20d7b162c2346653963f12b66a8ac;hpb=135672c91032ea90fb2897beb02972905ce36932;p=openldap diff --git a/doc/man/man5/slapo-syncprov.5 b/doc/man/man5/slapo-syncprov.5 index 6b12b4e7ea..6f2d6a2949 100644 --- a/doc/man/man5/slapo-syncprov.5 +++ b/doc/man/man5/slapo-syncprov.5 @@ -1,14 +1,15 @@ .TH SLAPO-SYNCPROV 5 "RELEASEDATE" "OpenLDAP LDVERSION" -.\" Copyright 2004-2005 The OpenLDAP Foundation All Rights Reserved. +.\" Copyright 2004-2013 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 to slapd .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. @@ -20,45 +21,55 @@ 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. +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 +.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 +Configures an in-memory 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 slapd\-config (5), +.BR slapo\-accesslog (5). OpenLDAP Administrator's Guide. +.SH ACKNOWLEDGEMENTS +.so ../Project