'\"macro stdmacro
.\"
.\" Copyright (c) 2019-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 PMDAMSSQL 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pmdamssql\f1 \- عامل دامنه معیارهای عملکرد (PMDA) برای پایگاه‌داده Microsoft SQL Server
.SH "توضیحات (DESCRIPTION)"
\fBpmdamssql\fP یک عامل دامنه معیارهای عملکرد (PMDA) در Performance Co-Pilot (PCP)
است که داده‌های عملکرد زنده را از یک کارساز پایگاه‌داده Microsoft SQL Server
در حال اجرا استخراج می‌کند.
.SH "پیکربندی (CONFIGURATION)"
در وهله نخست، \f3pmdamssql\f1 نیازمند نصب این بسته‌های پشتیبان است:
.TP 5
.B mssql-server
بسته اصلی پایگاه‌داده Microsoft SQL Server.
.TP
\fBmsodbcsql18\fR، \fBmsodbcsql17\fR یا \fBmsodbcsql\fR
اتصالات ODBC مایکروسافت SQL Server.
.TP
.B pyodbc
ماژول عمومی ODBC پایتون به همراه فعال بودن پشتیبانی از Microsoft SQL Server.
.PP
سپس، \fBpmdamssql\fP یک فایل پیکربندی اختیاری به سبک ini را می‌خواند:
.IP
.PD 0
.IP
.I \f(CR$PCP_PMDAS_DIR\fP/mssql/mssql.conf
.PD
.PP
این فایل در حال حاضر شامل دو بخش است؛ یکی برای پیکربندی کتابخانه‌ای
که به SQL Server متصل می‌شود، و دیگری برای احراز هویت در SQL Server.
.PP
بخش
.B [connection]
مقادیر مربوط به تنظیمات زیر را مشخص می‌کند
(مقادیر پیش‌فرض آن‌ها درون پرانتز نشان داده شده است):
.TP 15
.B driver \fR(\fP\fI{ODBC Driver 17 for SQL Server}\fP\fR)\fP
رشته درایور ODBC.
.TP
.B server \fR(\fP\fItcp:localhost\fP\fR)\fP
رشته اتصال سوکت SQL Server.
.TP
.B timeout \fR(\fP\fI2\fP\fR)\fP
تنظیم مهلت زمانی (timeout) اتصال، بر حسب ثانیه.
.PP
بخش
.B [authentication]
مقادیر مربوط به دو حالت پشتیبانی‌شده احراز هویت
با SQL Server را مشخص می‌کند.
.P
حالت پیش‌فرض، استفاده از احراز هویت SQL Server است
که مستلزم ارائه نام کاربری و گذرواژه می‌باشد.
تنظیمات پیکربندی مربوطه به شرح زیر هستند
(مقادیر پیش‌فرض آن‌ها درون پرانتز نشان داده شده است):
.TP 15
.B username \fR(\fP\fIpcp\fP\fR)\fP
نام کاربری برای اتصال به پایگاه‌داده.
.TP
.B password \fR(خالی)\fP
گذرواژه برای اتصال به پایگاه‌داده.
.PP
توجه داشته باشید که اگر یک فایل پیکربندی SQL Server Assessments API در
مسیر \fI/var/opt/mssql/secrets/assessment\fP یافت شود، آن‌گاه
.B pmdamssql
نام کاربری و گذرواژه را با اولویت از آن فایل می‌خواند.
قالب آن صرفاً یک فایل متنی دو خطی است که خط اول شامل
نام کاربری و خط دوم شامل گذرواژه است.
.PP
گزینه دوم حالت احراز هویت Windows است،
که در آن شناسه‌های ورودی در SQL Server ایجاد می‌شوند که
بر پایه حساب‌های کاربری سیستم‌عامل نیستند.
.TP 15
.B trusted \fR(\fP\fIfalse\fP\fR)\fP
برای استفاده از احراز هویت Windows هنگام اتصال به
پایگاه‌داده، این مقدار را روی
.I true
تنظیم کنید.
.PP
این یک اتصال از نوع Kerberos است و اعتبارنامه‌ها
باید پیش از راه‌اندازی PMDA در دسترس باشند (برای
جزئیات بیشتر
.BR kinit (1)
را ببینید).
.PD
.SH "نصب (INSTALLATION)"
برای نصب، دستورهای زیر باید توسط کاربر ریشه (root) انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/mssql
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف، دستورهای زیر باید توسط کاربر ریشه (root) انجام شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/mssql
# ./Remove
.fi
.ft P
.RE
.sp 1
\fBpmdamssql\fP توسط \fBpmcd\fP(1) راه‌اندازی می‌شود و هرگز نباید
به طور مستقیم اجرا گردد.
اسکریپت‌های \fBInstall\fP و \fBRemove\fP هنگام نصب یا حذف عامل،
به \fBpmcd\fP(1) اطلاع می‌دهند.
.PP
در صورتی که اتصال \fBpmdamssql\fR قطع شود \(en برای نمونه اگر
سرویس SQL Server بازراه‌اندازی شود \(en این عامل به طور خودکار
برای برقراری مجدد اتصال به SQL Server تلاش خواهد کرد.
.SH "فایل‌ها (FILES)"
.TP 5
.I \f(CR$PCP_PMDAS_DIR\fP/mssql/mssql.conf
فایل پیکربندی برای عامل \fBpmdamssql\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/mssql/Install
اسکریپت نصب برای عامل \fBpmdamssql\fR
.TP
.I \f(CR$PCP_PMDAS_DIR\fP/mssql/Remove
اسکریپت حذف نصب برای عامل \fBpmdamssql\fR
.TP
.I \f(CR$PCP_LOG_DIR\fP/pmcd/mssql.log
فایل لاگ پیش‌فرض برای پیام‌های عامل \fBpmdamssql\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 kinit (1)
و
.BR pmcd (1).

.\" control lines for scripts/man-spell
.\" +ok+ pmdamssql msodbcsql pyodbc kinit mssql ODBC tcp