نام (NAME)

apcupsd-ups - درایور برای دسترسی به کلاینت apcupsd

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

apcupsd-ups -h

apcupsd-ups -a UPS_NAME [OPTIONS]

نکته

این صفحه راهنما تنها ویژگی‌های اختصاصی درایور apcupsd-ups را مستند می‌کند. برای اطلاعات درباره درایور اصلی، به nutupsdrv(8) مراجعه کنید.

توضیحات (DESCRIPTION)

این درایور یک کلاینت برای apcupsd (پروژه دیگری برای نظارت بر یوپی‌اس) است.

apcupsd-ups به عنوان کلاینت apcupsd عمل می‌کند و صرفاً داده‌ها را بازارسال (فوروارد) می‌نماید. این درایور می‌تواند در مواردی که هر دو پروتکل در یک شبکه مورد نیاز هستند، یا زمانی که پایگاه کد apcupsd دارای حالت دسترسی خاصی به یوپی‌اس است که در NUT وجود ندارد، مفید باشد.

آرگومان‌های اضافی (EXTRA ARGUMENTS)

این درایور از تنظیمات اختیاری زیر در nut.conf(5) پشتیبانی می‌کند:

port=<hostname>[:<port>]

این گزینه نام یک میزبان دوردست است که apcupsd را اجرا می‌کند (به همراه یک پورت اختیاری).

برای نمونه:

[apcupsd]
        driver = apcupsd-ups
        port = localhost
        desc = "apcupsd client"

برای آدرس‌های IPv6، برای بخش نام میزبان (hostname) از قلاب استفاده کنید (تا دونقطه‌های موجود در آن به عنوان پورت اشتباه گرفته نشوند، به ویژه در صورت استفاده از پورت پیش‌فرض):

[apcupsd]
        driver = apcupsd-ups
        port = "[::1]:3551"
        desc = "apcupsd client"

پیش‌زمینه (BACKGROUND)

این درایور در ابتدا در طول یک عصر برای امکان‌پذیر ساختن تعامل‌پذیری با apcupsd نوشته شد.

متغیرهای پشتیبانی‌شده (SUPPORTED VARIABLES)

متغیرهای زیر از apcupsd به NUT ترجمه می‌شوند. تمام زمان‌ها باید به ثانیه تبدیل شوند (در صورت مشاهده عدم تطابق در واحدها، لطفاً یک گزارش اشکال ثبت کنید).

متغیر apcupsd	متغیر(های) NUT
BCHARGE	battery.charge
MBATTCHG	battery.charge.low
RETPCT	battery.charge.restart
BATTDATE	battery.date
TIMELEFT	battery.runtime
MINTIMEL	battery.runtime.low
BATTV	battery.voltage
NOMBATTV	battery.voltage.nominal
LINEFREQ	input.frequency
SENSE	input.sensitivity
HITRANS	input.transfer.high
LOTRANS	input.transfer.low
LASTXFER	input.transfer.reason
LINEV	input.voltage
MAXLINEV	input.voltage.maximum
MINLINEV	input.voltage.minimum
NOMINV	input.voltage.nominal
LINEFREQ	output.frequency
OUTPUTV	output.voltage
NOMOUTV	output.voltage.nominal
DATE	ups.date, ups.time
DSHUTD	ups.delay.shutdown
DWAKE	ups.delay.start
FIRMWARE	ups.firmware, ups.firmware.aux
UPSNAME	ups.id
LOADPCT	ups.load
MANDATE	ups.mfr.date
NOMPOWER	ups.realpower.nominal
SERIALNO	ups.serial
STATUS	ups.status
ITEMP	ups.temperature
STESTI	ups.test.interval
SELFTEST	ups.test.result

محدودیت‌ها (LIMITATIONS)

دسترسی به apcupsd اکیداً فقط‌خواندنی است: هیچ دستوری را نمی‌توان صادر کرد. این محدودیت از طراحی apcupsd ناشی می‌شود که در آن تنظیمات در apctest تغییر می‌یابند. برای اجرای apctest، سرویس apcupsd باید متوقف شود (و این در واقع apcupsd است که یوپی‌اس را در شبکه و برای این درایور NUT به عنوان کلاینت آن در دسترس قرار می‌دهد).

نویسنده (AUTHOR)

Andreas Steinmetz

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

ups.conf(5), nutupsdrv(8)

منابع اینترنتی (Internet Resources):

•صفحه خانگی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5/

•صفحه خانگی apcupsd: http://www.apcupsd.org/

•به نظر می‌رسد توسعه خود پروژه apcupsd در سال‌های ۲۰۱۶/۲۰۱۷ متوقف شده است و انتشار نسخه 3.14.14 آخرین برچسب رسمی آن است. با این وجود، گفتگوهای انجمن آن همچنان کاملاً فعال است.

•جهت اطمینان، یک کپی از سورس‌های آن در آدرس زیر نگهداری می‌شود: https://github.com/networkupstools/apcupsd