نام (NAME)

pmdaoracle - عامل PMDA پایگاه داده Oracle

توضیحات (DESCRIPTION)

pmdaoracle یک PMDA در Performance Co-Pilot است که داده‌های زندهٔ کارایی را از یک پایگاه داده در حال اجرای Oracle استخراج می‌کند.

نصب (INSTALLATION)

pmdaoracle از یک فایل پیکربندی از مسیرهای زیر (به همین ترتیب) استفاده می‌کند:

• /etc/pcpdbi.conf
• $PCP_PMDAS_DIR/oracle/oracle.conf
• ./oracle.conf

این فایل می‌تواند شامل مقادیر بازنویسی‌شده (کد Perl) برای تنظیماتی باشد که در ابتدای pmdaoracle.pl فهرست شده‌اند، برای نمونه:

• $username - نام کاربری برای اتصال به پایگاه داده [پیش‌فرض: 'SYSTEM']
• $password - گذرواژه برای اتصال به پایگاه داده [پیش‌فرض: 'manager']
• $host - میزبان محل اجرای پایگاه داده [پیش‌فرض: 'localhost']
• $port - درگاهی که پایگاه داده به آن گوش می‌دهد [پیش‌فرض: '1521']
• $os_user - نام کاربری سیستم‌عامل (PMDA با شناسه کاربری متناظر با آن اجرا خواهد شد) [پیش‌فرض: oracle]
• @sids - آرایه‌ای از شناسه‌های پایگاه داده $ORACLE_SID [پیش‌فرض: ('master')]

به‌منظور آزمایش تنظیمات محلی شما، یک اسکریپت ساده ارائه شده است که به پایگاه داده متصل و از آن قطع می‌شود - تا پیش از ادامه، درستی پیکربندی اساسی را تأیید کند. اگر اسکریپت $PCP_PMDAS_DIR/oracle/connect.pl نتواند متصل شود، نصب PMDA را ادامه ندهید زیرا ناموفق خواهد بود. ابتدا تنظیمات محلی خود را اصلاح کنید.

پس از راه‌اندازی این بخش، می‌توانید با انجام مراحل زیر با کاربر ریشه (root)، به نام‌ها و مقادیر معیارهای کارایی oracle دسترسی پیدا کنید:

# cd $PCP_PMDAS_DIR/oracle
# ./Install

برای حذف، باید دستورهای زیر با کاربر ریشه (root) اجرا شوند:

# cd $PCP_PMDAS_DIR/oracle
# ./Remove

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

وضعیت اتصال (CONNECTION STATE)

به‌طور پیش‌فرض، pmdaoracle به‌شدت تلاش می‌کند تا اتصالات پایدار به Oracle را حفظ کند تا از پاسخ‌دهی به‌موقع به پرس‌وجوهایش اطمینان حاصل شود، و در صورت قطع اتصال، به‌طور خودکار دوباره متصل خواهد شد.

با این حال، در شرایط خاصی ممکن است این رفتار نامطلوب باشد، بنابراین یک سازوکار دستی pmStore(3) برای کنترل صریح قطع و وصل مجدد به یک نمونه Oracle فراهم شده است. این قابلیت می‌تواند به‌عنوان مثال برای اطمینان از این‌که pmdaoracle در زمان خاموش شدن متصل نیست استفاده شود تا از فرآیند خاموش شدن تمیز Oracle اطمینان حاصل گردد.

از دستور pmstore (1) می‌توان برای قطع و وصل مجدد استفاده کرد. با استفاده از نمونه‌های مجزای معیار oracle.control.connected، می‌توان وضعیت اتصال را روی فعال (1) یا غیرفعال (0) تنظیم کرد. علاوه بر این، pminfo(1) می‌تواند وضعیت فعلی اتصالات Oracle را گزارش دهد.

# pminfo ‐f 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

فایل‌ها (FILES)

/etc/pcpdbi.conf

فایل پیکربندی برای تمام ناظرهای پایگاه داده PCP

$PCP_PMDAS_DIR/oracle/oracle.conf

فایل پیکربندی برای pmdaoracle

$PCP_PMDAS_DIR/oracle/sample.conf

فایل پیکربندی نمونه برای pmdaoracle با استفاده از $LD_LIBRARY_PATH

$PCP_PMDAS_DIR/oracle/connect.pl

اسکریپت آزمایش پیکربندی برای اتصال به پایگاه داده Oracle

$PCP_PMDAS_DIR/oracle/Install

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

$PCP_PMDAS_DIR/oracle/Remove

اسکریپت حذف نصب برای عامل pmdaoracle

$PCP_LOG_DIR/pmcd/oracle.log

فایل گزارش پیش‌فرض برای پیام‌های خطای pmdaoracle

محیط PCP (PCP ENVIRONMENT)

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

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

PCPIntro(1)، pmdadbping(1)، pminfo(1)، pmstore(1)، DBI(3) و pmStore(3).