.\" manual page [] for apctest version 3.14.6 .Dd March 28, 2014 .Dt APCACCESS 8 .Os apcaccess v3.14.6 .Sh "نام (NAME)" .Nm apcaccess .Nd دریافت وضعیت UPS از دیمن apcupsd .Sh "خلاصه دستور (SYNOPSIS)" .Nm [-f ] [-h [:]] [-p ] [-u] [] [[:]] .Sh "توضیحات (DESCRIPTION)" .Nm برنامه‌ای است که در صورت نصب بودن دیمن .Xr apcupsd 8 و پیکربندی و اجرای صحیح آن، وضعیت کامل اکثر دستگاه‌های UPS شرکت American Power Conversion Corp. (APC) را چاپ می‌کند. این برنامه می‌تواند به اطلاعات وضعیت هر UPS شرکت APC متصل به میزبان محلی (localhost) یا متصل به هر رایانه دیگری در شبکه که apcupsd را در حالت NIS اجرا می‌کند، دسترسی داشته باشد. .Pp گزینه‌های خط فرمان عبارتند از: .Bl -hang -width "" .It -f فایل پیکربندی apcupsd (پیش‌فرض معمولاً /etc/apcupsd/apcupsd.conf است) .It -h نام میزبان (hostname) و پورت apcupsd برای برقراری ارتباط. نام میزبان و پورت پیش‌فرض از فایل پیکربندی دریافت می‌شوند. .It -p فقط مقدار پارامتر مشخص‌شده را گزارش می‌دهد، به‌جای تمام پارامترها و مقادیر. .It -u فیلد واحدها را برای تجزیه آسان‌تر توسط اسکریپت‌ها حذف می‌کند. .It یک دستور اختیاری، مگر اینکه نام میزبان نیز تعیین شده باشد. تنها دستور پیاده‌سازی‌شده .Em status\& است که کوتاه‌نوشت دستور .Em status\& localhost:3551 می‌باشد. این دستور خروجی کاملی از اطلاعات وضعیت موجود برای UPS مربوطه را تولید می‌کند. .It یک نام میزبان اختیاری که می‌تواند یک نام ماشین ساده، نام دامنه کاملاً واجد شرایط (FQDN) یا یک آدرس IP باشد. .It : یک شماره پورت اختیاری در صورتی که آرگومان نام میزبان مشخص شده باشد. پیش‌فرض 3551 است که شماره پورت رسمی اختصاص‌یافته توسط .Tn IANA برای سرور NIS در apcupsd می‌باشد. نام میزبان و پورت پیش‌فرض از فایل پیکربندی دریافت می‌شوند. .El .Pp .Nm از Network Information Server (NIS) داخلی apcupsd -- که هیچ ارتباطی با سرویس NIS/YP شرکت Sun ندارد -- برای دریافت اطلاعات وضعیت فعلی از UPS روی رایانه محلی یا راه دور استفاده می‌کند. بنابراین، ضروری است که دستورالعمل‌های پیکربندی زیر: .Pp .Bl -item -compact .It NETSERVER on .It NISPORT 3551 .El .Pp در فایل پیکربندی .Pa /etc/apcupsd/apcupsd.conf قرار داشته باشند تا Network Information Server در دسترس باشد. همچنین ممکن است به قوانین دیوار آتش (firewall) برای دسترسی مناسب به شبکه نیاز باشد. .Sh "قالب گزارش وضعیت (STATUS REPORT FORMAT)" قالب خروجی گزارش وضعیت به‌صورت متن ساده ASCII است. عموماً در هر خط از خروجی یک بخش از اطلاعات قرار دارد. محتوا بسته به مدل UPS مورد استفاده و در برخی موارد، نسخه سفت‌افزار (firmware) متفاوت است. .Sh "مثال‌ها (EXAMPLES)" در ادامه نمونه‌ای از خروجی وضعیت که ممکن است برای مدل‌های مشخص‌شده UPS تولید شود، آورده شده است. .Pp .Ss همه مدل‌ها (All models) .Bl -hang -width "xxxxxxxxxx" -compact .It APC : نسخه، تعداد رکوردها و تعداد بایت‌های پس از آن .It DATE : تاریخ و زمان آخرین به‌روزرسانی از UPS .It HOSTNAME : نام میزبان رایانه‌ای که apcupsd را اجرا می‌کند .It VERSION : شماره نسخه apcupsd، تاریخ و سیستم‌عامل .It UPSNAME : نام UPS از فایل پیکربندی (dumb) یا EEPROM (smart) .It CABLE : نوع کابل مشخص‌شده در فایل پیکربندی .It MODEL : مدل UPS برگرفته از اطلاعات UPS .It UPSMODE : حالتی که UPS در آن کار می‌کند .It STARTTIME : تاریخ و زمان شروع به کار apcupsd .It STATUS : وضعیت UPS. یک یا چند مورد از موارد زیر (جداشده با فاصله): CAL TRIM BOOST ONLINE ONBATT OVERLOAD LOWBATT REPLACEBATT NOBATT SLAVE SLAVEDOWN .br یا .br COMMLOST .br یا .br SHUTTING DOWN .It MASTERUPD : آخرین باری که master یک به‌روزرسانی برای slave ارسال کرده است .It ENDAPC : تاریخ و زمانی که اطلاعات وضعیت نوشته شده است .El .Ss Smart-UPS و Matrix-UPS (سیگنال‌دهی هوشمند) .Bl -hang -width "xxxxxxxx"-compact .It LINEV : ولتاژ خط ورودی فعلی .It LOADPCT : درصد ظرفیت بار استفاده‌شده UPS بر اساس تخمین UPS .It BCHARGE : درصد شارژ فعلی ظرفیت باتری .It TIMELEFT : زمان باقی‌مانده کارکرد روی باتری بر اساس تخمین UPS .It MBATTCHG : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم .It MINTIMEL : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم .It MAXTIME : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود .It MAXLINEV : حداکثر ولتاژ خط ورودی از زمان شروع apcupsd .It MINLINEV : حداقل ولتاژ خط ورودی (مشاهده‌شده) از زمان شروع apcupsd .It OUTPUTV : ولتاژ خروجی فعلی UPS .It SENSE : تنظیم فعلی حساسیت UPS برای نوسانات ولتاژ .It DWAKE : مدت زمانی که UPS پس از قطع برق، هنگام وصل مجدد برق صبر می‌کند .It DSHUTD : تاخیر پیش از خاموش شدن UPS پس از دریافت دستور .It DLOWBATT : سیگنال کاهش شارژ باتری زمانی که این مقدار زمان کارکرد باقی مانده باشد ارسال می‌شود .It LOTRANS : ولتاژ خط ورودی که پایین‌تر از آن UPS به باتری سوییچ می‌کند .It HITRANS : ولتاژ خط ورودی که بالاتر از آن UPS به باتری سوییچ می‌کند .It RETPCT : درصد شارژ باتری مورد نیاز پس از خاموشی برای برقراری مجدد برق .It ITEMP : دمای داخلی UPS بر حسب درجه سلسیوس .It ALARMDEL : مدت‌زمان تاخیر پیش از به صدا درآمدن هشدار صوتی UPS .It BATTV : ولتاژ فعلی باتری .It LINEFREQ : فرکانس خط فعلی بر حسب هرتز .It LASTXFER : دلیل آخرین انتقال به باتری از زمان شروع apcupsd .It NUMXFERS : تعداد دفعات انتقال به باتری از زمان شروع apcupsd .It XONBATT : تاریخ و زمان آخرین انتقال به باتری از زمان شروع apcupsd .It TONBATT : ثانیه‌های سپری‌شده فعلی روی باتری .It CUMONBATT : مجموع ثانیه‌های تجمعی روی باتری از زمان شروع apcupsd .It XOFFBAT : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان شروع apcupsd .It SELFTEST : تاریخ و زمان آخرین خودآزمایی (self test) از زمان شروع apcupsd .It STESTI : فاصله زمانی خودآزمایی .It STATFLAG : پرچم وضعیت UPS در مبنای شانزده (hex) .It DIPSW : تنظیمات فعلی سوییچ‌های DIP در UPS .It REG1 : ثبات خطای ۱ در مبنای شانزده (hex) .It REG2 : ثبات خطای ۲ در مبنای شانزده (hex) .It REG3 : ثبات خطای ۳ در مبنای شانزده (hex) .It MANDATE : تاریخ ساخت UPS .It SERIALNO : شماره سریال UPS .It BATTDATE : تاریخ آخرین تعویض باتری (در صورت تنظیم شدن) .It NOMOUTV : ولتاژ خروجی اسمی برای تغذیه در هنگام کار روی باتری .It NOMBATTV : ولتاژ اسمی باتری .It EXTBATTS : تعداد باتری‌های خارجی (برای مدل‌های XL) .It BADBATTS : تعداد بسته‌های باتری خارجی معیوب (برای مدل‌های XL) .It FIRMWARE : نسخه سفت‌افزار (firmware) دستگاه UPS .It APCMODEL : اطلاعات مدل APC .El .Ss Newer Back-UPS Pro (Smart Signalling) .Bl -hang -width "xxxxxxxx"-compact .It LINEV : ولتاژ خط ورودی فعلی .It LOADPCT : درصد ظرفیت بار استفاده‌شده UPS .It MBATTCHG : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم .It MINTIMEL : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم .It MAXTIME : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود .It MAXLINEV : حداکثر ولتاژ خط ورودی از زمان راه‌اندازی apcupsd .It MINLINEV : حداقل ولتاژ خط ورودی از زمان راه‌اندازی apcupsd .It OUTPUTV : ولتاژ خروجی فعلی UPS .It BATTV : ولتاژ شارژ فعلی باتری .It STATFLAG : پرچم وضعیت UPS در مبنای شانزده (hex) .El .Ss Back-UPS RS 1500 (USB) .Bl -hang -width "xxxxxxxx"-compact .It LINEV : ولتاژ خط ورودی فعلی .It LOADPCT : درصد ظرفیت بار استفاده‌شده UPS .It BCHARGE : درصد شارژ فعلی ظرفیت باتری .It TIMELEFT : زمان باقی‌مانده کارکرد روی باتری بر اساس تخمین UPS .It MBATTCHG : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم .It MINTIMEL : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم .It MAXTIME : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود .It *OUTPUTV : ولتاژ خروجی فعلی UPS .It *DWAKE : مدت زمانی که UPS پس از قطع برق، هنگام وصل مجدد برق صبر می‌کند .It *DSHUTD : تاخیر پیش از خاموش شدن UPS پس از دریافت دستور .It LOTRANS : ولتاژ خط ورودی که پایین‌تر از آن UPS به باتری سوییچ می‌کند .It HITRANS : ولتاژ خط ورودی که بالاتر از آن UPS به باتری سوییچ می‌کند .It *RETPCT : درصد شارژ باتری مورد نیاز پس از خاموشی برای برقراری مجدد برق .It *ITEMP : دمای داخلی UPS بر حسب درجه سلسیوس .It ALARMDEL : مدت‌زمان تاخیر پیش از به صدا درآمدن هشدار صوتی UPS .It BATTV : ولتاژ فعلی باتری .It *LINEFREQ : فرکانس خط فعلی بر حسب هرتز .It *LASTXFER : دلیل آخرین انتقال به باتری از زمان راه‌اندازی apcupsd .It NUMXFERS : تعداد دفعات انتقال به باتری از زمان راه‌اندازی apcupsd .It XONBATT : تاریخ و زمان آخرین انتقال به باتری از زمان راه‌اندازی apcupsd .It TONBATT : ثانیه‌های سپری‌شده فعلی روی باتری .It CUMONBATT : مجموع ثانیه‌های تجمعی روی باتری از زمان راه‌اندازی apcupsd .It XOFFBAT : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان راه‌اندازی apcupsd .It SELFTEST : تاریخ و زمان آخرین خودآزمایی از زمان راه‌اندازی apcupsd .It STATFLAG : پرچم وضعیت UPS در مبنای شانزده (hex) .It MANDATE : تاریخ ساخت UPS .It SERIALNO : شماره سریال UPS .It BATTDATE : تاریخ آخرین تعویض باتری (در صورت تنظیم شدن) .It NOMBATTV : ولتاژ اسمی باتری .It FIRMWARE : نسخه سفت‌افزار (firmware) دستگاه UPS .It APCMODEL : اطلاعات مدل APC .It * حضور این مورد به نسخه سفت‌افزار USB بستگی دارد. .El .Ss کارت Web/SNMP (AP9716) یا PowerNet SNMP (AP9605) SmartSlot .Bl -hang -width "xxxxxxxx"-compact .It LINEV : ولتاژ خط ورودی فعلی .It LOADPCT : درصد ظرفیت بار استفاده‌شده UPS بر اساس تخمین UPS .It BCHARGE : درصد شارژ فعلی ظرفیت باتری .It TIMELEFT : زمان باقی‌مانده کارکرد روی باتری بر اساس تخمین UPS .It MBATTCHG : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم .It MINTIMEL : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم .It MAXTIME : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود .It MAXLINEV : حداکثر ولتاژ خط ورودی از زمان راه‌اندازی apcupsd .It MINLINEV : حداقل ولتاژ خط ورودی از زمان راه‌اندازی apcupsd .It OUTPUTV : ولتاژ خروجی UPS .It SENSE : تنظیم فعلی حساسیت UPS برای نوسانات ولتاژ .It DWAKE : مدت زمانی که UPS پس از قطع برق، هنگام وصل مجدد برق صبر می‌کند .It DSHUTD : تاخیر پیش از خاموش شدن UPS پس از دریافت دستور .It DLOWBATT : سیگنال کاهش شارژ باتری زمانی که این مقدار زمان کارکرد باقی مانده باشد ارسال می‌شود .It LOTRANS : ولتاژ خط ورودی که پایین‌تر از آن UPS به باتری سوییچ می‌کند .It HITRANS : ولتاژ خط ورودی که بالاتر از آن UPS به باتری سوییچ می‌کند .It RETPCT : درصد شارژ باتری مورد نیاز پس از خاموشی برای برقراری مجدد برق .It ITEMP : دمای داخلی UPS بر حسب درجه سلسیوس .It ALARMDEL : مدت‌زمان تاخیر پیش از به صدا درآمدن هشدار صوتی UPS .It LINEFREQ : فرکانس خط فعلی بر حسب هرتز .It NUMXFERS : تعداد دفعات انتقال به باتری از زمان راه‌اندازی apcupsd .It TONBATT : ثانیه‌های سپری‌شده فعلی روی باتری .It CUMONBATT : مجموع ثانیه‌های تجمعی روی باتری از زمان راه‌اندازی apcupsd .It XOFFBATT : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان راه‌اندازی apcupsd .It STESTI : فاصله زمانی خودآزمایی .It STATFLAG : پرچم وضعیت UPS در مبنای شانزده (hex) .It DIPSW : تنظیمات فعلی سوییچ‌های DIP در UPS .It MANDATE : تاریخ ساخت UPS .It SERIALNO : شماره سریال UPS .It BATTDATE : تاریخ آخرین تعویض باتری (در صورت تنظیم شدن) .It NOMOUTV : ولتاژ خروجی اسمی برای تغذیه در هنگام کار روی باتری .It NOMPOWER : توان خروجی اسمی بر حسب وات .It EXTBATTS : تعداد باتری‌های خارجی (برای مدل‌های XL) .It BADBATTS : تعداد بسته‌های باتری خارجی معیوب (برای مدل‌های XL) .It FIRMWARE : نسخه سفت‌افزار (firmware) دستگاه UPS .It APCMODEL : اطلاعات مدل APC .El .Ss Share-UPS (AP9270) (درگاه پایه) .Bl -hang -width "xxxxxxxx"-compact .It MBATTCHG : حداقل درصد شارژ باتری (BCHARGE) مورد نیاز برای خاموش شدن سیستم .It MINTIMEL : حداقل زمان کارکرد باتری (MINUTES) مورد نیاز برای خاموش شدن سیستم .It MAXTIME : حداکثر زمان کارکرد باتری (TIMEOUT) که پس از آن سیستم خاموش می‌شود .It NUMXFERS : تعداد دفعات انتقال به باتری از زمان راه‌اندازی apcupsd .It TONBATT : ثانیه‌های سپری‌شده فعلی روی باتری .It CUMONBATT : مجموع ثانیه‌های تجمعی روی باتری از زمان راه‌اندازی apcupsd .It XOFFBATT : تاریخ و زمان آخرین خروج از وضعیت باتری از زمان راه‌اندازی apcupsd .It STATFLAG : پرچم وضعیت UPS در مبنای شانزده (hex) .El .Ss کارت SmartSlot پایش محیطی UPS (AP9612TH) .Bl -hang -width "xxxxxxxx"-compact .It HUMIDITY : رطوبت محیط .It AMBTEMP : دمای محیط .El .Ss Back-UPS Pro و Smart-UPS v/s (سیگنال‌دهی هوشمند) .Bl -hang -width "xxxxxxxx"-compact .It LINEFAIL : وضعیت ولتاژ خط ورودی. .It BATTSTAT : وضعیت باتری. .It LASTXFER : آخرین انتقال (مشاهده‌شده) به باتری. .El .Ss Back-UPS و Net-UPS (سیگنال‌دهی ساده) .Bl -hang -width "xxxxxxxx"-compact .It LINEFAIL : وضعیت ولتاژ خط ورودی. .It BATTSTAT : وضعیت باتری. .It STATFLAG : پرچم وضعیت UPS در مبنای شانزده (hex). .El .Sh "فایل‌ها (FILES)" .Pa /etc/apcupsd/apcupsd.conf .Sh "همچنین ببینید (SEE ALSO)" .Xr apcupsd.conf 5 , .Xr apcupsd 8 . .Pp راهنمای HTML برنامه apcupsd نصب‌شده روی سیستم شما یا موجود به‌صورت برخط در http://www.apcupsd.org .Sh "نویسندگان (AUTHORS)" .Ss این صفحه .An Trevor Roydhouse .Ss نرم‌افزار .An Adam Kropelin (مدیر پروژه و نگهدارنده فعلی کد) .An Kern Sibbald (مدیر پروژه و نگهدارنده پیشین کد) .An Riccardo Facchetti (مدیر پروژه و نگهدارنده پیشین کد) .An Andre M. Hedrick (بنیان‌گذار پروژه و نگهدارنده پیشین کد) .Ss مشارکت‌کنندگان تعداد بسیار زیادی از کاربران که زمان و انرژی خود را وقف این پروژه کرده‌اند -- با سپاس.