نام (NAME)

sprio - مشاهده فاکتورهای تشکیل‌دهنده اولویت زمان‌بندی یک کار

خلاصه دستور (SYNOPSIS)

sprio [OPTIONS...]

توضیحات (DESCRIPTION)

دستور sprio برای مشاهده مؤلفه‌های اولویت زمان‌بندی یک کار در زمان نصب بودن پلاگین اولویت چندعاملی (multi-factor priority) به کار می‌رود. sprio یک ابزار فقط‌خواندنی است که اطلاعات را از پلاگین اولویت چندعاملی استخراج می‌کند. به‌طور پیش‌فرض، sprio اطلاعات مربوط به تمام کارهای در انتظار (pending) را بازمی‌گرداند. گزینه‌هایی برای نمایش کارهای خاص بر اساس شناسه کار (Job ID) و نام کاربری وجود دارد.

گزینه‌ها (OPTIONS)

-M, --clusters=<string>

خوشه‌ای که دستورها باید به آن ارسال شوند. تنها می‌توان یک نام خوشه را مشخص کرد. توجه داشته باشید که برای کارکرد صحیح این گزینه، سرویس slurmdbd باید فعال و در حال اجرا باشد؛ مگر اینکه در یک فدراسیون با پیکربندی FederationParameters=fed_display یا با تنظیم گزینه --federation اجرا شود. این گزینه به‌طور ضمنی گزینه --local را فعال می‌کند.

--federation

در صورت عضویت در یک فدراسیون، کارها را در فدراسیون نمایش می‌دهد.

-o, --format=<output_format>

اطلاعاتی که باید نمایش داده شوند، اندازه و موقعیت آن‌ها (راست‌چین یا چپ‌چین) را مشخص می‌کند. قالب‌های پیش‌فرض زمانی که به تمام فاکتورها وزن‌های غیرصفر تخصیص داده شده باشد عبارتند از:

قالب هر فیلد به صورت "%[.][size]type" است.

مشخصه‌های معتبر برای type عبارتند از:

--help

نمایش یک پیام راهنما که تمام گزینه‌های sprio را شرح می‌دهد.

-j, --jobs=<job_id_list>

درخواست فهرستی از شناسه‌های کار جداشده با کاما برای نمایش. پیش‌فرض، تمام کارها است. کارها را می‌توان با شناسهٔ عددی کار یا با SLUID مشخص کرد.

--local

تنها کارهای محلی این خوشه را نمایش می‌دهد. سایر خوشه‌ها در این فدراسیون (در صورت وجود) نادیده گرفته می‌شوند. بر --federation تقدم دارد.

-l, --long

اطلاعات بیشتری از موارد موجود را برای کارهای انتخاب‌شده گزارش می‌دهد.

-h, --noheader

سرآیند را در خروجی چاپ نمی‌کند.

-n, --norm

عوامل اولویت نرمال‌شده را برای کارهای انتخاب‌شده نمایش می‌دهد.

-p, --partition=<partition_list>

درخواست فهرستی از پارتیشن‌های جداشده با کاما برای نمایش. پیش‌فرض، تمام پارتیشن‌ها است.

--sibling

نمایش تمام کارهای همزاد (sibling) روی یک خوشهٔ فدراسیونی. بدون این گزینه در یک خوشهٔ فدراسیونی، اولویت و مؤلفه‌های آن برای هر کار در هر پارتیشن تنها برای یک خوشه گزارش می‌شود. هر کار همزاد روی خوشه‌های مختلف در فدراسیون ممکن است اولویت‌های متفاوتی داشته باشد که بدون استفاده از این گزینه گزارش نخواهد شد. به‌طور ضمنی "%c" (نام خوشه) را به قالب خروجی اضافه می‌کند.

-S, --sort=<sort_list>

تعیین ترتیبی که کارها باید گزارش شوند. این گزینه از همان مشخصات فیلد <output_format> استفاده می‌کند. مرتب‌سازی‌های چندگانه را می‌توان با درج چندین فیلد مرتب‌سازی جداشده با کاما انجام داد. قبل از مشخصات فیلد می‌توان از "+" یا "-" به‌ترتیب برای صعودی (پیش‌فرض) یا نزولی استفاده کرد. برای مثال، یک <sort_list> به‌صورت "u,r,-y" گزارش‌های اولویت کار را به‌ترتیب بر اساس نام کاربری، نام پارتیشن و اولویت نزولی کار مرتب می‌کند. <sort_list> پیش‌فرض "i" است (شناسهٔ کار به‌صورت صعودی).

--usage

نمایش یک پیام راهنمای مختصر که گزینه‌های sprio را فهرست می‌کند.

-u, --user=<user_list>

درخواست کارها از فهرستی از کاربران که با کاما جدا شده‌اند. این فهرست می‌تواند شامل نام‌های کاربری یا شماره شناسه‌های کاربری باشد.

-v, --verbose

گزارش جزئیات اقدامات sprio.

-V, --version

نمایش اطلاعات نسخه و خروج.

-w, --weights

نمایش وزن‌های پیکربندی‌شده برای هر عامل. این مورد تنها برای مقاصد اطلاع‌رسانی است. داده‌های واقعی کار نمایش داده نمی‌شوند.

اجرای sprio یک فراخوانی رویه از راه دور (RPC) به slurmctld ارسال می‌کند. اگر تعداد فراخوانی‌های هم‌زمان از سوی sprio یا سایر دستورهای کلاینت Slurm که فراخوانی رویه از راه دور به دیمن slurmctld می‌فرستند بیش از حد باشد، می‌تواند به افت کارایی دیمن slurmctld و احتمالاً ایجاد شرایط منع سرویس (denial of service) منجر شود.

از اجرای sprio یا سایر دستورهای کلاینت Slurm که فراخوانی‌های رویه از راه دور به slurmctld ارسال می‌کنند، درون حلقه‌ها در اسکریپت‌های شل یا دیگر برنامه‌ها خودداری کنید. اطمینان حاصل کنید که برنامه‌ها، فراخوانی‌های sprio را به حداقل میزان لازم برای اطلاعاتی که در پی گردآوری آن هستید محدود کنند.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

در صورتی که گزینه متناظری در خط فرمان مشخص نشده باشد، sprio از مقدار متغیرهای محیطی زیر استفاده خواهد کرد.

SLURM_CLUSTERS

همانند --clusters

SLURM_CONF

محل فایل پیکربندی Slurm.

SLURM_DEBUG_FLAGS

پرچم‌های اشکال‌زدایی مورد استفاده sprio را مشخص می‌کند. برای مشاهده فهرست کامل پرچم‌ها، DebugFlags را در صفحه راهنمای slurm.conf(5) ببینید. این متغیر محیطی بر تنظیمات درون slurm.conf ارجحیت دارد.

SPRIO_FEDERATION

همانند --federation

SPRIO_FORMAT

همانند -o <output_format>, --format=<output_format>

SPRIO_LOCAL

همانند --local

SPRIO_SIBLING

همانند --sibling

مثال‌ها (EXAMPLES)

چاپ فهرست تمام کارهای در انتظار همراه با اولویت‌های وزن‌دار آن‌ها

$ sprio
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  65539      62664          0      51664       1000      10000          0
  65540      62663          0      51663       1000      10000          0
  65541      62662          0      51662       1000      10000          0

چاپ فهرست تمام کارهای در انتظار همراه با اولویت‌های نرمال‌سازی‌شده آن‌ها

$ sprio -n
  JOBID PRIORITY   AGE        FAIRSHARE  JOBSIZE    PARTITION  QOS
  65539 0.00001459 0.0007180  0.5166470  1.0000000  1.0000000  0.0000000
  65540 0.00001459 0.0007180  0.5166370  1.0000000  1.0000000  0.0000000
  65541 0.00001458 0.0007180  0.5166270  1.0000000  1.0000000  0.0000000

چاپ اولویت‌ها برای کارهای مشخص

$ sprio --jobs=65548,65547
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  65547      62078          0      51078       1000      10000          0
  65548      62077          0      51077       1000      10000          0

چاپ اولویت‌ها برای کارهای مربوط به کاربران مشخص

$ sprio --users=fred,sally
  JOBID     USER  PRIORITY       AGE  FAIRSHARE   JOBSIZE  PARTITION     QOS
  65548     fred     62079         1      51077      1000      10000       0
  65549    sally     62080         1      51078      1000      10000       0

چاپ وزن‌های پیکربندی‌شده برای هر مؤلفه اولویت

$ sprio -w
  JOBID   PRIORITY        AGE  FAIRSHARE    JOBSIZE  PARTITION        QOS
  Weights                1000     100000       1000      10000          1
کپی‌رایت (C) 2009 Lawrence Livermore National Security.
تولید شده در Lawrence Livermore National Laboratory (ر.ک. DISCLAIMER).
کپی‌رایت (C) 2010-2022 SchedMD LLC.

این فایل بخشی از Slurm، یک برنامه مدیریت منابع، است.
برای جزئیات بیشتر، به <https://slurm.schedmd.com> مراجعه کنید.

نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط پروانه عمومی همگانی گنو (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزار آزاد؛ چه نسخه ۲ پروانه و چه (به انتخاب خودتان) هر نسخهٔ بعدی، بازتوزیع کرده و/یا تغییر دهید.

نرم‌افزار Slurm با این امید که مفید واقع شود توزیع شده است، اما «بدون هرگونه ضمانت»؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر، پروانه عمومی همگانی گنو را مطالعه کنید.

همچنین ببینید (SEE ALSO)

squeue(1), sshare(1)