SLAPADD(8) دستورات مدیریت سیستم SLAPADD(8)

slapadd - افزودن ورودیها به پایگاهداده دایرکتوری slapd

/usr/sbin/slapadd [-b suffix] [-c] [-d debug-level] [-f slapd.conf] [-F confdir] [-g] [-j lineno] [-l ldif-file] [-n dbnum] [-o option[=value]] [-q] [-s] [-S SID] [-u] [-v] [-w]

دستور slapadd ورودیها را از یک فایل LDIF خوانده و مستقیماً به پایگاهداده دیمن slapd اضافه میکند.

Slapadd برای افزودن ورودی‌های مشخص‌شده در قالب تبادل دایرکتوری ال‌دپ (LDIF) به یک پایگاه‌داده slapd(8) استفاده می‌شود. این ابزار پایگاه‌داده مشخص‌شده بر اساس شماره پایگاه‌داده یا پسوند (suffix) را باز کرده و ورودی‌های متناظر با LDIF ارائه‌شده را به پایگاه‌داده اضافه می‌کند. پایگاه‌های داده‌ای که به عنوان subordinate (زیرمجموعه) این پایگاه‌داده پیکربندی شده‌اند نیز به‌روزرسانی می‌شوند، مگر اینکه گزینه -g مشخص شده باشد. ورودی LDIF از ورودی استاندارد یا فایل مشخص‌شده خوانده می‌شود.

تمام فایل‌هایی که در نهایت توسط slapadd ایجاد می‌شوند متعلق به هویتی خواهند بود که slapadd تحت آن اجرا شده است؛ بنابراین مطمئن شوید که یا slapadd را با همان هویتی که slapd(8) با آن اجرا خواهد شد اجرا می‌کنید (گزینه -u در slapd(8) را ببینید)، یا مالکیت فایل را پیش از اجرای slapd(8) تغییر دهید.

نکته: در صورتی که نمایه‌سازی (indexing) پیکربندی شده باشد، slapadd هنگام افزودن به پایگاه‌داده، این نمایه‌سازی‌ها را نیز انجام می‌دهد. برای جزئیات بیشتر به slapindex(8) مراجعه کنید.

از suffix مشخص‌شده برای تعیین پایگاه‌داده‌ای که ورودی‌ها به آن اضافه می‌شوند استفاده کنید. به‌طور پیش‌فرض، نخستین پایگاه‌داده‌ای که از عملیات درخواست‌شده پشتیبانی می‌کند استفاده می‌شود. گزینه -b نمی‌تواند همراه با گزینه -n استفاده شود.
فعال‌سازی حالت ادامه (نادیده گرفتن خطاها).
فعال‌سازی پیام‌های اشکال‌زدایی طبق debug-level مشخص‌شده؛ برای جزئیات به slapd(8) مراجعه کنید.
مشخص کردن یک فایل جایگزین برای slapd.conf(5).
مشخص کردن یک پوشه پیکربندی. اگر هر دو گزینه -f و -F مشخص شوند، فایل پیکربندی خوانده شده و به قالب پوشه پیکربندی تبدیل می‌شود و در پوشه مشخص‌شده نوشته می‌شود. اگر هیچ‌کدام مشخص نشوند، پیش از تلاش برای استفاده از فایل پیکربندی پیش‌فرض، تلاش می‌شود پوشه پیکربندی پیش‌فرض خوانده شود. اگر یک پوشه پیکربندی معتبر وجود داشته باشد، فایل پیکربندی پیش‌فرض نادیده گرفته می‌شود. اگر حالت آزمایش (dry-run) نیز مشخص شده باشد، هیچ تبدیلی صورت نخواهد گرفت.
غیرفعال کردن اتصال زیرمجموعه‌ها (subordinate gluing). فقط پایگاه‌داده مشخص‌شده پردازش خواهد شد و نه زیرمجموعه‌های متصل به آن (در صورت وجود).
پرش به شماره خط مشخص‌شده در فایل LDIF پیش از پردازش هرگونه ورودی. این امکان را می‌دهد تا بارگذاری‌ای که به دلیل خطا در ورودی LDIF متوقف شده بود، پس از تصحیح خطاها از سر گرفته شود.
خواندن LDIF از فایل مشخص‌شده به‌جای ورودی استاندارد.
افزودن ورودی‌ها به dbnum-امین پایگاه‌داده فهرست‌شده در فایل پیکربندی. گزینه -n نمی‌تواند همراه با گزینه -b استفاده شود. برای پر کردن پایگاه‌داده پیکربندی slapd-config(5)، از -n 0 استفاده کنید زیرا همیشه اولین پایگاه‌داده است. با این حال، باید پیش از این کار به‌صورت فیزیکی روی سیستم فایل وجود داشته باشد.
مشخص کردن یک option همراه با یک value (اختیاری). گزینه‌ها و مقادیر عمومی ممکن عبارتند از:
syslog=<subsystems>  (see `-s' in slapd(8))
syslog-level=<level> (see `-S' in slapd(8))
syslog-user=<user>   (see `-l' in slapd(8))
schema-check={yes|no}
value-check={yes|no}

گزینه schema-check بررسی طرحواره را تغییر وضعیت می‌دهد (پیش‌فرض روشن است)؛ گزینه value-check بررسی مقدار را تغییر وضعیت می‌دهد (پیش‌فرض خاموش است). گزینه دوم با -q ناسازگار است.

فعال‌سازی حالت سریع (بررسی‌های یکپارچگی کمتر). بررسی‌های سازگاری کمتری روی داده‌های ورودی انجام می‌دهد و هنگام نوشتن در پایگاه‌داده هیچ بررسی سازگاری انجام نمی‌دهد. زمان بارگذاری را بهبود می‌بخشد اما در صورت بروز هرگونه خطا یا وقفه، پایگاه‌داده حاصل غیرقابل استفاده خواهد بود.
غیرفعال کردن بررسی طرحواره (schema). این گزینه برای استفاده هنگام بارگذاری پایگاه‌های داده شامل اشیاء خاص، مانند اشیاء کسری در یک کلاینت جزئی (partial consumer) در نظر گرفته شده است. بارگذاری اشیاء عادی که با طرحواره مطابقت ندارند ممکن است منجر به رفتار غیرمنتظره و معیوب شود.
شناسه سرور (Server ID) برای استفاده در entryCSN تولیدشده. در صورت تنظیم -w برای contextCSN نیز استفاده می‌شود. مقدار پیش‌فرض 0 است.
فعال‌سازی حالت شبیه‌سازی / dry-run (عدم نوشتن در بک‌اند).
فعال‌سازی حالت پرحرف (verbose).
نوشتن اطلاعات زمینه syncrepl. پس از افزودن تمام ورودی‌ها، contextCSN با بزرگترین CSN موجود در پایگاه‌داده به‌روزرسانی می‌شود.

برای اطمینان از سازگاری پایگاه‌داده، دیمن slapd(8) شما هنگام انجام این کار نباید در حال اجرا باشد.

دستور slapadd ممکن است بررسی‌های نام‌گذاری یا طرحواره را ارائه ندهد. توصیه می‌شود هنگام افزودن ورودی‌های جدید به یک دایرکتوری موجود از ldapadd(1) استفاده کنید.

برای وارد کردن ورودی‌های مشخص‌شده در فایل ldif به پایگاه‌داده slapd(8) خود، دستور زیر را اجرا کنید:

/usr/sbin/slapadd -l ldif

ldap(3), ldif(5), slapcat(8), slapindex(8), slapmodify(8), ldapadd(1), slapd(8)

"OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin)

OpenLDAP Software توسط پروژه OpenLDAP توسعه یافته و نگهداری می‌شود http://www.openldap.org. OpenLDAP Software از انتشار ال‌دپ ۳.۳ دانشگاه میشیگان مشتق شده است.

مه ۲۰۲۵ OpenLDAP