نام (NAME)

pmdalustre - عامل دامنه معیارهای کارایی (PMDA) برای آمار سامانه فایل lustre

توضیحات (DESCRIPTION)

pmdalustre یک عامل دامنه معیارهای کارایی (PMDA) است که مقادیر معیارها را از رابط‌های آماری یک سامانه فایل Lustre خوانده و صادر می‌کند.

دستور pmdalustre رابط‌های آماری را از چندین مکان جستجو می‌کند که بسته به نسخه Lustre نصب‌شده به صورت محلی متفاوت است.

نسخه‌های اخیر Lustre (نسخه v2.12 و جدیدتر) آمار را از شبه سامانه فایل debugfs هسته در دایرکتوری‌های /sys/kernel/debug/lustre/llite و /sys/kernel/debug/lnet صادر می‌کنند. اگر این رابط‌ها هنگام راه‌اندازی یافت نشوند، pmdalustre به‌طور خودکار بررسی می‌کند که آیا رابط‌های آماری از طریق شبه سامانه فایل procfs زیر دایرکتوری‌های /proc/fs/lustre/llite و /proc/sys/lnet در دسترس هستند یا خیر. این‌ها مکان‌های پیش‌فرض آمار برای نسخه‌هایی از Lustre هستند که پایین‌تر از v2.12 می‌باشند.

اگر هیچ‌یک از رابط‌های سامانه‌های فایل بالا یافت نشوند، یا اگر کاربر بخواهد مکان‌های پیش‌فرض را بازنویسی کند، pmdalustre از یک فایل پیکربندی اختیاری با نام $PCP_PMDAS_DIR/lustre/lustre.conf نیز پشتیبانی می‌کند. توجه داشته باشید که در بیشتر سامانه‌های مبتنی بر لینوکس، $PCP_PMDAS_DIR روی /var/lib/pcp/pmdas تنظیم شده است. این فایل پیکربندی از نحو تخصیص متغیرهای perl(1) پشتیبانی می‌کند. یک نمونه فایل پیکربندی مناسب برای Lustre نسخه v2.12 و بالاتر بدین صورت است:

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

در نهایت، با اولویت بر تمام موارد فوق، متغیرهای محیطی LUSTRE_LLITE_PATH و LUSTRE_LNET_PATH می‌توانند تنظیم (و export) شوند تا مکان دایرکتوری رابط‌های آماری مورد استفاده را مشخص کنند. این سازوکارِ استفاده از متغیرهای محیطی، صرفاً برای اهداف توسعه و آزمایش طراحی شده است.

فرایند pmdalustre با دسترسی کاربر ریشه (root) اجرا می‌شود، زیرا دایرکتوری‌های debugfs به‌طور معمول توسط کاربران غیرممتاز قابل خواندن نیستند.

نصب (INSTALLATION)

با استفاده از اسکریپت Install به عنوان کاربر ریشه، pmdalustre را نصب کنید:

# cd $PCP_PMDAS_DIR/lustre
# ./Install

اگر می‌خواهید نصب را لغو کنید، دستورهای زیر را به عنوان ریشه اجرا نمایید:

# cd $PCP_PMDAS_DIR/lustre
# ./Remove

pmdalustre توسط pmcd(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد. اسکریپت‌های Install و Remove به هنگام نصب یا حذف عامل، به pmcd(1) اطلاع‌رسانی می‌کنند.

فایل‌ها (FILES)

$PCP_PMDAS_DIR/lustre/Install

اسکریپت نصب برای عامل pmdalustre

$PCP_PMDAS_DIR/lustre/Remove

اسکریپت لغو نصب برای عامل pmdalustre

$PCP_LOG_DIR/pmcd/lustre.log

فایل ثبت رخداد پیش‌فرض برای پیام‌های خطای pmdalustre

$PCP_PMDAS_DIR/lustre/lustre.conf

فایل پیکربندی برای بازنویسی دایرکتوری‌های پیش‌فرض آمار مورد استفاده توسط pmdalustre.

محیط PCP (PCP ENVIRONMENT)

متغیرهای محیطی با پیشوند PCP_ برای پارامتربندی نام‌های فایل و دایرکتوری مورد استفاده در PCP به کار می‌روند. در هر نصب، فایل /etc/pcp.conf حاوی مقادیر محلی برای این متغیرها است. متغیر $PCP_CONF می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در pcp.conf(5) شرح داده شده است.

همچنین ببینید (SEE ALSO)

PCPIntro(1)، perl(1)، pmcd(1) و llstat(1).