نام (NAME)

belkinunv - درایور برای «Universal UPS» بلکین و دستگاه‌های سازگار

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

belkinunv -h

belkinunv -a UPS_NAME [OPTIONS]

سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)

درایور belkinunv برای کارکرد با مدل‌های F6C800-UNV و F6C120-UNV از Belkin Universal UPS شناخته شده است و انتظار می‌رود با سایر مدل‌های Belkin Universal UPS نیز کار کند. این درایور تنها از ارتباط سریال پشتیبانی می‌کند، نه USB.

مدل‌های Trust UPS و دستگاه‌های قدیمی‌تر Belkin توسط این درایور پشتیبانی نمی‌شوند، و همچنین مدل‌های Belkin Home Office (مانند F6H500-SER و غیره) نیز پشتیبانی نمی‌شوند. با این حال، برخی از مدل‌های Belkin مانند Regulator Pro توسط درایور belkin(8) پشتیبانی می‌شوند، و مدل‌های Home Office با استفاده از درایور genericups(8) با upstype=7 پشتیبانی می‌شوند.

راهکار خاموش‌سازی نرم (SOFT SHUTDOWN WORKAROUND)

یک مشکل در Belkin Universal UPS این است که نمی‌تواند وارد وضعیت خاموش‌سازی نرم (قطع بار خروجی تا زمان بازگشت برق شهر AC) شود، مگر اینکه باتری‌ها کاملاً خالی شده باشند. از این رو، نمی‌توان پس از خاموش شدن سیستم‌عامل صرفاً UPS را خاموش کرد؛ زیرا با وصل مجدد برق، روشن نخواهد شد. بنابراین، درایور belkinunv هرگز نباید با گزینه -k استفاده شود. در عوض، گزینه -x wait به عنوان یک راهکار ارائه شده است.

هنگامی که با گزینه -x wait فراخوانی شود، belkinunv به عنوان یک برنامه مستقل عمل می‌کند (یعنی به پس‌زمینه فورک نمی‌شود). این برنامه یک وظیفه ساده را انجام می‌دهد: به UPS متصل می‌شود، تا زمان بازگشت برق شهر AC منتظر می‌ماند، و سپس با وضعیت 0 خارج می‌شود.

هدف این است که این گزینه در اسکریپت خاموش‌سازی به این شکل استفاده شود: در طول فرآیند خاموش شدن سیستم، پس از آنکه تمام فایل‌سیستم‌ها به صورت فقط‌خواندنی مجدداً مانت شدند و درست پیش از متوقف شدن عادی سیستم: فایل /etc/killpower (یا مشابه آن) را بررسی کنید تا ببینید آیا این خاموش‌سازی توسط upsmon(8) ایجاد شده است یا خیر، و در صورت مثبت بودن، belkinunv -x wait را فراخوانی کنید. اگر برق شهر AC وصل شود، belkinunv خارج می‌شود و ساختار باید طوری ترتیب داده شود که در این حالت سیستم مجدداً راه‌اندازی (reboot) شود. اگر برق شهر AC وصل نشود، شارژ باتری UPS در نهایت به پایان می‌رسد، منبع تغذیه رایانه قطع می‌شود و UPS به حالت خاموش‌سازی نرم می‌رود؛ به این معنی که پس از وصل مجدد برق، همه چیز به درستی راه‌اندازی مجدد خواهد شد. در هر دو حالت، از بروز بن‌بست (deadlock) جلوگیری می‌شود.

علاوه بر این، اگر یک آرگومان عدد صحیح اختیاری به گزینه -x wait داده شود، این کار باعث می‌شود belkinunv نه‌تنها منتظر وصل بودن برق شهر AC، بلکه منتظر رسیدن شارژ باتری به سطح تعیین‌شده نیز بماند. من از این به عنوان بخشی از اسکریپت‌های راه‌اندازی خود استفاده می‌کنم تا اطمینان یابم که باتری‌ها پیش از ادامه بوت رایانه به میزان کافی شارژ شده‌اند. این باید در بخش‌های بسیار ابتدایی اسکریپت راه‌اندازی قرار گیرد، پیش از آنکه هر فایل‌سیستمی به صورت خواندن/نوشتن مانت شود و پیش از آنکه هرگونه بررسی فایل‌سیستم انجام گیرد.

چندین گزینه -x دیگر برای تنظیم دقیق این رفتار فراهم شده است. برای توضیحات دقیق به گزینه‌های زیر مراجعه کنید. برای نمونه‌هایی از نحوه استفاده از belkinunv در اسکریپت‌های خاموش‌سازی و راه‌اندازی، به بخش مثال‌ها در ادامه مراجعه کنید.

گزینه‌ها (OPTIONS)

همچنین برای گزینه‌های عمومی nutupsdrv(8) را ببینید. هرگز از گزینه -k با این درایور استفاده نکنید؛ زیرا به درستی کار نمی‌کند.

-x wait[=level]

-x nohang

-x flash

-x silent

-x dumbterm

متغیرها (VARIABLES)

battery.charge, battery.runtime

battery.voltage, battery.voltage.nominal, input.frequency, input.frequency.nominal

input.sensitivity

input.transfer.high

input.transfer.low

input.voltage, input.voltage.maximum, input.voltage.minimum, input.voltage.nominal, output.frequency, output.voltage, ups.beeper.status

ups.firmware, ups.load, ups.model, ups.power.nominal

ups.status

ups.temperature

ups.test.result, ups.delay.restart

ups.delay.shutdown

ups.type

دستورات (COMMANDS)

beeper.enable, beeper.disable, beeper.mute

reset.input.minmax

shutdown.reboot

shutdown.reboot.graceful

shutdown.stayoff

test.battery.start, test.battery.stop

test.failure.start, test.failure.stop

پرچم‌های وضعیت (STATUS FLAGS)

OB

OFF

OL

ACFAIL

OVER

OVERHEAT

COMMFAULT

LB

CHRG

DEPLETED

RB

مثال‌ها (EXAMPLES)

در اینجا مثالی از نحوه استفاده از belkinunv در اسکریپت خاموش‌سازی رایانه آورده شده است. این دستورات باید در واپسین بخش اسکریپت خاموش‌سازی، پس از مانت شدن تمام فایل‌سیستم‌ها به صورت فقط‌خواندنی، و درست پیش از متوقف شدن رایانه قرار گیرند. توجه داشته باشید که belkinunv باید در دایرکتوری‌ای نصب شده باشد که در آن نقطه همچنان قابل خواندن باشد.

# NEAR END OF SHUTDOWN SCRIPT:
# if shutdown was caused by UPS, perform Belkin UPS workaround.
if [ -f /etc/killpower ] || /usr/sbin/upsmon -K ; then
   echo "Waiting for AC power, or for UPS batteries to run out..."
   /usr/bin/belkinunv -x wait /dev/ttyS1
   # we get here if the power came back on. Reboot.
   echo "Power is back. Rebooting..."
   reboot
fi

و در اینجا مثالی از نحوه استفاده از belkinunv در اسکریپت راه‌اندازی آورده شده است. این دستورات باید نزدیک به ابتدای اسکریپت راه‌اندازی، پیش از آنکه هر فایل‌سیستمی به صورت خواندن/نوشتن مانت شود، و پیش از آنکه هرگونه بررسی صحت فایل‌سیستم انجام گیرد، قرار داده شوند.

# NEAR BEGINNING OF STARTUP SCRIPT:
# if we are recovering from a power failure, wait for the UPS to
# charge to a comfortable level before writing anything to disk
if [ -f /etc/killpower ] || /usr/sbin/upsmon -K ; then
   echo "Waiting for UPS battery charge to reach 60%..."
   /usr/bin/belkinunv -x wait=60 -x nohang /dev/ttyS1
fi

وضعیت خروج (EXIT STATUS)

هنگامی که به طور عادی استفاده شود، belkinunv به پس‌زمینه فورک می‌شود و پیام‌های تشخیصی آن همانند تمام درایورهای NUT است؛ nutupsdrv(8) را ببینید.

هنگامی که با گزینه -x wait استفاده شود، وضعیت خروج معمولاً 0 است. اگر گزینه -x nohang نیز مشخص شده باشد، وضعیت خروج 1 نشان‌دهنده از دست رفتن ارتباط با UPS است. اگر گزینه -x flash مشخص شده باشد، وضعیت خروج 2 نشان‌دهنده ناموفق بودن خاموش‌سازی زمان‌بندی‌شده است.

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

این درایور از هیچ تنظیمات اضافی در ups.conf(5) پشتیبانی نمی‌کند.

نویسندگان (AUTHORS)

Peter Selinger <selinger@users.sourceforge.net>

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