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= نمایش اطلاعات برای حساب‌های کاربری مشخص (فهرست جداشده با کاما). -a, --all نمایش اطلاعات برای همه کاربران. -M, --clusters= کلاسترهایی که دستورها به آن‌ها ارسال می‌شوند. توجه داشته باشید که برای عملکرد صحیح این گزینه، دیمن slurmdbd باید در حال اجرا باشد، مگر اینکه در یک فدراسیون با پیکربندی FederationParameters=fed_display اجرا شود. -o, --format= فهرست جداشده با کاما از فیلدها (برای مشاهده فهرستی از فیلدهای موجود از "--helpformat" استفاده کنید). --help نمایش توضیحات گزینه‌ها و دستورهای sshare. -l, --long فهرست بلند - شامل اطلاعات استفاده نرمال‌شده است. --json, --json=list, --json= تخلیه اطلاعات در قالب JSON با استفاده از افزونه پیش‌فرض data_parser یا یک data_parser مشخص همراه با پارامترها. آرگومان‌های مرتب‌سازی و قالب‌بندی نادیده گرفته خواهند شد. -n, --noheader هیچ سرایندی به ابتدای خروجی اضافه نخواهد شد. -p, --parsable خروجی با نویسه '|' تفکیک شده و یک '|' در انتهای آن قرار می‌گیرد. -P, --parsable2 خروجی با نویسه '|' تفکیک شده و بدون '|' در انتها خواهد بود. -m, --partition در صورت وجود پارتیشن‌های مبتنی بر انتساب در سیستم، نام آن‌ها چاپ می‌شود. --usage نمایش توضیحات گزینه‌ها و دستورهای sshare. -u, --users= نمایش اطلاعات برای کاربران مشخص (فهرست جداشده با کاما). -U, --Users در صورت تعیین این گزینه، تنها اطلاعات کاربران چاپ می‌شود و والد و اجداد نمایش داده نمی‌شوند. -v, --verbose نمایش اطلاعات بیشتر درباره گزینه‌های مشخص‌شده. -V, --version نمایش شماره نسخه sshare. --yaml, --yaml=list, --yaml= تخلیه اطلاعات در قالب 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 استفاده نرمال‌شده را با در نظر گرفتن مصرف حساب‌های هم‌سطح افزایش می‌دهد. FairShare ضریب سهم عادلانه (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: compact خروجی JSON تا حد ممکن فشرده باشد. pretty خروجی JSON در قالب زیبا و خوانا باشد. SLURM_YAML کنترل سریال‌سازی YAML: compact خروجی YAML تا حد ممکن فشرده باشد. pretty خروجی YAML در قالب زیبا و خوانا باشد. مثال‌ها (EXAMPLES) نمایش اطلاعات کاربران در یک حساب کاربری مشخص: $ sshare -A نمایش اطلاعات یک کاربر مشخص در قالبی قابل تجزیه: $ sshare --parsable --users= کپی‌رایت و تکثیر (COPYING) Copyright (C) 2008 Lawrence Livermore National Security. Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER). Copyright (C) 2010-2022 SchedMD LLC. این فایل بخشی از Slurm است، یک برنامه مدیریت منابع. برای جزئیات بیشتر به مراجعه کنید. نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز و چه (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید. نرم‌افزار Slurm به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید. همچنین ببینید (SEE ALSO) slurm.conf(5), slurmdbd(8) Slurm 26.05 Slurm Commands sshare(1)