.\" manual page [] for apcupsd version 3.14.6
.Dd January 10, 2009
.Dt APCUPSD 8
.Os apcupsd v3.14.6
.Sh "نام (NAME)"
.Nm apcupsd
.Nd دیمن برای کنترل و نظارت بر اکثر منابع تغذیه بدون وقفه (UPS) شرکت APC
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl b
.Op Fl d Ar level | Fl -debug Ar level
.Op Fl f Ar file | Fl -config-file Ar file
.Op Fl P Ar file | Fl -pid-file Ar file
.Op Fl p | -kill-on-powerfail | t | -term-on-powerfail
.Op Fl R
.Pp
.Nm
.Op Fl k | -killpower | -hibernate | o | -power-off
.Pp
.Nm
.Op Fl h | -help
.Pp
.Nm
.Op Fl V | -version
.Pp
.Sh "توضیحات (DESCRIPTION)"
.Pp
دیمن
.Nm
عملکرد اکثر دستگاه‌های منبع تغذیه بدون وقفه (UPS) شرکت American Power Conversion Corp (APC) را کنترل و مدیریت می‌کند. در هنگام قطعی برق شهری،
.Nm
کاربران را از قطع برق آگاه ساخته و اعلام می‌کند که ممکن است سیستم خاموش شود. اگر برق شهری وصل نشود، هنگامی که باتری تخلیه شود، زمان انقضای مشخص‌شده (timeout) سپری شود، درصد شارژ مشخص‌شده‌ای برای باتری حاصل شود، یا زمان کارکرد مشخص‌شده باتری (بر اساس محاسبات داخلی UPS و با توجه به نرخ مصرف توان) به پایان برسد، سیستم خاموش خواهد شد. اگر برق شهری پیش از برقراری هر یک از این شرایط خاموشی بازگردد،
.Nm
این موضوع را به کاربران اطلاع می‌دهد و فرآیند خاموشی عموماً لغو خواهد شد. برای شرایطی که ممکن است خاموشی در آن‌ها لغو نشود، به بخش «نکات پیاده‌سازی» در ادامه مراجعه کنید.
.Pp
معنای گزینه‌های خط فرمان به شرح زیر است:
.Bl -tag -width Fl
.It Fl b
اجرا در پیش‌زمینه (foreground)؛ از ترمینال جدا نشده و به دیمن تبدیل نمی‌شود.
.It Fl d Ar level Fl -debug Ar level
تنظیم سطح خروجی اشکال‌زدایی (debugging) که در آن level یک عدد بزرگ‌تر از صفر است.
.It Fl f Ar file Fl -config-file Ar file
بارگذاری فایل پیکربندی مشخص‌شده.
فایل پیکربندی پیش‌فرض
.Pa /etc/apcupsd/apcupsd.conf
است. هنگام اجرای بیش از یک نسخه از
.Nm
روی همان رایانه برای کنترل چندین دستگاه UPS، این مسیر باید تغییر کند.
.It Fl k | Fl -killpower | -hibernate
خاموش کردن UPS در حالت خواب زمستانی (hibernate) پس از یک تاخیر ۱۰ ثانیه‌ای. این گزینه معمولاً فقط توسط خود
.Nm
برای خاموش کردن UPS پس از تقریباً کامل شدن خاموشی سیستم استفاده می‌شود. در حالت خواب زمستانی، با بازگشت برق شهری، UPS مجدداً برق سیستم را تامین خواهد کرد.
.It Fl o | -power-off
خاموش کردن کامل UPS. در این حالت با بازگشت برق شهری، UPS برق سیستم را برقرار نخواهد کرد.
.It Fl P Ar file Fl -pid-file Ar file
ایجاد فایل شناسه فرآیند (PID) مشخص‌شده. مسیر پیش‌فرض
.Pa /var/run/apcupsd.pid
است. هنگام اجرای بیش از یک نسخه از
.Nm
روی همان رایانه برای کنترل چندین دستگاه UPS، این مسیر باید تغییر کند.
.It Fl p -kill-on-powerfail
.Nm
درست پیش از آنکه شروع به خاموش کردن سیستم کند، به UPS فرمان می‌دهد تا در حالت خواب زمستانی خاموش شود. این قابلیت به تاخیر مجاز خاموشی (grace shutdown delay) در دستگاه Smart-UPS متکی است تا به اندازه کافی طولانی باشد که اجازه دهد سیستم پیش از قطع برق توسط UPS و رفتن به حالت خواب زمستانی، به‌طور کامل خاموش شود. این تاخیر مجاز خاموشی، مقداری قابل برنامه‌ریزی است که در حافظه EEPROM دستگاه Smart-UPS ذخیره شده و با استفاده از
.Xr apctest 8
قابل تغییر است. در حالت خواب زمستانی، با بازگشت برق شهری، UPS مجدداً برق سیستم را تامین خواهد کرد. برای یک روش جایگزین با استفاده از دستورالعمل پیکربندی KILLDELAY و تنها روش موجود هنگام استفاده از Back-UPS یا سایر UPSهایی که در حالت سیگنال‌دهی ساده کار می‌کنند، به
.Xr apcupsd.conf 5
مراجعه کنید.
.It Fl t -term-on-powerfail
.Nm
به محض صدور دستور خاموشی سیستم فوراً خارج می‌شود. این رفتار برای سیستم‌هایی مفید است که امکان درج دستورات
.Nm
در اسکریپت halt برای صدور دستور killpower وجود ندارد. بدون این گزینه،
.Nm
پیش از خروج، منتظر دریافت سیگنال SIGTERM از فرآیند خاموش‌سازی سیستم می‌ماند.
.It Fl R
قرار دادن یک UPS که به‌طور پیش‌فرض در حالت سیگنال‌دهی هوشمند کار می‌کند (مانند Smart-UPS) در حالت سیگنال‌دهی ساده.
.It Fl v -version
چاپ شماره نسخه
.Nm
و راهنمای برنامه.
.It Fl h  -help
چاپ راهنمای برنامه.
.Pp
.El
دیمن
.Nm
از یک حالت شبکه‌ای به نام Network Information Server (NIS) -- که ارتباطی با سرویس NIS/YP شرکت Sun ندارد -- پشتیبانی می‌کند که در آن، دیمن اطلاعات وضعیت و رویدادها را از طریق شبکه به کلاینت‌ها ارائه می‌دهد. برای اطلاعات بیشتر و جزئیات پیکربندی این حالت، به بخش \(dqRunning The Network Information Server\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Pp
دیمن
.Nm
همچنین از دستگاه‌های Smart-UPS در حالت SNMP پشتیبانی می‌کند، مشروط بر اینکه یک کارت APC Web/SNMP یا APC PowerNet SNMP در اسلات SmartSlot دستگاه UPS نصب شده باشد. برای اطلاعات بیشتر و جزئیات پیکربندی این حالت، به بخش \(dqSupport for SNMP UPSes\(dq در کتابچه راهنمای apcupsd مراجعه کنید.
.Pp
.Sh "نکات پیاده‌سازی (IMPLEMENTATION NOTES)"
.Pp
فرآیند خاموشی از طریق فراخوانی اسکریپت
.Pa /etc/apcupsd/apccontrol
توسط دیمن
.Nm
انجام می‌گیرد. در نتیجه، در لینوکس نیازی به اعمال تغییرات در
.Pa /etc/inittab
نیست، زیرا هیچ ارتباطی بین دیمن و فرآیند
.Xr init 1
وجود ندارد. نصب دیمن، اسکریپت halt را به‌گونه‌ای اصلاح می‌کند که در پایان فرآیند خاموشی، دیمن مجدداً اجرا شود تا UPS را در حالت خواب زمستانی (hibernate) خاموش کند.
.Pp
در برخی از سیستم‌عامل‌ها (مانند FreeBSD) اسکریپت halt وجود ندارد، بنابراین apccontrol باید اصلاح شود تا دیمن پس از یک تاخیر، UPS را خاموش کند. روش‌های جایگزین، استفاده از گزینه --kill-on-powerfail در خط فرمان
.Nm
یا مراجعه به
.Xr apcupsd.conf 5
برای آگاهی از جزئیات دستورالعمل پیکربندی KILLDELAY است.
.Pp
.Sh "پیکربندی (CONFIGURATION)"
تقریباً به طور قطع لازم خواهد بود که اطلاعات پیکربندی موجود در فایل
.Pa /etc/apcupsd/apcupsd.conf
را متناسب با ساختار و رفتار مورد انتظار خود از UPS سفارشی‌سازی کنید.
.Pp
برای کسب اطلاعات درباره دستورالعمل‌های پیکربندی و قالب فایل پیکربندی، به
.Xr apcupsd.conf 5
مراجعه کنید.
.Pp
.Sh "رویدادها (EVENTS)"
.Pp
.Nm
هنگام وقوع شرایط خاص رویدادهایی تولید می‌کند. این رویدادها به لاگ سیستم (system log) و در صورت تمایل به فایل موقت رویدادها
.Pa ( /var/log/apcupsd.events )
ارسال می‌شوند. آن‌ها همچنین اسکریپت
.Pa /etc/apcupsd/apccontrol
را فراخوانی می‌کنند که به نوبه خود هر اسکریپت سفارشی قرار داده‌شده در پوشه
.Pa /etc/apcupsd
را که می‌تواند رفتار پیش‌فرض apccontrol را لغو یا بازنویسی کند، فراخوانی می‌نماید. برای آگاهی از جزئیات رویدادها و سفارشی‌سازی رفتار apccontrol، به
.Xr apccontrol 8
مراجعه کنید.
.Pp
.Sh "قالب فایل داده (DATA FILE FORMAT)"
.Pp
اگر دستورالعمل پیکربندی DATATIME روی مقداری غیر از صفر تنظیم شود،
.Nm
یک رکورد داده را در بازه زمانی تعیین‌شده توسط دستورالعمل DATATIME ثبت می‌کند. این رکورد داده دارای قالبی شبیه به فرمت فایل داده نرم‌افزار APC PowerChute است.
.Sh "قالب گزارش وضعیت (STATUS REPORT FORMAT)"
قالب خروجی گزارش وضعیت به‌صورت متن ساده ASCII است. عموماً در هر خط از خروجی یک بخش از اطلاعات قرار دارد. محتوا بسته به مدل UPS مورد استفاده و در برخی موارد، نسخه سفت‌افزار (firmware) متفاوت است. این گزارش وضعیت همچنین می‌تواند به‌صورت اختیاری در فایل
.Pa /etc/apcupsd/apcupsd.status
نوشته شود. برای مشاهده جزئیات کامل خروجی گزارش وضعیت، به
.Xr apcaccess 8
مراجعه کنید.
.Sh "فایلها (FILES)"
.Pa /etc/apcupsd/apcupsd.conf
فایل پیکربندی پیش‌فرض
.Pp
.Pa /var/run/apcupsd.pid
فایل پیش‌فرض شناسه فرآیند (PID)
.Pp
.Pa /var/log/apcupsd.status
فایل اختیاری وضعیت
.Pp
.Pa /var/log/apcupsd.events
فایل پیش‌فرض رویدادها
.Pp
.Sh "همچنین ببینید (SEE ALSO)"
.Pp
.Xr apcupsd.conf 5 ,
.Xr apcaccess 8 ,
.Xr apccontrol 8 ,
.Xr apctest 8 .
.Pp
راهنمای HTML برنامه apcupsd نصب‌شده روی سیستم شما یا موجود به‌صورت برخط در
http://www.apcupsd.org
.Pp
.Sh "نویسندگان (AUTHORS)"
.Pp
.Ss "این صفحه (This page)"
.An Trevor Roydhouse (فعلی)
.An Andre M. Hedrick
.An Christopher J. Reimer
.Pp
.Ss "نرم‌افزار (Software)"
.An Adam Kropelin (مدیر فعلی پروژه و نگه‌دارنده کد)
.An Kern Sibbald (مدیر سابق پروژه و نگه‌دارنده کد)
.An Riccardo Facchetti (مدیر سابق پروژه و نگه‌دارنده کد)
.An Andre M. Hedrick (بنیان‌گذار پروژه و نگه‌دارنده سابق کد)
.Pp
.Ss "مشارکت‌کنندگان (Contributors)"
.Pp
شمار بسیار زیادی از کاربرانی که وقت و انرژی خود را وقف این پروژه کرده‌اند \-\- با سپاس.