'\"macro stdmacro
.\"
.\" Copyright (c) 2014 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH PMDALUSTERCOMM 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdalustrecomm\f1 \- عامل دامنه معیارهای کارایی ارتباطات سامانه فایل Lustre (PMDA)
.SH "خلاصه دستور (SYNOPSIS)"
\f3$PCP_PMDAS_DIR/lustrecomm/pmdalustrecomm\f1
[\f3\-D\f1 \f2debug\f1]
[\f3\-d\f1 \f2domain\f1]
[\f3\-l\f1 \f2logfile\f1]
[\f3\-U\f1 \f2username\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmdalustrecomm
یک «عامل دامنه معیارهای کارایی» (PMDA) است که معیارهای کارایی مربوط به وضعیت جنبه‌های گوناگون سامانه فایل Lustre را از سامانه فایل procfs لینوکس استخراج می‌کند.
.PP
عامل
.B lustrecomm
معیارهایی را صادر می‌کند که بر ارتباطات توزیع‌شده در سامانه فایل متمرکز هستند، از جمله معیارهای مربوط به اتمام مهلت زمانی (timeout)، بسته‌های ساقط‌شده شبکه (network drops)، اطلاعات ارسال/دریافت و طول مسیرها. با این حال، مصرف حافظه برخی از مؤلفه‌های سامانه فایل Lustre را نیز پوشش می‌دهد.
.PP
توضیح مختصری از گزینه‌های خط فرمان
.B pmdalustrecomm
در ادامه آمده است:
.TP 5
.B \-d
بسیار حیاتی است که شماره دامنه
.RI ( domain )
معیارهای کارایی که در اینجا مشخص می‌شود، یکتا و سازگار باشد.
به این معنی که
.I domain
باید برای هر PMDA روی یک میزبان متفاوت باشد، و همان شماره
.I domain
باید برای همان PMDA روی تمام میزبان‌ها استفاده شود.
.TP
.B \-l
محل فایل ثبت وقایع (log). به‌طور پیش‌فرض، یک فایل ثبت وقایع به نام
.I lustrecomm.log
در دایرکتوری جاری
.BR pmcd (1)
هنگامی که
.B pmdalustrecomm
راه‌اندازی می‌شود، یعنی در
.BR $PCP_LOG_DIR/pmcd
نوشته می‌شود. اگر فایل ثبت وقایع نتواند ایجاد شود یا قابل نوشتن نباشد، خروجی به‌جای آن در خطای استاندارد (stderr) نوشته می‌شود.
.TP
.B \-U
حساب کاربری که عامل تحت آن اجرا می‌شود.
پیش‌فرض در نسخه‌های کنونی PCP، حساب کاربری غیرممتاز «pcp» است،
اما در نسخه‌های قدیمی‌تر، حساب کاربری ریشه («root») به‌طور پیش‌فرض استفاده می‌شد.
.SH "نصب (INSTALLATION)"
اگر می‌خواهید به نام‌ها، متن راهنما و مقادیر معیارهای کارایی lustrecomm دسترسی داشته باشید، مراحل زیر را با دسترسی ریشه (root) انجام دهید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/lustrecomm
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را با دسترسی ریشه (root) اجرا کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/lustrecomm
# ./Remove
.in
.fi
.ft 1
.PP
دستور
.B pmdalustrecomm
توسط
.BR pmcd (1)
راه‌اندازی می‌شود و هرگز نباید به‌طور مستقیم اجرا گردد.
اسکریپت‌های Install و Remove به هنگام نصب یا حذف عامل، به
.BR pmcd (1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.B $PCP_PMCDCONF_PATH
گزینه‌های خط فرمان مورد استفاده برای راه‌اندازی
.B pmdalustrecomm
.TP 10
.B $PCP_PMDAS_DIR/lustrecomm/help
فایل متن راهنمای پیش‌فرض برای معیارهای lustrecomm
.TP 10
.B $PCP_PMDAS_DIR/lustrecomm/Install
اسکریپت نصب برای عامل
.B pmdalustrecomm
.TP 10
.B $PCP_PMDAS_DIR/lustrecomm/Remove
اسکریپت لغو نصب برای عامل
.B pmdalustrecomm
.TP 10
.B $PCP_LOG_DIR/pmcd/lustrecomm.log
فایل ثبت وقایع پیش‌فرض برای پیام‌های خطا و سایر اطلاعات از سوی
.B pmdalustrecomm
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
شامل مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
ممکن است برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در
.BR pcp.conf (5)
توضیح داده شده است.
.SH "گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)"
گزینه
.B \-D
یا
.B \-\-debug
خروجی عیب‌یابی تکمیلی را در
.I stderr
برای کمک به دسته‌بندی و رفع مشکلات فعال می‌کند، اگرچه این اطلاعات گاهی مبهم است و در درجه اول به‌جای کاربران نهایی، برای راهنمایی توسعه‌دهندگان طراحی شده است.
مقدار
.I debug
فهرستی از گزینه‌های اشکال‌زدایی است که با کاما از هم جدا شده‌اند؛ از
.BR pmdbg (1)
به همراه گزینه
.B \-l
برای دریافت فهرستی از گزینه‌های اشکال‌زدایی موجود و معانی آن‌ها استفاده کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pmcd (1)،
.BR pcp.conf (5)
و
.BR pcp.env (5).

.\" control lines for scripts/man-spell
.\" +ok+ pmdalustrecomm lustrecomm procfs comms