.TH sh5util "1" "Slurm Commands" "Slurm 26.05" "Slurm Commands"

.SH "نام (NAME)"
.LP
sh5util \- ابزاری برای ادغام فایل‌های HDF5 افزایهٔ acct_gather_profile جهت گردآوری داده‌های تفصیلی کارهای Slurm

.SH "خلاصه دستور (SYNOPSIS)"
.LP
sh5util

.SH "توضیحات (DESCRIPTION)"
.LP
دستور \fBsh5util\fR فایل‌های HDF5 تولیدشده در هر گره را برای هر گام از یک کار ادغام کرده و به یک فایل واحد HDF5 برای آن کار تبدیل می‌کند. فایل حاصل را می‌توان با ابزارهای متداول HDF5 مانند HDF5View، h5dump، h5edit یا h5ls مشاهده و دستکاری کرد.
.LP
همچنین \fBsh5util\fR دارای دو حالت استخراج است. در حالت نخست، مجموعه محدودی از داده‌ها را برای گره‌ها، گام‌ها و سری‌های دادهٔ مشخص در قالب «مقادیر جداشده با کاما» (CSV) در فایلی می‌نویسد که می‌تواند به سایر ابزارهای تحلیلی مانند صفحات گسترده وارد شود.
.LP
حالت دوم، (Item\-Extract) یک قلم داده را از یک سری زمانی برای تمام نمونه‌های همه گره‌ها از نمایهٔ HDF5 یک کار استخراج می‌کند.
.LP
\- نمونه‌ای با بیشترین مقدار آن قلم را می‌یابد.
.LP
\- یک فایل CSV حاوی مقادیر کمینه (min)، میانگین (ave)، بیشینه (max) و مجموع مقادیر قلم را برای هر گره و به ازای هر نمونه می‌نویسد.


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

.TP
\fB\-E\fR, \fB\-\-extract\fR

استخراج سری داده از فایل ادغام‌شدهٔ کار.
.IP
.RS
.TP 10
گزینه‌های حالت استخراج (Extract):
.IP

.TP
\fB\-i\fR, \fB\-\-input\fR=\fIpath\fR
فایل ادغام‌شده برای استخراج از آن (پیش‌فرض ./job_$jobid.h5)
.IP

.TP
\fB\-N\fR, \fB\-\-node\fR=\fInodename\fR
نام گره برای استخراج (پیش‌فرض همه است)
.IP

.TP
\fB\-l\fR, \fB\-\-level\fR=[Node:Totals | Node:TimeSeries]
سطحی که سری به آن متصل است (پیش‌فرض Node:Totals)
.IP

.TP
\fB\-s\fR, \fB\-\-series\fR=[Energy | Filesystem | Network | Task | Task_#]
مقدار \fBTask\fR بیانگر تمام وظایف و \fBTask_#\fR (# شناسهٔ وظیفه است) می‌باشد (پیش‌فرض همه‌چیز است)
.RE
.IP

.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ این توضیحات راهنمای استفاده.
.IP

.TP
\fB\-I\fR, \fB\-\-item\-extract\fR

استخراج یک قلم داده از تمام نمونه‌های یک سری داده از همه گره‌ها در یک فایل ادغام‌شدهٔ کار.
.IP
.RS
.TP 10
گزینه‌های حالت استخراج قلم (Item\-Extract):
.IP

.TP
\fB\-s\fR, \fB\-\-series\fR=[Energy | Filesystem | Network | Task]\fR
.IP

.TP
\fB\-d\fR, \fB\-\-data\fR
نام قلم داده در سری (یادداشت زیر را ببینید).
.RE
.IP

.TP
\fB\-j\fR, \fB\-\-jobs\fR=<\fIjob\fR[.\fIstep\fR]>
قالب به صورت <\fIjob\fR[.\fIstep\fR]> است. ادغام این کار/گام (یا فهرستی از گام‌های کار جدا شده با کاما). این گزینه الزامی است. عدم تعیین گام منجر به پردازش تمام گام‌های یافت‌شده خواهد شد.

شناسه‌های وظایف آرایه‌ای و شناسه‌های مؤلفه‌های ناهمگن (het) پشتیبانی نمی‌شوند. در عوض از شناسه‌های معمولی کار استفاده کنید:
.IP
.nf
$ sacct -X -j 5077 --format=JobId,JobIdRaw
JobID        JobIDRaw
------------ ------------
5077_1       5078
5077_2       5079
5077_3       5077

$ sh5util -S -j 5079 # for merging 5077_2 only
sh5util: Merging node-step files into ./job_5079.h5
.fi

.IP

.TP
\fB\-L\fR, \fB\-\-list\fR

چاپ اقلام یک سری موجود در فایل کار.
.IP
.RS
.TP 10
گزینه‌های حالت فهرست (List):
.IP

.TP
\fB\-i\fR, \fB\-\-input\fR=\fIpath\fR
فایل ادغام‌شده برای استخراج از آن (پیش‌فرض ./job_$jobid.h5)
.IP

.TP
\fB\-s\fR, \fB\-\-series\fR=[Energy | Filesystem | Network | Task]
.RE
.IP

.TP
\fB\-o\fR, \fB\-\-output\fR=<\fIpath\fR>
مسیر فایلی که باید در آن نوشته شود.
پیش‌فرض برای ادغام ./job_$jobid.h5 است
پیش‌فرض برای استخراج ./extract_$jobid.csv است
.IP

.TP
\fB\-p\fR, \fB\-\-profiledir\fR=<\fIdir\fR>
مکان دایرکتوری که فایل‌های گره\-گام در آن قرار دارند؛ مقدار پیش‌فرض در acct_gather.conf تعیین می‌شود.
.IP

.TP
\fB\-S\fR, \fB\-\-savefiles\fR
به جای حذف فایل‌های گره\-گام پس از ادغام آن‌ها در فایل کار، آن‌ها را نگه می‌دارد.
.IP

.TP
\fB\-\-usage\fR
نمایش پیام کوتاه نحوه استفاده.
.IP

.TP
\fB\-\-user\fR=<\fIuser\fR>
کاربری که کار را پروفایل‌سازی کرده است.
(برای کاربر root مناسب است؛ پیش‌فرض کاربری است که این دستور را اجرا می‌کند.)
.IP

.SH "اقلام داده در هر سری (Data Items per Series)"

.TP
\fBEnergy\fR
.RS
Power
.br
CPU_Frequency
.RE
.IP

.TP
\fBFilesystem\fR
.RS
Reads
.br
Megabytes_Read
.br
Writes
.br
Megabytes_Write
.RE
.IP

.TP
\fBNetwork\fR
.RS
Packets_In
.br
Megabytes_In
.br
Packets_Out
.br
Megabytes_Out
.RE
.IP

.TP
\fBTask\fR
.RS
CPU_Frequency
.br
CPU_Time
.br
CPU_Utilization
.br
RSS
.br
VM_Size
.br
Pages
.br
Read_Megabytes
.br
Write_Megabytes
.RE
.IP

.SH "کارایی (PERFORMANCE)"
.PP
اجرای \fBsh5util\fR یک فراخوانی رویه از راه دور (RPC) به \fBslurmctld\fR ارسال می‌کند. اگر فراخوانی‌های زیادی از سوی \fBsh5util\fR یا سایر دستورات کلاینت Slurm که RPC به دیمن \fBslurmctld\fR ارسال می‌کنند به طور هم‌زمان دریافت شود، می‌تواند منجر به کاهش کارایی دیمن \fBslurmctld\fR و احتمالاً ایجاد وضعیت منع سرویس (DoS) گردد.
.PP
دستور \fBsh5util\fR یا سایر دستورات کلاینت Slurm را که فراخوانی رویه از راه دور به \fBslurmctld\fR ارسال می‌کنند، از درون حلقه‌ها در اسکریپت‌های شل یا برنامه‌های دیگر اجرا نکنید. اطمینان حاصل کنید که برنامه‌ها فراخوانی‌های \fBsh5util\fR را به حداقل میزان لازم برای داده‌های مورد نظر محدود می‌سازند.

.SH "مثال‌ها (EXAMPLES)"

.TP
ادغام فایل‌های گره\-گام (به عنوان بخشی از یک اسکریپت sbatch):
.IP
.nf
$ sbatch \-n1 \-d$SLURM_JOB_ID \-\-wrap="sh5util \-\-savefiles \-j $SLURM_JOB_ID"
.fi

.TP
استخراج تمام داده‌های وظیفه از یک گره:
.IP
.nf
$ sh5util \-j 42 \-N snowflake01 \-\-level=Node:TimeSeries \-\-series=Tasks
.fi

.TP
استخراج تمام داده‌های انرژی:
.IP
.nf
$ sh5util \-j 42 \-\-series=Energy \-\-data=power
.fi

.SH "کپی‌رایت و تکثیر (COPYING)"
Copyright (C) 2013 Bull.
.br
Copyright (C) 2013\-2022 SchedMD LLC.
.LP
نرم‌افزار Slurm یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.
.LP
نرم‌افزار Slurm به این امید که مفید واقع شود توزیع شده است، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به GNU General Public License مراجعه کنید.

.SH "همچنین ببینید (SEE ALSO)"
.LP
\fBsreport\fR(1), \fBsacct\fR(1), \fBsbatch\fR(1), \fBacct_gather.conf\fR(5), \fBslurm.conf\fR(5)