.TH mfschunkserver.cfg "5" "مه 2026" "MooseFS 4.59.2-1" "این بخشی از MooseFS است"
.ss 12 0
.SH "نام (NAME)"
mfschunkserver.cfg \- فایل پیکربندی اصلی برای \fBmfschunkserver\fP
.SH "توضیحات (DESCRIPTION)"
فایل \fBmfschunkserver.cfg\fP شامل پیکربندی پردازهٔ چانک‌سرور MooseFS است.
.SH "نحو (SYNTAX)"
.PP
نحو به صورت زیر است:
.TP
.IB OPTION " = " VALUE
.PP
خطوطی که با نویسهٔ \fB#\fP آغاز می‌شوند به عنوان توضیح نادیده گرفته می‌شوند.
.SS "گزینه‌های راه‌اندازی (STARTUP OPTIONS)"
تغییرات در این بخش نیازمند راه‌اندازی مجدد پردازه است.
.TP
.B WORKING_USER
کاربری که دیمن با آن اجرا می‌شود.
.TP
.B WORKING_GROUP
گروهی که دیمن با آن اجرا می‌شود؛ مقدار اختیاری \- در صورت خالی بودن، گروه پیش‌فرض کاربر استفاده خواهد شد.
.TP
.B SYSLOG_IDENT
نام پردازه برای قرارگیری در پیام‌های syslog؛ پیش‌فرض mfschunkserver است.
.TP
.B LOCK_MEMORY
آیا برای جلوگیری از مبادله (swap) پردازهٔ mfschunkserver از ()mlockall استفاده شود یا خیر؛ پیش‌فرض 0 است، یعنی خیر.
.TP
.B LIMIT_GLIBC_MALLOC_ARENAS
محدود کردن آرناهای malloc به مقدار داده‌شده \- از مصرف مقادیر زیاد حافظهٔ مجازی توسط سرور جلوگیری می‌کند (فقط لینوکس، پیش‌فرض 4 است).
.TP
.B DISABLE_OOM_KILLER
غیرفعال کردن قاتل کمبود حافظه (OOM Killer) (فقط لینوکس، پیش‌فرض 1 است).
.TP
.B NICE_LEVEL
سطح nice برای اجرای دیمن؛ پیش‌فرض \-19 است؛ نکته: پردازه برای افزایش اولویت باید با دسترسی root اجرا شود، اگر تنظیم اولویت ناموفق باشد، پردازه همان سطح nice را که با آن شروع شده بود حفظ می‌کند.
.TP
.B FILE_UMASK
تنظیم umask پیش‌فرض برای گروه و دیگران (کاربر مالک همواره 0 دارد)؛ پیش‌فرض 027 است \- مسدود کردن نوشتن برای گروه و مسدود کردن همه دسترسی‌ها برای دیگران.
.TP
.B DATA_PATH
محل ذخیره‌سازی فایل قفل دیمن.
.TP
.B ALLOW_STARTING_WITH_INVALID_DISKS
اگر روی یک تنظیم شود، چانک‌سرور حتی در صورت یافتن مدخل‌های نادرست در فایل 'mfshdd.cfg' از شروع کار انصراف نمی‌دهد؛ پیش‌فرض 0 است (با مدخل‌های نامعتبر راه‌اندازی نشود).
.TP
.B CAN_USE_MMAP
استفاده از mmap برای تخصیص حافظه می‌تواند مصرف رم را اندکی کاهش داده و کارایی را کمی بهبود بخشد، اما در برخی معماری‌ها یا کرنل‌ها می‌تواند منجر به بروز مشکلاتی شود \- به ویژه در معماری‌هایی با بیش از یک CPU فیزیکی؛ پیش‌فرض 0 است.
.SS "گزینه‌های زمان اجرا (RUNTIME OPTIONS)"
تغییرات در این بخش تنها نیازمند بازخوانی (reload) پردازه است.
.TP
.B HDD_CONF_FILENAME
مکان یا نام جایگزین برای فایل \fBmfshdd.cfg\fP.
.TP
.B HDD_TEST_SPEED
سرعت آزمون‌های پس‌زمینهٔ چانک‌ها بر حسب مگابایت بر ثانیه به ازای هر دیسک (به‌طور رسمی مدخل تعریف‌شده در \fBmfshdd.cfg\fP). مقدار می‌تواند به صورت یک عدد اعشاری مشخص شود؛ پیش‌فرض 1.0 است.
.TP
.B HDD_MIN_TEST_INTERVAL
در صورتی که آخرین ورودی/خروجی (شامل آزمون) کمتر از زمان HDD_MIN_TEST_INTERVAL پیش انجام شده باشد، از بررسی درستی چانک جلوگیری می‌کند؛ پیش‌فرض 1 روز است؛ برای قالب‌بندی مقدار بخش TIME را ببینید.
.TP
.B HDD_FADVISE_MIN_TIME
در صورت امکان، استفاده از posix_fadvise(POSIX_DONTNEED) پس از هر آزمون چانک (اما تنها در صورتی که آخرین عملیات ورودی/خروجی بیش از HDD_FADVISE_MIN_TIME پیش انجام شده باشد). استفاده از صفر باعث می‌شود posix_fadvise همیشه اجرا شود (تخلیه حافظه موقت کش) و استفاده از مقدار منفی هرگز حافظه موقت را پس از آزمون‌ها تخلیه نخواهد کرد. این تنظیم تنها برای سیستم‌هایی معتبر است که از posix_fadvise پشتیبانی می‌کنند؛ پیش‌فرض 1 روز است؛ برای قالب‌بندی مقدار بخش TIME را ببینید.
.TP
.B HDD_LEAVE_SPACE_DEFAULT
چه مقدار فضا باید در هر دیسک سخت استفاده‌نشده باقی بماند؛
.br
قالب عدد:
.nf
[0-9]*([.][0-9]*)?([kMGTPE]|[KMGTPE]i)?B?
.fi
پیش‌فرض 256MiB است؛
مثال‌ها: 0.5GB، .5G، 2.56GiB، 1256M و غیره.
.TP
.B HDD_REBALANCE_UTILIZATION
درصد کل زمان کاری که چانک‌سرور مجاز است برای متوازن‌سازی فضای دیسک سخت صرف کند؛ پیش‌فرض 20 است.
.TP
.B HDD_HIGH_SPEED_REBALANCE_LIMIT
حداکثر عملیات نوشتن هم‌زمان به ازای هر دیسک در متوازن‌سازی سریع دیسک (0 به معنای استفاده از متوازن‌سازی استاندارد است؛ پیش‌فرض 0 است).
.TP
.BR HDD_ERROR_TOLERANCE_COUNT ", " HDD_ERROR_TOLERANCE_PERIOD
چه تعداد خطای ورودی/خروجی (COUNT) در مدت‌زمان مشخص به ثانیه (PERIOD) در یک دیسک سخت قابل تحمل است؛ اگر تعداد خطاها از این تنظیم فراتر رود، دیسک سخت خاطی به عنوان آسیب‌دیده علامت‌گذاری خواهد شد؛ پیش‌فرض‌ها 2 و 600 هستند.
.TP
.B HDD_FSYNC_BEFORE_CLOSE
فعال/غیرفعال کردن fsync پیش از بستن چانک؛ پیش‌فرض 0 است (خاموش).
.TP
.B HDD_SPARSIFY_ON_WRITE
فعال/غیرفعال کردن تُنک‌سازی (sparsification؛ صرف‌نظر از صفرهای ابتدا و انتها) در هنگام نوشتن بلوک جدید؛ پیش‌فرض 1 است (روشن).
.TP
.B HDD_RR_CHUNK_COUNT
چه تعداد چانک باید در یک دایرکتوری پیش از رفتن به دایرکتوری بعدی ایجاد شود؛ مقادیر بالاتر با الگوریتم‌های حافظه موقت کش اکثر سیستم‌عامل‌ها سازگارتر هستند، مقادیر پایین‌تر منجر به توزیع یکنواخت‌تر چانک‌ها می‌شوند؛ پیش‌فرض 10000 است که در بیشتر موارد بهترین نتیجه را می‌دهد.
.TP
.B HDD_KEEP_DUPLICATES_HOURS
چند ساعت چانک‌های تکراری باید پیش از حذف نگهداری شوند (پیش‌فرض یک هفته است)؛ تغییر این مقدار و بارگذاری مجدد پیکربندی شمارنده را بازنشانی می‌کند؛ برای قالب‌بندی مقدار بخش TIME را ببینید.
.TP
.BR WORKERS_MAX ", " WORKERS_MAX_IDLE
حداکثر تعداد کارگران (workers) فعال و حداکثر تعداد کارگران بیکار؛ پیش‌فرض‌ها 250 و 40 هستند.
.TP
.B SYSLOG_MIN_LEVEL
حداقل سطح پیام‌هایی که توسط چانک‌سرور گزارش خواهد شد؛ سطوح به ترتیب اهمیت: ERROR، WARNING، NOTICE، INFO، DEBUG (پیش‌فرض INFO است).
.TP
.B SYSLOG_ELEVATE_TO
پیام‌های گزارش‌شده با سطح پایین‌تر از مقدار تعیین‌شده توسط این گزینه به این سطح ارتقا می‌یابند (برای نمونه اگر \fBSYSLOG_MIN_LEVEL\fP روی DEBUG تنظیم شده باشد و \fBSYSLOG_ELEVATE_TO\fP روی NOTICE قرار گیرد، تمام پیام‌های INFO و DEBUG با سطح NOTICE به syslog ارسال خواهند شد؛ پیش‌فرض NOTICE است).
.SS "گزینه‌های اتصال مستر (MASTER CONNECTION OPTIONS)"
تغییرات در این بخش تنها نیازمند بازخوانی (reload) پردازه است.
.TP
.B LABELS
.br
رشتهٔ برچسب‌ها که به صورت مجموعه‌ای از حروف (بدون حساسیت به حروف بزرگ و کوچک) جداشده با کاما یا نقطه-ویرگول تعریف می‌شود؛ پیش‌فرض خالی است \- بدون برچسب.
.TP
.B BIND_HOST
آدرس محلی برای استفاده در اتصالات مستر؛ پیش‌فرض * است، یعنی آدرس محلی پیش‌فرض.
.TP
.B MASTER_HOST
میزبان مستر MooseFS؛ مشخص کردن IP تنها در پیکربندی‌های تک‌مستر مجاز است؛ پیش‌فرض mfsmaster است.
.TP
.B MASTER_PORT
پورت فرمان مستر MooseFS؛ پیش‌فرض 9420 است.
.TP
.B MASTER_CONTROL_PORT
(فقط نسخه Pro) پورت کنترل مستر MooseFS؛ پیش‌فرض 9419 است.
.TP
.B MASTER_TIMEOUT
مهلت زمانی به ثانیه برای اتصالات مستر (در صورتی که 0 نباشد)؛ اگر این مقدار صفر باشد، چانک‌سرور در ابتدا آن را روی 10 تنظیم کرده و مقدار دقیق را از مستر استعلام می‌کند؛ پیش‌فرض 0 است (استعلام از مستر).
.TP
.B MASTER_RECONNECTION_DELAY
تاخیر به ثانیه پیش از تلاش مجدد برای اتصال به مستر پس از قطع ارتباط (پیش‌فرض 5 است).
.TP
.B AUTH_CODE
رشتهٔ احراز هویت (تنها زمانی استفاده می‌شود که مستر نیاز به احراز هویت داشته باشد).
.TP
.B CHUNKS_PER_REGISTER_PACKET
حداکثر تعداد چانک‌هایی که سیستم تلاش می‌کند در یک پیام ثبت (register) واحد قرار دهد (پیش‌فرض 1000 است، محدوده مجاز بین 100 تا 10000).
.SS "گزینه‌های اتصال کلاینت‌ها (CLIENTS CONNECTION OPTIONS)"
تغییرات در این بخش تنها نیازمند بازخوانی (reload) پردازه است.
.TP
.B CSSERV_LISTEN_HOST
آدرس IP برای شنود اتصالات کلاینت (mount) (\fB*\fP به معنای هر آدرسی است).
.TP
.B CSSERV_LISTEN_PORT
پورت برای شنود اتصالات کلاینت (mount) (پیش‌فرض 9422 است).
.SH "یادداشت‌ها (NOTES)"
.SS "زمان (TIME)"
.PP
برای متغیرهای پیکربندی که زمان را بدون نیاز به یک واحد خاص و واحد تعریف می‌کنند، زمان می‌تواند به صورت تعداد ثانیه‌ها (عدد صحیح) یا یک دورهٔ زمانی در یکی از دو قالب ممکن مشخص شود:
.PP
قالب نخست: #.#T که در آن T یکی از این موارد است: s برای ثانیه، m برای دقیقه، h برای ساعت، d برای روز یا w برای هفته؛ مقادیر کسری ثانیه به ثانیه کامل گرد می‌شوند.
.PP
قالب دوم: #w#d#h#m#s، هر تعداد از تعریف‌ها را می‌توان حذف کرد، اما تعریف‌های باقی‌مانده باید به ترتیب باشند (بنابراین #d#m همچنان یک تعریف معتبر است، اما #m#d معتبر نیست)؛ محدوده‌ها: s و m از 0 تا 59، h از 0 تا 23، d از 0 تا 6، w نامحدود است و نخستین تعریف نیز همواره نامحدود است (یعنی برای #d#h#m مقدار d نامحدود خواهد بود).
.PP
توجه! برای متغیر \fBHDD_KEEP_DUPLICATES_HOURS\fP تنها واحدهای زمانی h، d و w پذیرفته می‌شوند و مقدار بدون واحد زمانی به عنوان ساعت در نظر گرفته می‌شود؛ بخش‌های کسری به ساعت کامل گرد می‌شوند.
.PP
مثال‌ها:
.PP
1.5h همانند 1h30m، معادل 90m، برابر با 5400s و برابر با 5400 است.
.PP
2.5d همانند 2d12h و معادل 60h است؛ عبارت 1d36h یک دورهٔ زمانی معتبر نیست (زیرا h نخستین تعریف نیست، بنابراین به محدوده 0 تا 23 محدود شده است).
.PP
1.03m معادل 62s است (61.8 ثانیه به سمت بالا به 62 گرد می‌شود).
.SH "حق نشر (COPYRIGHT)"
Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA
.PP
این پرونده بخشی از MooseFS است.
.PP
نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) طبق آنچه بنیاد نرم‌افزار آزاد منتشر کرده است، فقط نگارش ۲، بازتوزیع کنید یا تغییر دهید.
.PP
نرم‌افزار MooseFS به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
باید همراه با این برنامه نسخه‌ای از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، نشانی
<https://www.gnu.org/licenses/>
را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.BR mfschunkserver (8),
.BR mfshdd.cfg (5)