'\"macro stdmacro
.\"
.\" Copyright (c) 2011 SGI.  All Rights Reserved.
.\" Copyright (c) 2020 Red Hat.  All Rights Reserved.
.\"
.\" 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 PMDALUSTRE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdalustre\f1 \- عامل دامنه معیارهای کارایی (PMDA) برای آمار سامانه فایل lustre
.SH "توضیحات (DESCRIPTION)"
\f3pmdalustre\f1 یک عامل دامنه معیارهای کارایی (\s-1PMDA\s0) است که
مقادیر معیارها را از رابط‌های آماری یک سامانه فایل Lustre خوانده و صادر می‌کند.
.PP
دستور
.B pmdalustre
رابط‌های آماری را از چندین مکان جستجو می‌کند که بسته به نسخه
.B Lustre
نصب‌شده به صورت محلی متفاوت است.
.PP
نسخه‌های اخیر
.B Lustre
(نسخه v2.12 و جدیدتر) آمار را از شبه سامانه فایل
.B debugfs
هسته در دایرکتوری‌های
.B /sys/kernel/debug/lustre/llite
و
.BR /sys/kernel/debug/lnet
صادر می‌کنند.
اگر این رابط‌ها هنگام راه‌اندازی یافت نشوند،
.B pmdalustre
به‌طور خودکار بررسی می‌کند که آیا رابط‌های آماری از طریق شبه سامانه فایل
.B procfs
زیر دایرکتوری‌های
.B /proc/fs/lustre/llite
و
.B /proc/sys/lnet
در دسترس هستند یا خیر.
این‌ها مکان‌های پیش‌فرض آمار برای نسخه‌هایی از
.B Lustre
هستند که پایین‌تر از
.BR v2.12
می‌باشند.
.PP
اگر هیچ‌یک از رابط‌های سامانه‌های فایل بالا یافت نشوند،
یا اگر کاربر بخواهد مکان‌های پیش‌فرض را بازنویسی کند،
.B pmdalustre
از یک فایل پیکربندی اختیاری با نام
.BR $PCP_PMDAS_DIR/lustre/lustre.conf
نیز پشتیبانی می‌کند.
توجه داشته باشید که در بیشتر سامانه‌های مبتنی بر لینوکس،
.B $PCP_PMDAS_DIR
روی
.B /var/lib/pcp/pmdas
تنظیم شده است.
این فایل پیکربندی از نحو تخصیص متغیرهای
.BR perl (1)
پشتیبانی می‌کند.
یک نمونه فایل پیکربندی مناسب برای
.B Lustre
نسخه v2.12 و بالاتر بدین صورت است:
.in 2i
.nf

.B $LLITE_PATH="/sys/kernel/debug/lustre/llite/";
.B $LNET_PATH="/sys/kernel/debug/lustre/lnet/";

.fi
.in
برای جزئیات بیشتر به توضیحات درون فایل ارائه‌شدهٔ
.B lustre.conf
مراجعه کنید.
به‌طور پیش‌فرض، این فایل با تمام خطوط کامنت‌شده نصب می‌شود
(و بنابراین هیچ تأثیری ندارد مگر اینکه ویرایش شود)، چرا که روش‌های مکاشفه‌ای داخلی مورد استفاده توسط
.B pmdalustre
باید کافی باشند.
.PP
در نهایت، با اولویت بر تمام موارد فوق، متغیرهای محیطی
.B LUSTRE_LLITE_PATH
و
.B LUSTRE_LNET_PATH
می‌توانند تنظیم (و export) شوند تا مکان دایرکتوری رابط‌های آماری مورد استفاده را مشخص کنند.
این سازوکارِ استفاده از متغیرهای محیطی، صرفاً برای اهداف توسعه و آزمایش طراحی شده است.
.PP
فرایند
.B pmdalustre
با دسترسی کاربر ریشه (root) اجرا می‌شود، زیرا دایرکتوری‌های
.B debugfs
به‌طور معمول توسط کاربران غیرممتاز قابل خواندن نیستند.
.SH "نصب (INSTALLATION)"
با استفاده از اسکریپت
.B Install
به عنوان کاربر ریشه،
.B pmdalustre
را نصب کنید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/lustre
# ./Install
.in
.fi
.ft 1
.PP
اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را به عنوان ریشه اجرا نمایید:
.PP
.ft CR
.nf
.in +0.5i
# cd $PCP_PMDAS_DIR/lustre
# ./Remove
.in
.fi
.ft 1
.PP
\fBpmdalustre\fR توسط \fIpmcd\fR(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً
اجرا گردد. اسکریپت‌های Install و Remove به هنگام نصب یا حذف عامل، به \fIpmcd\fR(1)
اطلاع‌رسانی می‌کنند.
.SH "فایل‌ها (FILES)"
.IP "\fB$PCP_PMDAS_DIR/lustre/Install\fR" 4
اسکریپت نصب برای عامل \fBpmdalustre\fR
.IP "\fB$PCP_PMDAS_DIR/lustre/Remove\fR" 4
اسکریپت لغو نصب برای عامل \fBpmdalustre\fR
.IP "\fB$PCP_LOG_DIR/pmcd/lustre.log\fR" 4
فایل ثبت رخداد پیش‌فرض برای پیام‌های خطای \fBpmdalustre\fR
.IP "\fB$PCP_PMDAS_DIR/lustre/lustre.conf\fR" 4
فایل پیکربندی برای بازنویسی دایرکتوری‌های پیش‌فرض آمار مورد استفاده توسط \fBpmdalustre\fP.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fR برای پارامتربندی نام‌های فایل و دایرکتوری مورد استفاده در \fBPCP\fR به کار می‌روند. در هر نصب، فایل \fB/etc/pcp.conf\fR حاوی مقادیر محلی برای این متغیرها است. متغیر \fB$PCP_CONF\fR می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fIpcp.conf\fR(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR perl (1)،
.BR pmcd (1)
و
.BR llstat (1).

.\" control lines for scripts/man-spell
.\" +ok+ LUSTRE_LLITE_PATH LUSTRE_LNET_PATH LLITE_PATH pmdalustre LNET_PATH
.\" +ok+ debugfs llstat procfs perl
.\" +ok+ sys llite {both from /sys/kernel/debug/lustre/llite}
.\" +ok+ lnet {from /sys/kernel/debug/lnet}
.\" +ok+ fs {from /proc/fs/lustre/llite}