| sshare(1) | Slurm Commands | sshare(1) |
نام (NAME)
sshare - ابزاری برای فهرست کردن سهم‌های انتساب‌ها در یک کلاستر.
خلاصه دستور (SYNOPSIS)
sshare [OPTIONS...]
توضیحات (DESCRIPTION)
دستور sshare برای مشاهده اطلاعات سهم‌های Slurm استفاده می‌شود. این دستور تنها هنگام اجرا با افزونه priority/multifactor قابل استفاده است. اطلاعات sshare از پایگاه‌داده‌ای به دست می‌آید که رابط آن توسط دیمن slurmdbd (دیمن پایگاه‌داده Slurm) ارائه می‌شود و از طریق slurmctld خوانده شده و برای پردازش سهم‌های دردسترس یک انتساب معین استفاده می‌گردد. دستور sshare اطلاعات سهم‌های Slurm را برای هر انتساب شامل Account، User، Raw Shares، Normalized Shares، Raw Usage، Normalized Usage، Effective Usage، ضریب Fair-share، محدودیت GrpTRESMins، پارتیشن‌ها و دقایق در حال اجرای انباشته‌شده TRES ارائه می‌دهد.
گزینه‌ها (OPTIONS)
- -A, --accounts=<account>
- نمایش اطلاعات برای حساب‌های کاربری مشخص (فهرست جداشده با کاما).
- -a, --all
- نمایش اطلاعات برای همه کاربران.
- -M, --clusters=<string>
- کلاسترهایی که دستورها به آن‌ها ارسال می‌شوند. توجه داشته باشید که برای عملکرد صحیح این گزینه، دیمن slurmdbd باید در حال اجرا باشد، مگر اینکه در یک فدراسیون با پیکربندی FederationParameters=fed_display اجرا شود.
- -o, --format=<output_format>
- فهرست جداشده با کاما از فیلدها (برای مشاهده فهرستی از فیلدهای موجود از "--helpformat" استفاده کنید).
- --help
- نمایش توضیحات گزینه‌ها و دستورهای sshare.
- -l, --long
- فهرست بلند - شامل اطلاعات استفاده نرمال‌شده است.
- --json, --json=list, --json=<data_parser>
- تخلیه اطلاعات در قالب JSON با استفاده از افزونه پیش‌فرض data_parser یا یک data_parser مشخص همراه با پارامترها. آرگومان‌های مرتب‌سازی و قالب‌بندی نادیده گرفته خواهند شد.
- -n, --noheader
- هیچ سرایندی به ابتدای خروجی اضافه نخواهد شد.
- -p, --parsable
- خروجی با نویسه '|' تفکیک شده و یک '|' در انتهای آن قرار می‌گیرد.
- -P, --parsable2
- خروجی با نویسه '|' تفکیک شده و بدون '|' در انتها خواهد بود.
- -m, --partition
- در صورت وجود پارتیشن‌های مبتنی بر انتساب در سیستم، نام آن‌ها چاپ می‌شود.
- --usage
- نمایش توضیحات گزینه‌ها و دستورهای sshare.
- -u, --users=<user_list>
- نمایش اطلاعات برای کاربران مشخص (فهرست جداشده با کاما).
- -U, --Users
- در صورت تعیین این گزینه، تنها اطلاعات کاربران چاپ می‌شود و والد و اجداد نمایش داده نمی‌شوند.
- -v, --verbose
- نمایش اطلاعات بیشتر درباره گزینه‌های مشخص‌شده.
- -V, --version
- نمایش شماره نسخه sshare.
- --yaml, --yaml=list, --yaml=<data_parser>
- تخلیه اطلاعات در قالب YAML با استفاده از افزونه پیش‌فرض data_parser یا یک data_parser مشخص همراه با پارامترها. آرگومان‌های مرتب‌سازی و قالب‌بندی نادیده گرفته خواهند شد.
فیلدهای خروجی SSHARE (SSHARE OUTPUT FIELDS)
- Account
- حساب کاربری.
- User
- کاربر.
- Raw Shares
- سهم‌های خام تخصیص‌یافته به کاربر یا حساب کاربری.
- Norm Shares
- سهم‌های تخصیص‌یافته به کاربر یا حساب کاربری، نرمال‌شده نسبت به کل سهم‌های تخصیص‌یافته.
- Raw Usage
- تعداد ثانیه-tres (یا ثانیه-cpu در صورت عدم تعریف TRESBillingWeights) از کل کارهای شارژشده به حساب یا کاربر. این عدد با تعریف PriorityDecayHalfLife در طول زمان کاهش می‌یابد.
- Norm Usage (تنها با گزینه sshare -l نمایش داده می‌شود)
- مقدار Raw Usage نرمال‌شده نسبت به کل ثانیه-tres تمامی کارهای اجراشده در کلاستر، که در صورت تعریف PriorityDecayHalfLife مشمول کاهش تدریجی می‌شود.
- Effectv Usage
- مقدار Effective Usage استفاده نرمال‌شده را با در نظر گرفتن مصرف حساب‌های هم‌سطح افزایش می‌دهد.
- ضریب سهم عادلانه (Fair-Share)، بر پایه سهم‌های تخصیص‌یافته به کاربر و مصرف موثر کسرشده از آن‌ها.
- GrpTRESMins
- محدودیت دقیقه-TRES تعیین‌شده برای حساب کاربری. کل دقایق پردازنده که احتمالاً می‌تواند توسط کارهای گذشته، حال و آینده اجراشده از این حساب کاربری و زیرمجموعه‌های آن مصرف شود.
- GrpTRESRaw
- میزان خام TRES مصرف‌شده توسط کارهای اجراشده از این حساب کاربری و زیرمجموعه‌های آن.
- TRESRunMins
- تعداد دقیقه-TRES تخصیص‌یافته توسط کارهای در حال اجرای این حساب کاربری. برای محدود کردن مجموع کل دقایق TRES استفاده‌شده توسط تمامی کارهای در حال اجرا در این حساب کاربری و فرزندان آن استفاده می‌شود. این گزینه محدودیت زمانی کارهای در حال اجرا را در نظر گرفته و آن را کسر می‌کند؛ اگر به این محدودیت برسد، تا زمان پایان یافتن کارهای دیگر و آزاد شدن زمان، کار جدیدی شروع نخواهد شد.
تغییرات درخت عادلانه (FAIR_TREE MODIFICATIONS)
هنگامی که PriorityFlags=FAIR_TREE تنظیم شده باشد (حالت پیش‌فرض، مگر اینکه NO_FAIR_TREE تنظیم شده باشد)، محاسبات به صورت متفاوتی انجام می‌شوند. در نتیجه، فیلدهای زیر اضافه یا اصلاح می‌شوند:
- Norm Shares
- سهم‌های تخصیص‌یافته به کاربر یا حساب کاربری، نرمال‌شده نسبت به مجموع سهم‌های تخصیص‌یافته در آن سطح.
- Effectv Usage
- مقدار Effectv Usage همان میزان استفاده انتساب است که با والد خود نرمال شده است.
- Level FS (تنها با گزینه sshare -l نمایش داده می‌شود)
- این مقدار سهم عادلانه انتساب در مقایسه با هم‌سطح‌های آن است که به‌صورت Norm Shares / Effectv Usage محاسبه می‌شود. اگر به یک انتساب بیش‌ازحد خدمت‌رسانی شده باشد، این مقدار بین ۰ و ۱ خواهد بود. اگر به یک انتساب کمتر از حد خدمت‌رسانی شده باشد، مقدار بزرگتر از ۱ است. انتساب‌های بدون مصرف، بالاترین مقدار ممکن یعنی بی‌نهایت را دریافت می‌کنند.
اطلاعات بیشتر درباره Fair Tree را می‌توان در doc/html/fair_tree.html یا در نشانی https://slurm.schedmd.com/fair_tree.html یافت.
کارایی (PERFORMANCE)
اجرای sshare یک فراخوانی رویه از راه دور (RPC) به slurmctld ارسال می‌کند. اگر فراخوانی‌های زیادی به طور همزمان از سوی sshare یا سایر دستورات کلاینت Slurm که به دیمن slurmctld درخواست می‌فرستند دریافت شود، ممکن است به افت کارایی دیمن slurmctld و احتمالاً به منع سرویس (denial of service) منجر گردد.
از اجرای sshare یا سایر دستورات کلاینت Slurm که درخواست‌های RPC به slurmctld ارسال می‌کنند درون حلقه‌های اسکریپت‌های شل یا سایر برنامه‌ها خودداری کنید. اطمینان حاصل کنید که برنامه‌ها فراخوانی‌های sshare را به حداقل مقدار لازم برای جمع‌آوری اطلاعات مورد نظر محدود کنند.
متغیرهای محیطی (ENVIRONMENT VARIABLES)
برخی از گزینه‌های sshare را می‌توان از طریق متغیرهای محیطی تنظیم کرد. این متغیرهای محیطی به همراه گزینه‌های مربوط به آن‌ها در زیر فهرست شده‌اند. (توجه: گزینه‌های خط فرمان همواره بر این تنظیمات اولویت خواهند داشت.)
- SLURM_CONF
- مسیر فایل پیکربندی Slurm.
- SLURM_DEBUG_FLAGS
- مشخص کردن فلگ‌های اشکال‌زدایی برای استفاده sshare. برای مشاهده فهرست کامل فلگ‌ها، به بخش DebugFlags در صفحه راهنمای slurm.conf(5) مراجعه کنید. این متغیر محیطی بر تنظیمات موجود در slurm.conf اولویت دارد.
- SLURM_JSON
- کنترل سریال‌سازی JSON:
- SLURM_YAML
- کنترل سریال‌سازی YAML:
مثال‌ها (EXAMPLES)
- نمایش اطلاعات کاربران در یک حساب کاربری مشخص:
-
$ sshare -A <Account>
- نمایش اطلاعات یک کاربر مشخص در قالبی قابل تجزیه:
-
$ sshare --parsable --users=<User>
کپی‌رایت و تکثیر (COPYING)
Copyright (C) 2008 Lawrence Livermore National Security. Produced
at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
Copyright (C) 2010-2022 SchedMD LLC.
این فایل بخشی از Slurm است، یک برنامه مدیریت منابع. برای جزئیات بیشتر به https://slurm.schedmd.com مراجعه کنید.
نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید.
نرم‌افزار Slurm به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
همچنین ببینید (SEE ALSO)
| Slurm Commands | Slurm 26.05 |