.TH slurmctld "8" "Slurm Daemon" "Slurm 26.05" "Slurm Daemon"

.SH "نام (NAME)"
slurmctld \- دیمن مدیریت مرکزی Slurm\&.
.SH "خلاصه دستور (SYNOPSIS)"
\fBslurmctld\fR [\fIOPTIONS\fR...]
.SH "توضیحات (DESCRIPTION)"
\fBslurmctld\fR دیمن مدیریت مرکزی Slurm است\&. این دیمن تمام دیمن‌ها و منابع دیگر Slurm را نظارت می‌کند، کارها (jobها) را می‌پذیرد و منابع را به آن کارها تخصیص می‌دهد\&. با توجه به اهمیت حیاتی عملکرد \fBslurmctld\fR، ممکن است یک سرور پشتیبان (backup) وجود داشته باشد تا در صورت بروز خرابی در سرور اصلی، این وظایف را بر عهده بگیرد\&.

.SH "گزینه‌ها (OPTIONS)"

.TP
\fB\-c\fR
پاکسازی تمام وضعیت‌های قبلی \fBslurmctld\fR از آخرین نقطه بازرسی (checkpoint)\&.
با استفاده از این گزینه، تمام کارها، اعم از در حال اجرا و در صف انتظار، و وضعیت تمام گره‌ها حذف خواهند شد\&. بدون این گزینه، کارهای در حال اجرای قبلی همراه با \fIState\fR گره‌های DOWN، DRAINED و DRAINING و فیلد \fIReason\fR مربوط به آن گره‌ها حفظ خواهند شد\&.
\fBتوجه\fR: به ندرت ممکن است مایل به استفاده از این گزینه در محیط عملیاتی باشید زیرا تمام کارها خاتمه داده خواهند شد\&.
.IP

.TP
\fB\-D\fR
اجرای \fBslurmctld\fR در پیش‌زمینه با ارسال گزارش‌ها به stderr\&.
این امر تاب‌آوری 'scontrol reconfigure' را محدود می‌کند و باید در محیط عملیاتی از آن اجتناب شود\&.
.IP

.TP
\fB\-f <file>\fR
خواندن پیکربندی از فایل مشخص‌شده\&. به بخش \fBنکات (NOTES)\fR در زیر مراجعه کنید\&.
.IP

.TP
\fB\-h\fR
راهنما؛ چاپ خلاصه‌ای کوتاه از گزینه‌های دستور\&.
.IP

.TP
\fB\-i\fR
نادیده گرفتن خطاهای یافت‌شده هنگام خواندن فایل‌های وضعیت در زمان راه‌اندازی\&.
هشدار: استفاده از این گزینه به معنای از دست رفتن داده‌هایی است که از فایل‌های وضعیت بازیابی نشده‌اند\&.
.IP

.TP
\fB\-L <file>\fR
نوشتن پیام‌های گزارش در فایل مشخص‌شده\&.
.IP

.TP
\fB\-n <value>\fR
تنظیم مقدار nice دیمن به مقدار تعیین‌شده، که معمولاً عددی منفی است\&.
.IP

.TP
\fB\-r\fR
بازیابی وضعیت جزئی از آخرین نقطه بازرسی: کارها و وضعیت DOWN/DRAIN گره‌ها و اطلاعات دلیل آن‌ها\&. هیچ وضعیتی از پارتیشن‌ها بازیابی نمی‌شود\&.
این رفتار پیش‌فرض است\&.
.IP

.TP
\fB\-R\fR
بازیابی وضعیت کامل از آخرین نقطه بازرسی: وضعیت کارها، گره‌ها، پارتیشن‌ها و تنظیمات صرفه‌جویی در مصرف انرژی (power save)\&.
بدون این گزینه، کارهای در حال اجرای قبلی همراه با \fIState\fR گره‌های DOWN، DRAINED و DRAINING و فیلد \fIReason\fR مربوط به آن گره‌ها حفظ خواهند شد\&. هیچ وضعیت دیگری از گره‌ها یا پارتیشن‌ها حفظ نخواهد شد\&.
.IP

.TP
\fB\-s\fR
تغییر دایرکتوری کاری slurmctld به مسیر SlurmctldLogFile در صورت امکان، یا در غیر این صورت به StateSaveLocation در Slurm\&. اگر هر دو ناموفق باشند، به مسیر /var/tmp بازمی‌گردد\&.
.IP

.TP
\fB\-\-systemd\fR
استفاده هنگام راه‌اندازی دیمن با systemd\&. این گزینه به slurmctld اجازه می‌دهد تا هنگام استفاده از 'scontrol reconfigure' مقدار PID جدید را به systemd اطلاع دهد\&.

\fBتوجه\fR: گزینه‌های User و Group در فایل واحد systemd مربوط به slurmctld باید هر دو SlurmUser را مشخص کنند\&.
.IP

.TP
\fB\-v\fR
عملیات پرحرف (verbose)\&. می‌توان چندین \fBv\fR تعیین کرد که هر '\fBv\fR' پس از حرف اول، سطح جزئیات را افزایش می‌دهد، تا حداکثر ۶ بار (یعنی \-vvvvvv)\&.
.IP

.TP
\fB\-V\fR
چاپ اطلاعات نسخه و خروج\&.
.IP

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
متغیرهای محیطی زیر می‌توانند برای لغو تنظیمات کامپایل‌شده در slurmctld استفاده شوند\&.

.TP 20
\fBABORT_ON_FATAL\fR
هنگامی که یک خطای مهلک تشخیص داده می‌شود، به جای exit() از abort() برای خاتمه دادن به فرآیند استفاده شود\&. این امر امکان دریافت backtraceها را بدون نیاز به کامپایل مجدد Slurm فراهم می‌کند\&.
.IP

.TP
\fBSLURM_CONF\fR
مسیر فایل پیکربندی Slurm\&. این مقدار با مشخص کردن صریح فایل پیکربندی در خط فرمان لغو می‌شود\&.
.IP

.TP
\fBSLURM_DEBUG_FLAGS\fR
تعیین فلگ‌های اشکال‌زدایی برای استفاده توسط زمان‌بند (scheduler)\&. برای فهرست کامل فلگ‌ها، DebugFlags را در صفحه راهنمای \fBslurm.conf\fR(5) ببینید\&. مقدار متغیر محیطی بر تنظیم موجود در slurm.conf اولویت دارد\&.
.IP

.SH "کارگزار HTTP (HTTP server)"

مگر اینکه از طریق \fICommunicationParameters=disable_http\fR در \fBslurm.conf\fR غیرفعال شده باشد، \fBslurmctld\fR درخواست‌های ورودی منطبق بر پروتکل HTTP/1.1 را روی هر سوکت گوش‌دهنده‌ای که با \fBSlurmctldPort\fR در \fBslurm.conf\fR پیکربندی شده است می‌پذیرد\&. احراز هویت درخواست‌های HTTP پشتیبانی نمی‌شود\&. پوشش TLS به صورت اختیاری و بدون نیاز به \fBTLSType\fR در \fBslurm.conf\fR پشتیبانی می‌شود\&. در حال حاضر نقاط پایانی (endpoints) زیر پشتیبانی می‌شوند:

.TP
\fBGET /\fR
دریافت فهرست نقاط پایانی\&.
.IP

.TP
\fBGET /healthz\fR
بررسی اینکه آیا \fBslurmctld\fR با موفقیت بارگذاری شده است یا خیر\&.
.IP

.TP
\fBGET /livez\fR
بررسی اینکه آیا \fBslurmctld\fR با موفقیت بارگذاری شده است یا خیر\&.
.IP

.TP
\fBGET /readyz\fR[\fB?verbose\fR]
بررسی اینکه آیا \fBslurmctld\fR آماده پذیرش RPCهای ورودی است یا خیر\&. افزودن پارامتر پرسمان \fBverbose\fR منجر به خروجی با جزئیات کامل برای هر کاوش در پاسخ خواهد شد\&.
.IP

.TP
\fBGET /metrics/jobs\fR
دریافت معیارهای کارها (jobs)\&.
.IP

.TP
\fBGET /metrics/nodes\fR
دریافت معیارهای گره‌ها (nodes)\&.
.IP

.TP
\fBGET /metrics/partitions\fR
دریافت معیارهای پارتیشن‌ها (partitions)\&.
.IP

.TP
\fBGET /metrics/scheduler\fR
بازگرداندن معیارهای زمان‌بند (scheduler)\&.
.IP

.TP
\fBGET /metrics/jobs-users-accts\fR
بازگرداندن معیارهای کارها بر اساس کاربر و حساب کاربری\&.
.IP

.PP
هنگامی که چندین مدخل \fBSlurmctldHost\fR پیکربندی شده باشد، دیمنی که در حالت آماده‌باش (standby) قرار دارد به \fBGET /metrics*\fR با کد وضعیت HTTP 303 "See Other" پاسخ می‌دهد و هدر \fBLocation\fR آن به همان مسیر و پرسمان روی اولین کنترل‌کننده فهرست‌شده اشاره می‌کند\&. اگر چنین آدرسی در دسترس نباشد، پاسخ به جای تغییر مسیر، HTTP 503 "Service Unavailable" خواهد بود\&. به مدخل \fBSlurmctldHost\fR در \fBslurm.conf\fR(5) مراجعه کنید\&.

.SH "محل فایل هسته (CORE FILE LOCATION)"
اگر slurmctld با گزینه \fB\-D\fR راه‌اندازی شود، فایل core در دایرکتوری کاری فعلی نوشته خواهد شد\&.
در غیر این صورت، اگر \fBSlurmctldLogFile\fR یک مسیر کامل باشد (که با اسلش شروع می‌شود)، در صورتی که SlurmUser مجوز نوشتن در آن دایرکتوری را داشته باشد، فایل core در همان دایرکتوری فایل لاگ نوشته خواهد شد\&.
در غیر این صورت، فایل core در \fBStateSaveLocation\fR یا به عنوان آخرین راهکار در "/var/tmp/" نوشته می‌شود\&. اگر هیچ‌یک از دایرکتوری‌های فوق مجوز نوشتن برای SlurmUser نداشته باشند، هیچ فایل core تولید نخواهد شد\&.

.SH "سیگنال‌ها (SIGNALS)"

.TP
\fBSIGTERM SIGINT SIGQUIT\fR
\fBslurmctld\fR به طور تمیز متوقف می‌شود و وضعیت فعلی خود را در دایرکتوری ذخیره وضعیت ذخیره می‌کند\&.
.IP

.TP
\fBSIGABRT\fR
\fBslurmctld\fR به طور تمیز متوقف می‌شود، وضعیت فعلی خود را ذخیره می‌کند و یک core dump انجام می‌دهد\&.
.IP

.TP
\fBSIGHUP\fR
فایل‌های پیکربندی slurm را مجدداً بارگذاری می‌کند، مشابه دستور 'scontrol reconfigure'\&.
.IP

.TP
\fBSIGTSTP\fR
متوقف کردن فرآیند از یک ترمینال\&. این کار همچنین slurmscriptd را متوقف می‌کند\&.
.IP

.TP
\fBSIGUSR2\fR
خواندن مجدد سطح گزارش‌گیری از پیکربندی‌ها و سپس باز کردن مجدد فایل لاگ\&. این سیگنال باید هنگام راه‌اندازی \fBlogrotate\fR(8) استفاده شود\&.
.IP

.TP
\fBSIGPROF\fR
ثبت وضعیت مدیر اتصال در لاگ هنگامی که سطح اشکال‌زدایی حداقل info باشد\&.
.IP

.TP
\fBSIGCHLD SIGUSR1 SIGXCPU SIGPIPE SIGALRM\fR
این سیگنال‌ها صراحتاً نادیده گرفته می‌شوند\&.
.IP

.SH "نکات (NOTES)"
آزمایش پارامترهای پیکربندی خاص \fBslurmctld\fR با استفاده از یک فایل پیکربندی مجزا (مانند زمان‌های انتظار timeout) ممکن است مفید باشد\&. با این حال، این فایل پیکربندی ویژه توسط دیمن \fBslurmd\fR یا برنامه‌های Slurm استفاده نخواهد شد، مگر اینکه به طور صریح به هر یک از آن‌ها اعلام کنید که از آن استفاده کنند\&. اگر تمایل دارید درگاه‌های ارتباطی، مکان فایل‌سیستم موقت یا سایر پارامترهای مورداستفاده سایر مؤلفه‌های Slurm را تغییر دهید، فایل پیکربندی مشترک یعنی \fBslurm.conf\fR را تغییر دهید\&.

.SH "کپی‌رایت (COPYING)"
Copyright (C) 2002\-2007 The Regents of the University of California.
.br
Copyright (C) 2008\-2010 Lawrence Livermore National Security.
.br
Copyright (C) 2010\-2022 SchedMD LLC.
.br
Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
.br
CODE\-OCEC\-09\-009. All rights reserved.
.LP
این فایل بخشی از Slurm است که یک برنامه مدیریت منابع می‌باشد\&.
برای جزئیات بیشتر، به <https://slurm.schedmd.com> مراجعه کنید\&.
.LP
نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) همان‌طور که توسط «بنیاد نرم‌افزارهای آزاد» منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید\&.
.LP
توزیع Slurm به این امید انجام شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف مشخص\&. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید\&.

.SH "همچنین ببینید (SEE ALSO)"
\fBslurm.conf\fR(5), \fBslurmd\fR(8)