نام (NAME)

apcaccess — دریافت وضعیت UPS از دیمن apcupsd

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

apcaccess [-f <config-file>] [-h <host>[:<port>]] [-p <parameter-name>] [-u] [<command>] [<host>[:<port>]]

توضیحات (DESCRIPTION)

apcaccess برنامه‌ای است که در صورت نصب بودن دیمن apcupsd(8) و پیکربندی و اجرای صحیح آن، وضعیت کامل اکثر دستگاه‌های UPS شرکت American Power Conversion Corp. (APC) را چاپ می‌کند. این برنامه می‌تواند به اطلاعات وضعیت هر UPS شرکت APC متصل به میزبان محلی (localhost) یا متصل به هر رایانه دیگری در شبکه که apcupsd را در حالت NIS اجرا می‌کند، دسترسی داشته باشد.

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

-f: فایل پیکربندی apcupsd (پیش‌فرض معمولاً /etc/apcupsd/apcupsd.conf است)
-h: نام میزبان (hostname) و پورت apcupsd برای برقراری ارتباط. نام میزبان و پورت پیش‌فرض از فایل پیکربندی دریافت می‌شوند.
-p: فقط مقدار پارامتر مشخص‌شده را گزارش می‌دهد، به‌جای تمام پارامترها و مقادیر.
-u: فیلد واحدها را برای تجزیه آسان‌تر توسط اسکریپت‌ها حذف می‌کند.
<command>: یک دستور اختیاری، مگر اینکه نام میزبان نیز تعیین شده باشد. تنها دستور پیاده‌سازی‌شده status است که کوتاه‌نوشت دستور status localhost:3551 می‌باشد. این دستور خروجی کاملی از اطلاعات وضعیت موجود برای UPS مربوطه را تولید می‌کند.
<host>: یک نام میزبان اختیاری که می‌تواند یک نام ماشین ساده، نام دامنه کاملاً واجد شرایط (FQDN) یا یک آدرس IP باشد.
:<port>: یک شماره پورت اختیاری در صورتی که آرگومان نام میزبان مشخص شده باشد. پیش‌فرض 3551 است که شماره پورت رسمی اختصاص‌یافته توسط IANA برای سرور NIS در apcupsd می‌باشد. نام میزبان و پورت پیش‌فرض از فایل پیکربندی دریافت می‌شوند.

apcaccess از Network Information Server (NIS) داخلی apcupsd -- که هیچ ارتباطی با سرویس NIS/YP شرکت Sun ندارد -- برای دریافت اطلاعات وضعیت فعلی از UPS روی رایانه محلی یا راه دور استفاده می‌کند. بنابراین، ضروری است که دستورالعمل‌های پیکربندی زیر:

NETSERVER on
NISPORT 3551

در فایل پیکربندی /etc/apcupsd/apcupsd.conf قرار داشته باشند تا Network Information Server در دسترس باشد. همچنین ممکن است به قوانین دیوار آتش (firewall) برای دسترسی مناسب به شبکه نیاز باشد.

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

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

مثال‌ها (EXAMPLES)

در ادامه نمونه‌ای از خروجی وضعیت که ممکن است برای مدل‌های مشخص‌شده UPS تولید شود، آورده شده است.

همه مدل‌ها (All models)

APC: : نسخه، تعداد رکوردها و تعداد بایت‌های پس از آن
DATE: : تاریخ و زمان آخرین به‌روزرسانی از UPS
HOSTNAME: : نام میزبان رایانه‌ای که apcupsd را اجرا می‌کند
VERSION: : شماره نسخه apcupsd، تاریخ و سیستم‌عامل
UPSNAME: : نام UPS از فایل پیکربندی (dumb) یا EEPROM (smart)
CABLE: : نوع کابل مشخص‌شده در فایل پیکربندی
MODEL: : مدل UPS برگرفته از اطلاعات UPS
UPSMODE: : حالتی که UPS در آن کار می‌کند
STARTTIME: : تاریخ و زمان شروع به کار apcupsd
STATUS: : وضعیت UPS. یک یا چند مورد از موارد زیر (جداشده با فاصله): CAL TRIM BOOST ONLINE ONBATT OVERLOAD LOWBATT REPLACEBATT NOBATT SLAVE SLAVEDOWN
یا
COMMLOST
یا
SHUTTING DOWN
MASTERUPD: : آخرین باری که master یک به‌روزرسانی برای slave ارسال کرده است
ENDAPC: : تاریخ و زمانی که اطلاعات وضعیت نوشته شده است

Smart-UPS و Matrix-UPS (سیگنال‌دهی هوشمند)

LINEV: : ولتاژ خط ورودی فعلی
LOADPCT: : درصد ظرفیت بار استفاده‌شده UPS بر اساس تخمین UPS
BCHARGE: : درصد شارژ فعلی ظرفیت باتری
TIMELEFT: : زمان باقی‌مانده کارکرد روی باتری بر اساس تخمین UPS
MBATTCHG: : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم
MINTIMEL: : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم
MAXTIME: : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود
MAXLINEV: : حداکثر ولتاژ خط ورودی از زمان شروع apcupsd
MINLINEV: : حداقل ولتاژ خط ورودی (مشاهده‌شده) از زمان شروع apcupsd
OUTPUTV: : ولتاژ خروجی فعلی UPS
SENSE: : تنظیم فعلی حساسیت UPS برای نوسانات ولتاژ
DWAKE: : مدت زمانی که UPS پس از قطع برق، هنگام وصل مجدد برق صبر می‌کند
DSHUTD: : تاخیر پیش از خاموش شدن UPS پس از دریافت دستور
DLOWBATT: : سیگنال کاهش شارژ باتری زمانی که این مقدار زمان کارکرد باقی مانده باشد ارسال می‌شود
LOTRANS: : ولتاژ خط ورودی که پایین‌تر از آن UPS به باتری سوییچ می‌کند
HITRANS: : ولتاژ خط ورودی که بالاتر از آن UPS به باتری سوییچ می‌کند
RETPCT: : درصد شارژ باتری مورد نیاز پس از خاموشی برای برقراری مجدد برق
ITEMP: : دمای داخلی UPS بر حسب درجه سلسیوس
ALARMDEL: : مدت‌زمان تاخیر پیش از به صدا درآمدن هشدار صوتی UPS
BATTV: : ولتاژ فعلی باتری
LINEFREQ: : فرکانس خط فعلی بر حسب هرتز
LASTXFER: : دلیل آخرین انتقال به باتری از زمان شروع apcupsd
NUMXFERS: : تعداد دفعات انتقال به باتری از زمان شروع apcupsd
XONBATT: : تاریخ و زمان آخرین انتقال به باتری از زمان شروع apcupsd
TONBATT: : ثانیه‌های سپری‌شده فعلی روی باتری
CUMONBATT: : مجموع ثانیه‌های تجمعی روی باتری از زمان شروع apcupsd
XOFFBAT: : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان شروع apcupsd
SELFTEST: : تاریخ و زمان آخرین خودآزمایی (self test) از زمان شروع apcupsd
STESTI: : فاصله زمانی خودآزمایی
STATFLAG: : پرچم وضعیت UPS در مبنای شانزده (hex)
DIPSW: : تنظیمات فعلی سوییچ‌های DIP در UPS
REG1: : ثبات خطای ۱ در مبنای شانزده (hex)
REG2: : ثبات خطای ۲ در مبنای شانزده (hex)
REG3: : ثبات خطای ۳ در مبنای شانزده (hex)
MANDATE: : تاریخ ساخت UPS
SERIALNO: : شماره سریال UPS
BATTDATE: : تاریخ آخرین تعویض باتری (در صورت تنظیم شدن)
NOMOUTV: : ولتاژ خروجی اسمی برای تغذیه در هنگام کار روی باتری
NOMBATTV: : ولتاژ اسمی باتری
EXTBATTS: : تعداد باتری‌های خارجی (برای مدل‌های XL)
BADBATTS: : تعداد بسته‌های باتری خارجی معیوب (برای مدل‌های XL)
FIRMWARE: : نسخه سفت‌افزار (firmware) دستگاه UPS
APCMODEL: : اطلاعات مدل APC

Newer Back-UPS Pro (Smart Signalling)

LINEV: : ولتاژ خط ورودی فعلی
LOADPCT: : درصد ظرفیت بار استفاده‌شده UPS
MBATTCHG: : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم
MINTIMEL: : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم
MAXTIME: : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود
MAXLINEV: : حداکثر ولتاژ خط ورودی از زمان راه‌اندازی apcupsd
MINLINEV: : حداقل ولتاژ خط ورودی از زمان راه‌اندازی apcupsd
OUTPUTV: : ولتاژ خروجی فعلی UPS
BATTV: : ولتاژ شارژ فعلی باتری
STATFLAG: : پرچم وضعیت UPS در مبنای شانزده (hex)

Back-UPS RS 1500 (USB)

LINEV: : ولتاژ خط ورودی فعلی
LOADPCT: : درصد ظرفیت بار استفاده‌شده UPS
BCHARGE: : درصد شارژ فعلی ظرفیت باتری
TIMELEFT: : زمان باقی‌مانده کارکرد روی باتری بر اساس تخمین UPS
MBATTCHG: : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم
MINTIMEL: : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم
MAXTIME: : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود
*OUTPUTV: : ولتاژ خروجی فعلی UPS
*DWAKE: : مدت زمانی که UPS پس از قطع برق، هنگام وصل مجدد برق صبر می‌کند
*DSHUTD: : تاخیر پیش از خاموش شدن UPS پس از دریافت دستور
LOTRANS: : ولتاژ خط ورودی که پایین‌تر از آن UPS به باتری سوییچ می‌کند
HITRANS: : ولتاژ خط ورودی که بالاتر از آن UPS به باتری سوییچ می‌کند
*RETPCT: : درصد شارژ باتری مورد نیاز پس از خاموشی برای برقراری مجدد برق
*ITEMP: : دمای داخلی UPS بر حسب درجه سلسیوس
ALARMDEL: : مدت‌زمان تاخیر پیش از به صدا درآمدن هشدار صوتی UPS
BATTV: : ولتاژ فعلی باتری
*LINEFREQ: : فرکانس خط فعلی بر حسب هرتز
*LASTXFER: : دلیل آخرین انتقال به باتری از زمان راه‌اندازی apcupsd
NUMXFERS: : تعداد دفعات انتقال به باتری از زمان راه‌اندازی apcupsd
XONBATT: : تاریخ و زمان آخرین انتقال به باتری از زمان راه‌اندازی apcupsd
TONBATT: : ثانیه‌های سپری‌شده فعلی روی باتری
CUMONBATT: : مجموع ثانیه‌های تجمعی روی باتری از زمان راه‌اندازی apcupsd
XOFFBAT: : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان راه‌اندازی apcupsd
SELFTEST: : تاریخ و زمان آخرین خودآزمایی از زمان راه‌اندازی apcupsd
STATFLAG: : پرچم وضعیت UPS در مبنای شانزده (hex)
MANDATE: : تاریخ ساخت UPS
SERIALNO: : شماره سریال UPS
BATTDATE: : تاریخ آخرین تعویض باتری (در صورت تنظیم شدن)
NOMBATTV: : ولتاژ اسمی باتری
FIRMWARE: : نسخه سفت‌افزار (firmware) دستگاه UPS
APCMODEL: : اطلاعات مدل APC
* حضور این مورد به نسخه سفت‌افزار USB بستگی دارد.

کارت Web/SNMP (AP9716) یا PowerNet SNMP (AP9605) SmartSlot

LINEV: : ولتاژ خط ورودی فعلی
LOADPCT: : درصد ظرفیت بار استفاده‌شده UPS بر اساس تخمین UPS
BCHARGE: : درصد شارژ فعلی ظرفیت باتری
TIMELEFT: : زمان باقی‌مانده کارکرد روی باتری بر اساس تخمین UPS
MBATTCHG: : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم
MINTIMEL: : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم
MAXTIME: : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود
MAXLINEV: : حداکثر ولتاژ خط ورودی از زمان راه‌اندازی apcupsd
MINLINEV: : حداقل ولتاژ خط ورودی از زمان راه‌اندازی apcupsd
OUTPUTV: : ولتاژ خروجی UPS
SENSE: : تنظیم فعلی حساسیت UPS برای نوسانات ولتاژ
DWAKE: : مدت زمانی که UPS پس از قطع برق، هنگام وصل مجدد برق صبر می‌کند
DSHUTD: : تاخیر پیش از خاموش شدن UPS پس از دریافت دستور
DLOWBATT: : سیگنال کاهش شارژ باتری زمانی که این مقدار زمان کارکرد باقی مانده باشد ارسال می‌شود
LOTRANS: : ولتاژ خط ورودی که پایین‌تر از آن UPS به باتری سوییچ می‌کند
HITRANS: : ولتاژ خط ورودی که بالاتر از آن UPS به باتری سوییچ می‌کند
RETPCT: : درصد شارژ باتری مورد نیاز پس از خاموشی برای برقراری مجدد برق
ITEMP: : دمای داخلی UPS بر حسب درجه سلسیوس
ALARMDEL: : مدت‌زمان تاخیر پیش از به صدا درآمدن هشدار صوتی UPS
LINEFREQ: : فرکانس خط فعلی بر حسب هرتز
NUMXFERS: : تعداد دفعات انتقال به باتری از زمان راه‌اندازی apcupsd
TONBATT: : ثانیه‌های سپری‌شده فعلی روی باتری
CUMONBATT: : مجموع ثانیه‌های تجمعی روی باتری از زمان راه‌اندازی apcupsd
XOFFBATT: : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان راه‌اندازی apcupsd
STESTI: : فاصله زمانی خودآزمایی
STATFLAG: : پرچم وضعیت UPS در مبنای شانزده (hex)
DIPSW: : تنظیمات فعلی سوییچ‌های DIP در UPS
MANDATE: : تاریخ ساخت UPS
SERIALNO: : شماره سریال UPS
BATTDATE: : تاریخ آخرین تعویض باتری (در صورت تنظیم شدن)
NOMOUTV: : ولتاژ خروجی اسمی برای تغذیه در هنگام کار روی باتری
NOMPOWER: : توان خروجی اسمی بر حسب وات
EXTBATTS: : تعداد باتری‌های خارجی (برای مدل‌های XL)
BADBATTS: : تعداد بسته‌های باتری خارجی معیوب (برای مدل‌های XL)
FIRMWARE: : نسخه سفت‌افزار (firmware) دستگاه UPS
APCMODEL: : اطلاعات مدل APC

MBATTCHG: : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم
MINTIMEL: : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم
MAXTIME: : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود
NUMXFERS: : تعداد دفعات انتقال به باتری از زمان راه‌اندازی apcupsd
TONBATT: : ثانیه‌های سپری‌شده فعلی روی باتری
CUMONBATT: : مجموع ثانیه‌های تجمعی روی باتری از زمان راه‌اندازی apcupsd
XOFFBATT: : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان راه‌اندازی apcupsd
STATFLAG: : پرچم وضعیت UPS در مبنای شانزده (hex)