.lf 1 "-
.TH SLAPO-SYNCPROV 5 "2026/03/09" "OpenLDAP 2.6.13"
.\" Copyright 2004-2026 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
.SH "نام (NAME)"
slapo\-syncprov \- اورلی ارائه‌دهنده همگام‌سازی (Sync Provider) برای slapd
.SH "خلاصه دستور (SYNOPSIS)"
/etc/openldap/slapd.conf
.SH "توضیحات (DESCRIPTION)"
اورلی ارائه‌دهنده همگام‌سازی (Sync Provider) پشتیبانی سمت ارائه‌دهنده را برای همگام‌سازی محتوای LDAP (RFC4533) و همچنین پشتیبانی از تکثیر syncrepl پیاده‌سازی می‌کند. این اورلی می‌تواند با هر بک‌اَندی که صفت‌های entryCSN و entryUUID را برای مدخل‌های خود نگهداری می‌کند، استفاده شود. همچنین یک صفت contextCSN در مدخل ریشه پایگاه‌داده ایجاد می‌کند.

صفت contextCSN برای هر عملیات نوشتن انجام‌شده بر روی پایگاه‌داده به‌روزرسانی می‌شود. برای کاهش رقابت (contention) در پایگاه‌داده، contextCSN تنها در حافظه به‌روزرسانی می‌شود. این مقدار هنگام خاموش شدن سرور در پایگاه‌داده نوشته شده و در زمان راه‌اندازی درون حافظه خوانده می‌شود، و از آن پس در حافظه نگهداری می‌گردد. می‌توان نقاط بازرسی (checkpoints) را پیکربندی کرد تا contextCSN در پایگاه‌داده زیربنایی نوشته شود تا زمان بازیابی پس از یک خاموشی غیرمنتظره به حداقل برسد.

در پایگاه‌های داده‌ای که از نمایه‌سازی نامساوی (inequality indexing) پشتیبانی می‌کنند، هنگام استفاده از این اورلی اکیداً توصیه می‌شود که یک نمایهٔ eq بر روی صفت entryCSN تنظیم شود.
.SH "پیکربندی (CONFIGURATION)"
این گزینه‌های
.B slapd.conf
برای اورلی ارائه‌دهنده همگام‌سازی اعمال می‌شوند.
آن‌ها باید پس از دستورالعمل
.B overlay
قرار گیرند.
.TP
.B syncprov\-checkpoint <ops> <minutes>
پس از موفقیت‌آمیز بودن یک عملیات نوشتن، در صورتی که
.B <ops>
عملیات نوشتن انجام شده باشد یا بیش از
.B <minutes>
زمان از آخرین نقطه بازرسی گذشته باشد، contextCSN را در پایگاه‌داده زیربنایی می‌نویسد.
نقطه‌گذاری بازرسی (checkpointing) به‌طور پیش‌فرض غیرفعال است.
.TP
.B syncprov\-sessionlog <ops>
یک گزارش نشست (session log) درون‌حافظه‌ای را برای ثبت اطلاعات مربوط به عملیات نوشتن انجام‌شده بر روی پایگاه‌داده پیکربندی می‌کند. پارامتر
.B <ops>
تعداد عملیاتی را که در گزارش ثبت می‌شوند مشخص می‌سازد. تمامی عملیات نوشتن (به‌جز موارد Adds) در گزارش ثبت می‌شوند.
هنگام استفاده از گزارش نشست، تنظیم یک نمایهٔ eq بر روی صفت entryUUID در پایگاه‌داده زیربنایی سودمند خواهد بود.
.TP
.B syncprov\-sessionlog\-source <dn>
زمانی که syncprov-sessionlog تنظیم شده است نباید مقداردهی شود و بالعکس.

هنگامی که accesslog برای این پایگاه‌داده پیکربندی شده و در این پسوند (suffix) در حال ثبت گزارش باشد، می‌تواند به عنوان منبع گزارش نشست به جای گزارش نشست درون‌حافظه‌ای یادشده در بالا استفاده شود. این گزارش این مزیت را دارد که با هر بار راه‌اندازی مجدد سرور از نو شروع نمی‌شود.
.TP
.B syncprov\-nopresent TRUE | FALSE
مشخص می‌کند که مرحلهٔ Present در نوسازی (refreshing) نادیده گرفته شود. این مقدار تنها باید برای یک نمونه syncprov بر روی یک پایگاه‌داده گزارش (مانند پایگاه‌داده‌ای که توسط اورلی accesslog مدیریت می‌شود) برابر با TRUE تنظیم گردد.
مقدار پیش‌فرض FALSE است.
.TP
.B syncprov\-reloadhint TRUE | FALSE
مشخص می‌کند که این اورلی باید از پرچم reloadHint در کنترل همگام‌سازی (Sync Control) پیروی کند. این مقدار هنگام استفاده از اورلی accesslog برای پشتیبانی از تکثیر syncrepl مبتنی بر دلتا (delta-based) باید روی TRUE تنظیم شود.
مقدار پیش‌فرض FALSE است.
.SH "فایل‌ها (FILES)"
.TP
/etc/openldap/slapd.conf
فایل پیکربندی پیش‌فرض slapd
.SH "همچنین ببینید (SEE ALSO)"
.BR slapd.conf (5),
.BR slapd\-config (5),
.BR slapo\-accesslog (5).
OpenLDAP Administrator's Guide.
.SH "قدردانی‌ها (ACKNOWLEDGEMENTS)"
.lf 1 "./../Project
.\" Shared Project Acknowledgement Text
.B "OpenLDAP Software"
توسط پروژه OpenLDAP در <http://www.openldap.org> توسعه یافته و نگهداری می‌شود.
.B "OpenLDAP Software"
از انتشار LDAP 3.3 دانشگاه میشیگان برگرفته شده است.
.lf 82 "-