'\"macro stdmacro
.\"
.\" Copyright (c) 2021 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 PMDAMONGODB 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdamongodb \- معیارهای پایگاه داده MongoDB
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBpmdamongodb\fP یک «عامل دامنه معیارهای کارایی» (PMDA) برای سامانهٔ Performance Co-Pilot (PCP) است که داده‌های زندهٔ کارایی را از یک سرور پایگاه داده در حال اجرای MongoDB استخراج می‌کند.
.SH "پیکربندی (CONFIGURATION)"
در ابتدا، \f3pmdamongodb\f1 نیازمند نصب بسته‌های پشتیبانی
.B pymongo
است \- یک ماژول چندمنظورهٔ Python برای پرس‌وجو از MongoDB.
.PP
سپس، \fBpmdamongodb\fP یک فایل پیکربندی اختیاری با ساختار ini را می‌خواند:
.IP
.PD 0
.IP
.I \f(CR$PCP_PMDAS_DIR\fP/mongodb/mongodb.conf
.PD
.PP
این فایل در حال حاضر امکان استفاده از دو بخش را فراهم می‌کند: یکی برای پیکربندی اتصال سوکت MongoDB، و دیگری برای احراز هویت.
.PP
.B [connection]
.TP 15
.B host \fR(\fP\fIlocalhost\fP\fR)\fP
اتصال به سوکت MongoDB روی نام میزبان مشخص‌شده.
.TP
.B port \fR(\fP\fI27017\fP\fR)\fP
اتصال به سوکت MongoDB روی درگاه مشخص‌شده.
.PP
.B [authentication]
.TP 15
.B username \fR(\fP\fIخالی\fP\fR)\fP
نام کاربری جهت اتصال به پایگاه داده.
.TP
.B password \fR(\fP\fIخالی\fP\fR)\fP
گذرواژه جهت اتصال به پایگاه داده.
.PD
.SH "نصب (INSTALLATION)"
جهت نصب، دستورات زیر باید با دسترسی ریشه (root) اجرا شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/mongodb
# ./Install
.fi
.ft P
.RE
.sp 1
جهت لغو نصب، دستورات زیر باید با دسترسی ریشه (root) اجرا شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/mongodb
# ./Remove
.fi
.ft P
.RE
.sp 1
عامل \fBpmdamongodb\fP توسط \fBpmcd\fP(1) راه‌اندازی می‌شود و هرگز نباید به‌صورت مستقیم اجرا گردد.
اسکریپت‌های \fBInstall\fP و \fBRemove\fP هنگام نصب یا حذف عامل، به \fBpmcd\fP(1) اطلاع می‌دهند.
.SH "فایل‌ها (FILES)"
.TP 5
.I \f(CR$PCP_PMDAS_DIR\fP/mongodb/mongodb.conf
فایل پیکربندی برای عامل \fBpmdamongodb\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/mongodb/Install
اسکریپت نصب برای عامل \fBpmdamongodb\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/mongodb/Remove
اسکریپت لغو نصب برای عامل \fBpmdamongodb\fR
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/mongodb.log
فایل گزارش (log) پیش‌فرض برای پیام‌های دریافتی از عامل \fBpmdamongodb\fR
.PP
توجه داشته باشید که مقدار معمول/پیش‌فرض برای \fB$PCP_PMDAS_DIR\fP برابر با
.B /var/lib/pcp/pmdas
و مقدار پیش‌فرض برای \fB$PCP_LOG_DIR\fP برابر با
.B /var/log/pcp
است، اما این تنظیمات وابسته به پلتفرم سیستم‌عامل هستند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fR برای پارامتریک کردن نام فایل‌ها و دایرکتوری‌های مورد استفاده در PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fR حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fR می‌تواند برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fR(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)
و
.BR pmcd (1).

.\" control lines for scripts/man-spell
.\" +ok+ pmdamongodb mongodb pymongo