'\"macro stdmacro
.\"
.\" Copyright (c) 2016 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 PMDAORACLE 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmdaoracle \- عامل PMDA پایگاه داده Oracle
.SH "توضیحات (DESCRIPTION)"
\f3pmdaoracle\f1 یک \s-1PMDA\s0 در Performance Co-Pilot است که داده‌های زندهٔ کارایی را از یک پایگاه داده در حال اجرای Oracle استخراج می‌کند.
.SH "نصب (INSTALLATION)"
\f3pmdaoracle\f1 از یک فایل پیکربندی از مسیرهای زیر (به همین ترتیب) استفاده می‌کند:
.PD 0
.IP "\(bu" 4
/etc/pcpdbi.conf
.IP "\(bu" 4
\&\f(CR$PCP_PMDAS_DIR\fR/oracle/oracle.conf
.IP "\(bu" 4
\&./oracle.conf
.PD
.PP
این فایل می‌تواند شامل مقادیر بازنویسی‌شده (کد Perl) برای تنظیماتی باشد که در ابتدای pmdaoracle.pl فهرست شده‌اند، برای نمونه:
.PD 0
.IP "\(bu" 4
$username \- نام کاربری برای اتصال به پایگاه داده [پیش‌فرض: 'SYSTEM']
.IP "\(bu" 4
$password \- گذرواژه برای اتصال به پایگاه داده [پیش‌فرض: 'manager']
.IP "\(bu" 4
$host \- میزبان محل اجرای پایگاه داده [پیش‌فرض: 'localhost']
.IP "\(bu" 4
$port \- درگاهی که پایگاه داده به آن گوش می‌دهد [پیش‌فرض: '1521']
.IP "\(bu" 4
$os_user \-
نام کاربری سیستم‌عامل (PMDA با شناسه کاربری متناظر با آن اجرا خواهد شد) [پیش‌فرض: oracle]
.IP "\(bu" 4
@sids \-
آرایه‌ای از شناسه‌های پایگاه داده $ORACLE_SID [پیش‌فرض: ('master')]
.PD
.PP
به‌منظور آزمایش تنظیمات محلی شما، یک اسکریپت ساده ارائه شده است که به پایگاه داده متصل و از آن قطع می‌شود \- تا پیش از ادامه، درستی پیکربندی اساسی را تأیید کند.
اگر اسکریپت \fB$PCP_PMDAS_DIR/oracle/connect.pl\f1 نتواند متصل شود، نصب PMDA را ادامه ندهید زیرا ناموفق خواهد بود.
ابتدا تنظیمات محلی خود را اصلاح کنید.
.PP
پس از راه‌اندازی این بخش، می‌توانید با انجام مراحل زیر با کاربر ریشه (root)، به نام‌ها و مقادیر معیارهای کارایی oracle دسترسی پیدا کنید:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/oracle
# ./Install
.fi
.ft P
.RE
.sp 1
برای حذف، باید دستورهای زیر با کاربر ریشه (root) اجرا شوند:
.sp 1
.RS +4
.ft B
.nf
# cd $PCP_PMDAS_DIR/oracle
# ./Remove
.fi
.ft P
.RE
.sp 1
\fBpmdaoracle\fR توسط \fIpmcd\fR(1) راه‌اندازی می‌شود و هرگز نباید مستقیماً اجرا گردد. اسکریپت‌های Install و Remove در زمان نصب یا حذف عامل، به \fIpmcd\fR(1) اطلاع می‌دهند.
.SH "وضعیت اتصال (CONNECTION STATE)"
به‌طور پیش‌فرض،
.B pmdaoracle
به‌شدت تلاش می‌کند تا اتصالات پایدار به Oracle را حفظ کند تا از پاسخ‌دهی به‌موقع به پرس‌وجوهایش اطمینان حاصل شود، و در صورت قطع اتصال، به‌طور خودکار دوباره متصل خواهد شد.
.PP
با این حال، در شرایط خاصی ممکن است این رفتار نامطلوب باشد، بنابراین یک سازوکار دستی
.BR pmStore (3)
برای کنترل صریح قطع و وصل مجدد به یک نمونه Oracle فراهم شده است.
این قابلیت می‌تواند به‌عنوان مثال برای اطمینان از این‌که
.B pmdaoracle
در زمان خاموش شدن متصل نیست استفاده شود تا از فرآیند خاموش شدن تمیز Oracle اطمینان حاصل گردد.
.PP
از دستور
.B pmstore (1)
می‌توان برای قطع و وصل مجدد استفاده کرد.
با استفاده از نمونه‌های مجزای معیار oracle.control.connected، می‌توان وضعیت اتصال را روی فعال (1) یا غیرفعال (0) تنظیم کرد.
علاوه بر این،
.BR pminfo (1)
می‌تواند وضعیت فعلی اتصالات Oracle را گزارش دهد.
.P
.ft CR
.nf
.in +0.5i
# pminfo \(hyf oracle.control.connected

oracle.control.connected
    inst [0 or "master"] value 1

# pmstore oracle.control.connected 0
oracle.control.connected inst [0 or "master"] old value=1 new value=0
.in
.fi
.SH "فایل‌ها (FILES)"
.PD 0
.IP "\fB/etc/pcpdbi.conf\fR" 4
فایل پیکربندی برای تمام ناظرهای پایگاه داده \s-1PCP\s0
.IP "\fB$PCP_PMDAS_DIR/oracle/oracle.conf\f1" 4
فایل پیکربندی برای \fBpmdaoracle\fR
.IP "\fB$PCP_PMDAS_DIR/oracle/sample.conf\fR" 4
فایل پیکربندی نمونه برای \fBpmdaoracle\fR با استفاده از $LD_LIBRARY_PATH
.IP "\fB$PCP_PMDAS_DIR/oracle/connect.pl\fR" 4
اسکریپت آزمایش پیکربندی برای اتصال به پایگاه داده \fBOracle\fR
.IP "\fB$PCP_PMDAS_DIR/oracle/Install\fR" 4
اسکریپت نصب برای عامل \fBpmdaoracle\fR
.IP "\fB$PCP_PMDAS_DIR/oracle/Remove\fR" 4
اسکریپت حذف نصب برای عامل \fBpmdaoracle\fR
.IP "\fB$PCP_LOG_DIR/pmcd/oracle.log\fR" 4
فایل گزارش پیش‌فرض برای پیام‌های خطای \fBpmdaoracle\fR
.PD
.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 pmdadbping (1)،
.BR pminfo (1)،
.BR pmstore (1)،
.BR DBI (3)
و
.BR pmStore (3).

.\" control lines for scripts/man-spell
.\" +ok+ LD_LIBRARY_PATH ORACLE_SID pmdadbping pmdaoracle os_user pcpdbi
.\" +ok+ DBI
.\" +ok+ sids {from @sids}
.\" +ok+ pl {from pmdaoracle.pl}