نام (NAME)

apcupsd — دیمن برای کنترل و نظارت بر اکثر منابع تغذیه بدون وقفه (UPS) شرکت APC

خلاصه دستور (SYNOPSIS)

apcupsd [-k | --killpower | --hibernate | -o | --power-off]

apcupsd [-h | --help]

apcupsd [-V | --version]

توضیحات (DESCRIPTION)

دیمن apcupsd عملکرد اکثر دستگاه‌های منبع تغذیه بدون وقفه (UPS) شرکت American Power Conversion Corp (APC) را کنترل و مدیریت می‌کند. در هنگام قطعی برق شهری، apcupsd کاربران را از قطع برق آگاه ساخته و اعلام می‌کند که ممکن است سیستم خاموش شود. اگر برق شهری وصل نشود، هنگامی که باتری تخلیه شود، زمان انقضای مشخص‌شده (timeout) سپری شود، درصد شارژ مشخص‌شده‌ای برای باتری حاصل شود، یا زمان کارکرد مشخص‌شده باتری (بر اساس محاسبات داخلی UPS و با توجه به نرخ مصرف توان) به پایان برسد، سیستم خاموش خواهد شد. اگر برق شهری پیش از برقراری هر یک از این شرایط خاموشی بازگردد، apcupsd این موضوع را به کاربران اطلاع می‌دهد و فرآیند خاموشی عموماً لغو خواهد شد. برای شرایطی که ممکن است خاموشی در آن‌ها لغو نشود، به بخش «نکات پیاده‌سازی» در ادامه مراجعه کنید.

معنای گزینه‌های خط فرمان به شرح زیر است:

-b: اجرا در پیش‌زمینه (foreground)؛ از ترمینال جدا نشده و به دیمن تبدیل نمی‌شود.
-d level --debug level: تنظیم سطح خروجی اشکال‌زدایی (debugging) که در آن level یک عدد بزرگ‌تر از صفر است.
-f file --config-file file: بارگذاری فایل پیکربندی مشخص‌شده. فایل پیکربندی پیش‌فرض /etc/apcupsd/apcupsd.conf است. هنگام اجرای بیش از یک نسخه از apcupsd روی همان رایانه برای کنترل چندین دستگاه UPS، این مسیر باید تغییر کند.
-k | --killpower | --hibernate: خاموش کردن UPS در حالت خواب زمستانی (hibernate) پس از یک تاخیر ۱۰ ثانیه‌ای. این گزینه معمولاً فقط توسط خود apcupsd برای خاموش کردن UPS پس از تقریباً کامل شدن خاموشی سیستم استفاده می‌شود. در حالت خواب زمستانی، با بازگشت برق شهری، UPS مجدداً برق سیستم را تامین خواهد کرد.
-o | --power-off: خاموش کردن کامل UPS. در این حالت با بازگشت برق شهری، UPS برق سیستم را برقرار نخواهد کرد.
-P file --pid-file file: ایجاد فایل شناسه فرآیند (PID) مشخص‌شده. مسیر پیش‌فرض /var/run/apcupsd.pid است. هنگام اجرای بیش از یک نسخه از apcupsd روی همان رایانه برای کنترل چندین دستگاه UPS، این مسیر باید تغییر کند.
-p --kill-on-powerfail: apcupsd درست پیش از آنکه شروع به خاموش کردن سیستم کند، به UPS فرمان می‌دهد تا در حالت خواب زمستانی خاموش شود. این قابلیت به تاخیر مجاز خاموشی (grace shutdown delay) در دستگاه Smart-UPS متکی است تا به اندازه کافی طولانی باشد که اجازه دهد سیستم پیش از قطع برق توسط UPS و رفتن به حالت خواب زمستانی، به‌طور کامل خاموش شود. این تاخیر مجاز خاموشی، مقداری قابل برنامه‌ریزی است که در حافظه EEPROM دستگاه Smart-UPS ذخیره شده و با استفاده از apctest(8) قابل تغییر است. در حالت خواب زمستانی، با بازگشت برق شهری، UPS مجدداً برق سیستم را تامین خواهد کرد. برای یک روش جایگزین با استفاده از دستورالعمل پیکربندی KILLDELAY و تنها روش موجود هنگام استفاده از Back-UPS یا سایر UPSهایی که در حالت سیگنال‌دهی ساده کار می‌کنند، به apcupsd.conf(5) مراجعه کنید.
-t --term-on-powerfail: apcupsd به محض صدور دستور خاموشی سیستم فوراً خارج می‌شود. این رفتار برای سیستم‌هایی مفید است که امکان درج دستورات apcupsd در اسکریپت halt برای صدور دستور killpower وجود ندارد. بدون این گزینه، apcupsd پیش از خروج، منتظر دریافت سیگنال SIGTERM از فرآیند خاموش‌سازی سیستم می‌ماند.
-R: قرار دادن یک UPS که به‌طور پیش‌فرض در حالت سیگنال‌دهی هوشمند کار می‌کند (مانند Smart-UPS) در حالت سیگنال‌دهی ساده.
-v --version: چاپ شماره نسخه apcupsd و راهنمای برنامه.
-h --help: چاپ راهنمای برنامه.

دیمن apcupsd از یک حالت شبکه‌ای به نام Network Information Server (NIS) -- که ارتباطی با سرویس NIS/YP شرکت Sun ندارد -- پشتیبانی می‌کند که در آن، دیمن اطلاعات وضعیت و رویدادها را از طریق شبکه به کلاینت‌ها ارائه می‌دهد. برای اطلاعات بیشتر و جزئیات پیکربندی این حالت، به بخش "Running The Network Information Server" در کتابچه راهنمای apcupsd مراجعه کنید.

دیمن apcupsd همچنین از دستگاه‌های Smart-UPS در حالت SNMP پشتیبانی می‌کند، مشروط بر اینکه یک کارت APC Web/SNMP یا APC PowerNet SNMP در اسلات SmartSlot دستگاه UPS نصب شده باشد. برای اطلاعات بیشتر و جزئیات پیکربندی این حالت، به بخش "Support for SNMP UPSes" در کتابچه راهنمای apcupsd مراجعه کنید.

نکات پیاده‌سازی (IMPLEMENTATION NOTES)

فرآیند خاموشی از طریق فراخوانی اسکریپت /etc/apcupsd/apccontrol توسط دیمن apcupsd انجام می‌گیرد. در نتیجه، در لینوکس نیازی به اعمال تغییرات در /etc/inittab نیست، زیرا هیچ ارتباطی بین دیمن و فرآیند init(1) وجود ندارد. نصب دیمن، اسکریپت halt را به‌گونه‌ای اصلاح می‌کند که در پایان فرآیند خاموشی، دیمن مجدداً اجرا شود تا UPS را در حالت خواب زمستانی (hibernate) خاموش کند.

در برخی از سیستم‌عامل‌ها (مانند FreeBSD) اسکریپت halt وجود ندارد، بنابراین apccontrol باید اصلاح شود تا دیمن پس از یک تاخیر، UPS را خاموش کند. روش‌های جایگزین، استفاده از گزینه --kill-on-powerfail در خط فرمان apcupsd یا مراجعه به apcupsd.conf(5) برای آگاهی از جزئیات دستورالعمل پیکربندی KILLDELAY است.

پیکربندی (CONFIGURATION)

تقریباً به طور قطع لازم خواهد بود که اطلاعات پیکربندی موجود در فایل /etc/apcupsd/apcupsd.conf را متناسب با ساختار و رفتار مورد انتظار خود از UPS سفارشی‌سازی کنید.

برای کسب اطلاعات درباره دستورالعمل‌های پیکربندی و قالب فایل پیکربندی، به apcupsd.conf(5) مراجعه کنید.

رویدادها (EVENTS)

apcupsd هنگام وقوع شرایط خاص رویدادهایی تولید می‌کند. این رویدادها به لاگ سیستم (system log) و در صورت تمایل به فایل موقت رویدادها (/var/log/apcupsd.events) ارسال می‌شوند. آن‌ها همچنین اسکریپت /etc/apcupsd/apccontrol را فراخوانی می‌کنند که به نوبه خود هر اسکریپت سفارشی قرار داده‌شده در پوشه /etc/apcupsd را که می‌تواند رفتار پیش‌فرض apccontrol را لغو یا بازنویسی کند، فراخوانی می‌نماید. برای آگاهی از جزئیات رویدادها و سفارشی‌سازی رفتار apccontrol، به apccontrol(8) مراجعه کنید.

قالب فایل داده (DATA FILE FORMAT)

اگر دستورالعمل پیکربندی DATATIME روی مقداری غیر از صفر تنظیم شود، apcupsd یک رکورد داده را در بازه زمانی تعیین‌شده توسط دستورالعمل DATATIME ثبت می‌کند. این رکورد داده دارای قالبی شبیه به فرمت فایل داده نرم‌افزار APC PowerChute است.

قالب گزارش وضعیت (STATUS REPORT FORMAT)

قالب خروجی گزارش وضعیت به‌صورت متن ساده ASCII است. عموماً در هر خط از خروجی یک بخش از اطلاعات قرار دارد. محتوا بسته به مدل UPS مورد استفاده و در برخی موارد، نسخه سفت‌افزار (firmware) متفاوت است. این گزارش وضعیت همچنین می‌تواند به‌صورت اختیاری در فایل /etc/apcupsd/apcupsd.status نوشته شود. برای مشاهده جزئیات کامل خروجی گزارش وضعیت، به apcaccess(8) مراجعه کنید.

فایلها (FILES)

/etc/apcupsd/apcupsd.conf فایل پیکربندی پیش‌فرض

/var/run/apcupsd.pid فایل پیش‌فرض شناسه فرآیند (PID)

/var/log/apcupsd.status فایل اختیاری وضعیت

/var/log/apcupsd.events فایل پیش‌فرض رویدادها

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

apcupsd.conf(5), apcaccess(8), apccontrol(8), apctest(8).

راهنمای HTML برنامه apcupsd نصب‌شده روی سیستم شما یا موجود به‌صورت برخط در http://www.apcupsd.org