UPSMON.CONF(5) NUT Manual UPSMON.CONF(5)

upsmon.conf - پیکربندی کلاینت upsmon ابزارهای Network UPS Tools (NUT)

وظیفه اصلی این فایل تعریف سیستم‌هایی است که upsmon(8) آن‌ها را پایش خواهد کرد، و همچنین مشخص کردن نحوه خاموش کردن سیستم در زمان‌های ضروری است. این فایل حاوی گذرواژه‌ها خواهد بود، بنابراین آن را امن نگه دارید. در حالت ایده‌آل، فقط فرایند upsmon باید قادر به خواندن آن باشد.

یک پیکربندی حداقلی باید دست‌کم شامل یک دستور MONITOR، یک MINSUPPLIES (اگر این سیستم فقط سایر سرورهای NUT را پایش می‌کند، می‌تواند 0 باشد)، و یک POWERDOWNFLAG باشد (اگر این دستگاه یک سیستم «اصلی» (primary) متصل به UPS است و فرمان قطع برق خاموشی دیرهنگام آن را در مواقع اضطراری هدایت می‌کند).

علاوه بر این، مقادیر پیکربندی اختیاری دیگری نیز می‌توانند در این فایل تنظیم شوند.

•محتوای این فایل باید تماماً ASCII باشد (کدهای نویسه‌ای که در این محدوده نباشند با یک پیام هشدار نادیده گرفته می‌شوند).
•مجوزهای دسترسی کاربر زمان اجرا به این فایل (و شاید پوشه‌ای که در آن قرار دارد) را به گونه‌ای متوازن کنید که فقط upsmon قادر به خواندن آن باشد؛ دسترسی نوشتن لازم نیست. معمولاً از chown root:nut و chmod 640 برای تنظیم مجوزهای دسترسی قابل قبول فایل استفاده می‌شود.
•بسته‌ها (و دستورالعمل‌های ساخت) معمولاً یک مجموعه از حساب‌های کاربری و گروهی را برای NUT آماده می‌کنند. ساخت‌های سفارشی با پیکربندی حداقلی ممکن است حتی از nobody:nogroup یا موارد مشابه استفاده کنند که ذاتاً ناامن است.
•در سیستم‌هایی با دغدغه‌های امنیتی بیشتر، درایورهای NUT، سرور داده و هرگونه کلاینت پایش، ثبت وقایع و غیره باید تحت حساب‌های کاربری جداگانه اجرا شوند. این کار نیازمند آن است که برخی دیمن‌ها از تنظیمات سفارشی user، group، RUN_AS_USER و/یا RUN_AS_GROUP برای بازنویسی و جایگزینی مقدار توکار استفاده کنند.
•امنیت نسخه‌های پشتیبان این فایل، برای مثال فایل‌های آرشیوی که ممکن است در آن‌ها قرار گیرد را نیز مد نظر داشته باشید.

DEADTIME seconds

upsmon اجازه می‌دهد یک UPS به مدت این تعداد ثانیه ناپدید شود پیش از آنکه آن را «مرده» (dead) اعلام کند. مقدار پیش‌فرض ۱۵ ثانیه است.

upsmon نیازمند آن است که یک UPS هر چند ثانیه یک‌بار اطلاعات وضعیت را ارائه دهد (POLLFREQ و POLLFREQALERT را ببینید) تا همه چیز به‌روز بماند. اگر واکشی وضعیت ناموفق باشد، UPS به عنوان بیات (stale) علامت‌گذاری می‌شود. اگر بیش از DEADTIME ثانیه در وضعیت بیات باقی بماند، به عنوان مرده (dead) علامت‌گذاری خواهد شد.

یک UPS مرده که آخرین وضعیت شناخته‌شده آن کارکرد با باتری بوده است، فرض می‌شود به وضعیت باتری ضعیف (low battery) تغییر یافته است. اگر این UPS بخش بحرانی توان سیستم شما را تامین کند، این امر ممکن است سیستم را مجبور به خاموش شدن کند. این کار ممکن است مخرب به نظر برسد، اما راه جایگزین، پیشروی کورکورانه به سوی ناکجاآباد و از کار افتادن ناگهانی سیستم هنگام قطع کامل برق است.

نکته: مقدار DEADTIME باید مضربی از POLLFREQ و POLLFREQALERT باشد. در غیر این صورت، تنها به این دلیل که upsmon با سرعت کافی آن‌ها را نظرسنجی نمی‌کند، با UPSهای «مرده» مواجه خواهید شد. یک قانون سرانگشتی: مقدار بزرگتر از میان دو مقدار POLLFREQ را بگیرید و آن را در ۳ ضرب کنید.

FINALDELAY seconds

هنگام مدیریت خاموشی اجباری (FSD) به دلیل وضعیت بحرانی UPS یا سیگنال صریح کاربر، upsmon پس از ارسال پیام NOTIFY_SHUTDOWN برای هشدار به کاربران، به مدت این زمان منتظر می‌ماند. پس از سپری شدن این زمان‌سنج، دستور SHUTDOWNCMD شما را اجرا می‌کند. به طور پیش‌فرض این مقدار روی ۵ ثانیه تنظیم شده است.

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

به عنوان راه جایگزین، می‌توانید این مقدار را بسیار پایین تنظیم کنید تا هنگام رسیدن زمان خاموشی معطل نشوید. برخی UPSها هشدار چندانی برای باتری ضعیف ارائه نمی‌دهند و برای یک خاموشی ایمن به مقدار 0 در اینجا نیاز خواهند داشت.


نکته
اگر مقدار FINALDELAY در سیستم ثانویه بزرگتر از HOSTSYNC در سیستم اولیه باشد، سیستم اولیه از انتظار برای قطع اتصال آن upsmon ثانویه منصرف خواهد شد.

HOSTSYNC seconds

upsmon در حالت اولیه (primary) در طول شرایط خاموشی، حداکثر تا این تعداد ثانیه منتظر قطع اتصال سیستم‌های ثانویه می‌ماند. به طور پیش‌فرض، این مقدار ۱۵ ثانیه است.

هنگامی که یک UPS وارد وضعیت بحرانی می‌شود (روی باتری + باتری ضعیف، یا "FSD": خاموشی اجباری)، سیستم‌های ثانویه باید بلافاصله اتصال خود را قطع کرده و خاموش شوند. زمان‌سنج HOSTSYNC مانع از آن می‌شود که اگر یکی از سیستم‌های ثانویه گیر کرد، upsmon اولیه تا ابد منتظر بماند.

این مقدار همچنین برای جلوگیری از معطل ماندن سیستم‌های ثانویه در صورتی که سیستم اولیه به موقع پاسخ ندهد استفاده می‌شود. پس از اینکه UPS بحرانی شد، سیستم ثانویه تا HOSTSYNC ثانیه منتظر می‌ماند تا سیستم اولیه فلگ FSD را تنظیم کند. اگر آن زمان‌سنج منقضی شود، upsmon ثانویه فرض می‌کند که سیستم اولیه (یا مسیر ارتباطی به آن) دچار مشکل شده است و به هر حال خاموش خواهد شد.

این کار مانع از آن می‌شود که سیستم‌های ثانویه در طول یک تغییر وضعیت کوتاه‌مدت به "OB LB" و بازگشت از آن (که سیستم‌های ثانویه می‌بینند اما سیستم اولیه متوجه آن نمی‌شود) خاموش شوند.

MINSUPPLIES num

تعداد منابع تغذیه‌ای را تعیین کنید که برای روشن ماندن این سیستم باید برق دریافت کنند. رایانه‌های معمولی تنها یک منبع تغذیه دارند، بنابراین مقدار پیش‌فرض 1 قابل قبول است.

سیستم‌های سرور بزرگ/گران‌قیمت معمولاً منابع تغذیه بیشتری دارند و می‌توانند با قطع بودن چندتای آن‌ها نیز به کار خود ادامه دهند. به عنوان مثال، سرور HP NetServer LH4 می‌تواند با ۲ منبع تغذیه از ۴ منبع کار کند، بنابراین شما آن را روی 2 تنظیم می‌کنید. ایده اصلی این است که دستگاه تا جای ممکن روشن بماند، درست است؟

بدیهی است که برای منطقی بودن این سازوکار، باید منابع تغذیه افزونه را روی مدارهای UPS مختلف قرار دهید! برای اطلاعات بیشتر و ایده‌هایی در مورد نحوه استفاده از این ویژگی، big-servers.txt را در زیرپوشه docs ببینید.

همچنین بخش مربوط به «مقادیر توان» در upsmon(8) را ببینید.

MONITOR system powervalue username password type

هر UPS که نیاز به پایش آن دارید باید دارای یک خط MONITOR باشد. نیازی نیست که همه آن‌ها برق سیستم اجراکننده upsmon را تامین کنند. اگر می‌خواهید بتوانید اعلان‌های مربوط به تغییر وضعیت آن‌ها را ارسال کنید، می‌توانید سیستم‌های دیگر را نیز پایش کنید.

شما باید حداقل یک دستور MONITOR در upsmon.conf داشته باشید.

•system شناسه یک UPS است. این شناسه به این فرمت است:

<upsname>[@<hostname>[:<port>]]

نام میزبان پیش‌فرض "localhost" است. چند مثال:

•عبارت "su700@mybox" به معنای یک UPS با نام "su700" روی سیستمی به نام "mybox" است. این فرمت معمول است.
•عبارت "fenton@bigbox:5678" یک UPS به نام "fenton" روی سیستمی با نام "bigbox" است که upsd(8) را روی درگاه "5678" اجرا می‌کند.
•powervalue یک عدد صحیح است که نمایانگر تعداد منابع تغذیه‌ای است که UPS در این سیستم تغذیه می‌کند. اکثر رایانه‌های معمولی یک منبع تغذیه دارند و UPS آن را تغذیه می‌کند، بنابراین این مقدار 1 خواهد بود. برای داشتن هر مقداری بالاتر از این، به یک سیستم بسیار بزرگ یا خاص نیاز دارید.

اگر می‌خواهید یک UPS را پایش کنید که در واقع برق این سیستم را تامین نمی‌کند، می‌توانید powervalue را روی 0 تنظیم کنید. این قابلیت زمانی مفید است که می‌خواهید upsmon اعلان‌هایی درباره تغییر وضعیت یک UPS ارسال کند بدون اینکه هنگام بحرانی شدن وضعیت آن، سیستم خاموش شود.

•مقادیر username و password در این خط باید با یک مدخل در فایل upsd.users(5) سیستم سرور upsd مطابقت داشته باشد.

اگر نام کاربری شما "observer" و گذرواژه شما "abcd" باشد، خط MONITOR ممکن است شبیه این باشد (احتمالاً در یک سیستم ثانویه راه دور):

MONITOR myups@bigserver 1 observer abcd secondary

در همین حال، فایل upsd.users روی bigserver به این شکل خواهد بود:

[observer]
        password = abcd
        upsmon secondary
[upswired]
        password = blah
        upsmon primary

و نسخه upsmon روی آن bigserver با پیکربندی اولیه اجرا می‌شود:

MONITOR myups@bigserver 1 upswired blah primary
•پارامتر type به رابطه با upsd(8) اشاره دارد. این مقدار می‌تواند "primary" یا "secondary" باشد. برای اطلاعات بیشتر در مورد مفهوم این حالت‌ها، upsmon(8) را ببینید. حالتی که در اینجا انتخاب می‌کنید در فایل upsd.users نیز قرار می‌گیرد، همان‌طور که در مثال بالا دیده شد.

NOCOMMWARNTIME seconds

اگر upsmon نتواند به هیچ‌یک از مدخل‌های UPS در این فایل پیکربندی دسترسی پیدا کند، پس از این تعداد ثانیه یک NOTIFY_NOCOMM را راه‌اندازی می‌کند. تا زمانی که مشکل برطرف نشود، به هشدار دادن به شما ادامه می‌دهد. به طور پیش‌فرض این مقدار ۳۰۰ ثانیه است.

POLLFAIL_LOG_THROTTLE_MAX count

upsmon معمولاً خرابی‌های نظرسنجی را برای هر دستگاه که در هر چرخه POLLFREQ برقرار است (مانند "Data stale" یا "Driver not connected") طبق پیکربندی در گزارش‌های سیستم ثبت می‌کند. اگر انتظار می‌رود دستگاه‌های شما برای مدتی طولانی غایب باشند، می‌توانید از این محدودکننده برای کاهش بار روی ترافیک و ذخیره‌سازی syslog استفاده کنید؛ با ارسال این پیام‌ها تنها یک بار در هر چند چرخه، و زمانی که وضعیت خطا تغییر کرده یا برطرف شده باشد.

یک مقدار منفی به معنای رفتار استاندارد است (ثبت در گزارش در هر چرخه، عملاً همانند حالتی که max=1 است)، و مقدار صفر به این معناست که پیام هرگز تکرار نشود (تنها در شروع و پایان/تغییر وضعیت خرابی ثبت شود).

توجه داشته باشید که این محدودکننده تنها برای یک وضعیت خطای فعال اخیر به ازای هر دستگاه پایش‌شده اعمال می‌شود.

NOTIFYCMD command

هنگام وقوع رویدادها، upsmon این دستور را برای ارسال پیام‌ها فرامی‌خواند.

این دستور با متن کامل پیام به عنوان یک آرگومان فراخوانی می‌شود. متغیر محیطی NOTIFYTYPE حاوی رشته نوع عاملی خواهد بود که باعث وقوع این رویداد شده است.

اگر نیاز به استفاده از upssched(8) دارید، باید با ذکر نام آن در اینجا، آن را به عنوان NOTIFYCMD خود قرار دهید.

توجه داشته باشید که این دستور تنها برای رویدادهای NOTIFY فراخوانی می‌شود که EXEC برای آن‌ها با NOTIFYFLAG تنظیم شده باشد. برای جزئیات بیشتر، NOTIFYFLAG را در ادامه ببینید.

تبدیل این دستور به نوعی اسکریپت شل می‌تواند ایده بدی نباشد. برای اطلاعات و ایده‌های بیشتر، docs/scheduling.txt را ببینید.

به یاد داشته باشید، این دستور همچنین باید یک مؤلفه منفرد در فایل پیکربندی باشد، بنابراین اگر دستور شما دارای فاصله است، آن را در علامت نقل‌قول قرار دهید.

NOTIFYCMD "/path/to/script --foo --bar"

این اسکریپت در پس‌زمینه اجرا می‌شود—یعنی upsmon پیش از فراخوانی برای شروع آن، یک انشعاب (fork) ایجاد می‌کند. این بدان معناست که اگر رویدادهای زیادی به طور همزمان رخ دهند، NOTIFYCMD شما ممکن است چندین نمونه در حال اجرای همزمان داشته باشد. هنگام طراحی اعلان‌کننده‌های پیچیده این نکته را مد نظر داشته باشید.

NOTIFYMSG type message

برنامه upsmon همراه با مجموعه‌ای از پیام‌های پیش‌فرض برای رویدادهای مختلف عرضه می‌شود. در صورت تمایل می‌توانید آن‌ها را تغییر دهید. 
NOTIFYMSG ONLINE "UPS %s is getting line power"
NOTIFYMSG ONBATT "Someone pulled the plug on %s"

توجه داشته باشید که %s با شناسه UPS مورد نظر جایگزین می‌شود.

پیام باید یک مؤلفه منفرد در فایل پیکربندی باشد، بنابراین اگر حاوی فاصله است، باید آن را در علامت نقل‌قول قرار دهید.

NOTIFYMSG NOCOMM "Someone stole UPS %s"

مقادیر ممکن برای type:

ONLINE

یوپی‌اس دوباره آنلاین است

ONBATT

یوپی‌اس روی باتری است

LOWBATT

یوپی‌اس روی باتری است و باتری ضعیف دارد (وضعیت بحرانی است)

FSD

یوپی‌اس توسط سیستم اولیه در حال خاموش شدن است (FSD = «خاموشی اجباری» یا "Forced Shutdown")

COMMOK

ارتباط با UPS برقرار شد

COMMBAD

ارتباط با UPS قطع شد

SHUTDOWN

سیستم در حال خاموش شدن است

SHUTDOWN_HOSTSYNC

این سیستم اولیه خاموشی را آغاز کرد و منتظر سیستم‌های ثانویه است

REPLBATT

باتری UPS خراب است و نیاز به تعویض دارد

NOCOMM

یک UPS در دسترس نیست (برای پایش امکان برقراری ارتباط با آن وجود ندارد)

NOPARENT

فرایند والد upsmon از بین رفت - خاموش کردن سیستم غیرممکن است

CAL

کالیبراسیون UPS در حال انجام است

NOTCAL

کالیبراسیون UPS پایان یافت

OFF

یوپی‌اس به صورت مدیریتی خاموش یا به خواب رفته است

NOTOFF

یوپی‌اس دیگر به صورت مدیریتی خاموش یا به خواب رفته نیست

BYPASS

یوپی‌اس روی بای‌پس است (برق متصل است اما محافظت نمی‌کند)

NOTBYPASS

یوپی‌اس دیگر روی حالت بای‌پس نیست

ECO

یوپی‌اس در حالت ECO یا حالت مشابه است (همان‌طور که توسط سازنده تعریف و نام‌گذاری شده است)؛ برای جزئیات بیشتر upsmon(8) را ببینید.

NOTECO

یوپی‌اس دیگر در حالت ECO نیست (بالا را ببینید)

ALARM

یوپی‌اس دارای یک یا چند هشدار فعال است (ups.alarm را بررسی کنید)؛ برای این اعلان، message می‌تواند حاوی یک جانگهدارنده دوم %s باشد تا مقدار فعلی ups.alarm را جایگزین کند.

NOTALARM

یوپی‌اس دیگر در وضعیت هشدار نیست (بدون هشدار فعال)

OVER

یوپی‌اس دچار اضافه‌بار شده است

NOTOVER

یوپی‌اس دیگر دچار اضافه‌بار نیست

TRIM

یوپی‌اس در حال کاهش ولتاژ ورودی است

NOTTRIM

یوپی‌اس دیگر ولتاژ ورودی را کاهش نمی‌دهد

BOOST

یوپی‌اس در حال افزایش ولتاژ ورودی است

NOTBOOST

یوپی‌اس دیگر ولتاژ ورودی را افزایش نمی‌دهد

OTHER

یوپی‌اس دست‌کم یک نشانه طبقه‌بندی‌نشده در ups.status دارد؛ برای این اعلان، message می‌تواند حاوی یک جانگهدارنده دوم %s باشد تا مجموعه فعلی چنین نشانه‌هایی را جایگزین کند.

NOTOTHER

یوپی‌اس دیگر هیچ نشانه وضعیت طبقه‌بندی‌نشده‌ای ندارد

SUSPEND_STARTING

سیستم‌عامل در حال ورود به حالت خواب/تعلیق/خواب زمستانی است

SUSPEND_FINISHED

سیستم‌عامل به تازگی از حالت خواب/تعلیق/خواب زمستانی خارج شده است، غیرفعال‌سازی خوانش‌های منسوخ UPS برای جلوگیری از خاموشی ناخواسته

NOTIFYFLAG type flag[+flag]...

به طور پیش‌فرض، هنگام وقوع رویدادها upsmon پیام‌های عمومی (wall) را از طریق /bin/wall برای همه کاربران واردشده به سیستم ارسال می‌کند و در syslog می‌نویسد؛ به جز ویندوز که در آن upsmon به طور پیش‌فرض فقط در Event Log می‌نویسد. شما می‌توانید این رفتار را تغییر دهید.

مثال‌ها:

NOTIFYFLAG ONLINE SYSLOG
NOTIFYFLAG ONBATT SYSLOG+WALL+EXEC

مقادیر ممکن برای فلگ‌ها:

SYSLOG

نوشتن پیام در syslog

WALL

ارسال پیام به همه کاربران با /bin/wall

EXEC

اجرای NOTIFYCMD (بالا را ببینید) به همراه پیام

IGNORE

هیچ کاری انجام نده

اگر از IGNORE استفاده می‌کنید، هیچ فلگ دیگری را در همان خط به کار نبرید.

POLLFREQ seconds

به طور معمول upsmon هر ۵ ثانیه یک‌بار از سرور upsd(8) نظرسنجی می‌کند. اگر این کار شبکه شما را با ترافیک بیش از حد مواجه می‌کند، می‌توانید این مقدار را افزایش دهید. همچنین در برخی موارد می‌توانید آن را کاهش دهید تا به‌روزرسانی‌های سریع‌تری دریافت کنید.

در این میان نکاتی وجود دارد. نخست، اگر POLLFREQ را بیش از حد بالا تنظیم کنید، ممکن است رویدادهای کوتاه‌مدت برق را به کلی از دست بدهید. همچنین اگر از عدد بسیار بزرگی استفاده کنید، خطر فعال شدن DEADTIME (بالا را ببینید) وجود دارد.

دوم، اگر آن را بیش از حد پایین تنظیم کنید، با کاهش بازدهی مواجه خواهید شد. در حالی که upsd معمولاً تمام داده‌ها را فوراً در دسترس دارد، اکثر درایورها وضعیت UPS را تنها هر ۲ ثانیه یک‌بار تازه‌سازی می‌کنند. نظرسنجی با فاصله‌ای کمتر از آن معمولاً اطلاعات را سریع‌تر به شما نمی‌رساند.


نکته
این تنظیم با pollfreq پشتیبانی‌شده توسط برخی از برنامه‌های درایور NUT، مانند usbhid-ups(8) (در مورد اینکه درایور با چه فاصله‌ای یک دستگاه خاص را نظرسنجی می‌کند) متفاوت است.

POLLFREQALERT seconds

این فاصله‌ای است که اگر هر یک از UPSهای آن روی باتری باشند، upsmon بین نظرسنجی‌ها منتظر می‌ماند. می‌توانید از این گزینه همراه با POLLFREQ در بالا استفاده کنید تا نظرسنجی‌ها در رفتار عادی کندتر شوند، اما هنگامی که اتفاق ناگواری رخ می‌دهد، به‌روزرسانی‌های سریع‌تری دریافت کنید.

این مقدار همیشه باید برابر یا کمتر از مقدار POLLFREQ باشد. به طور پیش‌فرض این مقدار نیز ۵ ثانیه تنظیم شده است.

هشدارهای مربوط به مقادیر بیش از حد بالا و بیش از حد پایین در مدخل POLLFREQ در اینجا نیز صدق می‌کنند.

POWERDOWNFLAG filename

هنگامی که upsmon در حالت اولیه اجرا می‌شود و UPS نیاز به خاموش شدن دارد، این فایل را ایجاد می‌کند. شما باید در اسکریپت‌های خاموشی دیرهنگام خود وجود این فایل را بررسی کنید و در صورت وجود، upsdrvctl shutdown را فراخوانی کنید؛ توجه داشته باشید که اگر فایل‌های پیکربندی NUT در آن مرحله همچنان قابل خواندن باشند (فایل‌سیستم‌ها بیشتر پیاده شده یا به حالت فقط‌خواندنی تغییر کرده باشند)، ممکن است upsmon -K برای این منظور فراخوانی شود.

از نظر تاریخی، این مسیر اغلب /etc/killpower بود، اما امروزه ممکن است بخواهید آن را در یک سیستم فایل موقت (مثلاً زیر (/var)/run یا حتی یک مسیر اختصاصی (/var)/run/nut ) قرار دهید.

توجه داشته باشید که برای مسیرهای ویندوز باید از بک‌اسلش دوتایی استفاده شود، مثلاً C:\\Temp\\killpower (ویندوزهای مدرن ممکن است اسلش‌های رو به جلو مانند C:/Temp/killpower را نیز بپذیرند، اما ممکن است نتیجه متفاوت باشد).

این کار برای بازنشانی اجباری سیستم‌های ثانویه انجام می‌شود، تا حتی اگر برق در طول فرایند خاموشی بازگردد، آن‌ها در مرحله "halted" متوقف نمانند. این سازوکار معمولاً روی UPSهای بستن تماس (contact-closure) که از درایور genericups استفاده می‌کنند، به خوبی کار نمی‌کند.


هشدار
برنامه باینری upsmon فاقد یک مقدار پیش‌فرض توکار است، بنابراین این تنظیم حتماً باید در پیکربندی مشخص شود تا ادغام خاموشی دیرهنگام روی آن سیستم خاص با حالت اولیه به درستی عمل کند!
برای اطلاعات بیشتر، فایل config-notes.txt را در زیرپوشه docs ببینید. به بخش زیر مراجعه کنید:

"Configuring automatic shutdowns for low battery events" یا به نسخه آنلاین مراجعه کنید.

OFFDURATION seconds

پروژه NUT از یک «خاموشی مدیریتی» (administrative OFF) برای دستگاه‌های برقی پشتیبانی می‌کند که می‌توان آن‌ها را طوری مدیریت کرد که بار کاری برنامه‌های خود را خاموش کنند، در حالی که UPS یا ePDU برای پایش و مدیریت همچنان قابل دسترسی باقی بماند. این سوئیچ اجازه می‌دهد تا انتشار چنین وضعیتی به یک فقدان شناخته‌شده تغذیه با تاخیر انجام شود (که احتمالاً راه‌اندازی FSD را در کلاینت‌های upsmon که دستگاه را MONITOR می‌کنند و در واقع هنوز فعال هستند در پی دارد — مثلاً با چندین منبع تغذیه یا به این دلیل که آن‌ها به عنوان بار واقعاً خاموش نشده‌اند)، زیرا هنگامی که برخی دستگاه‌ها کالیبراسیون باتری را آغاز می‌کنند، برای چند ثانیه وضعیت "OFF" را گزارش می‌دهند و تنها پس از تغییر وضعیت تمام رله‌های برق ممکن است "CAL" را گزارش کنند — در نتیجه هشدارهای مثبت کاذب برای راه‌انداز FSD در upsmon ایجاد می‌کنند.

یک مقدار منفی به معنای غیرفعال کردن کاهش شمارنده منابع تغذیه فعال در چنین مواردی است، و مقدار صفر تاثیر وضعیت شناسایی‌شده "OFF" را فوری می‌سازد. مقدار پیش‌فرض توکار ۳۰ (ثانیه) است، تا اگر یک وضعیت "OFF" به مدت این تعداد ثانیه تداوم یابد، اعمال شود (کاهش تعداد منابع تغذیه شناخته‌شده).


نکته
تاکنون ما از گزارش وضعیت "OFF" توسط دستگاه پشتیبانی می‌کنیم که معمولاً به معنای قطع کامل برق بار است؛ یک گزارش در ردیاب باگ ثبت شده تا پشتیبانی مشابهی را فقط برای برخی پریزها یا گروه‌های پریز قابل مدیریت طراحی کند.

OVERDURATION seconds

این تنظیم نحوه برخورد با یک UPS دچار اضافه‌بار را در شرایطی که ارتباط کاملی ندارد مدیریت می‌کند. از آنجا که چنین یوپی‌اسی ممکن است در وضعیتی بالقوه وخیم باشد، برخی کاربران ممکن است بخواهند سیستم‌هایشان بلافاصله یا پس از سپری شدن یک زمان انتظار مشخص خاموش شوند. تنظیم OVERDURATION این زمان انتظار (به ثانیه) را مشخص می‌کند که پس از آن، یک UPS دچار اضافه‌بار که در حال ارتباط نیست، بحرانی تلقی خواهد شد.

یک مقدار منفی به این معناست که یک UPS دچار اضافه‌بار هرگز بحرانی تلقی نخواهد شد (حداقل نه به خاطر خود اضافه‌بار). مقدار صفر به این معناست که UPS در صورت داشتن اضافه‌بار و عدم برقراری ارتباط، فوراً بحرانی تلقی می‌شود. مقدار پیش‌فرض توکار -1 (ثانیه) است.


نکته
این تنظیم تنها بر رفتار زمانی تأثیر می‌گذارد که یک UPS هم دچار اضافه‌بار باشد و هم ارتباط برقرار نکند. هنگامی که UPS به طور عادی در حال برقراری ارتباط است، وضعیت اضافه‌بار ممکن است اعلان‌هایی ایجاد کند اما به خودی خود باعث خاموش شدن سیستم نخواهد شد.

OBLBDURATION seconds

پروژه NUT به طور معمول برای مصرف‌کنندگان یک UPS که مشخص شده روی باتری است ("OB") و به وضعیت باتری ضعیف ("LB") رسیده است، در صورتی که این آخرین منبع تغذیه باقی‌مانده آن‌ها برای برآورده کردن تنظیم MINSUPPLIES باشد، هشدارهای خاموشی فوری (FSD) را ایجاد می‌کند. در برخی موارد خاص، کاربران ممکن است بخواهند ایجاد هشدار را بنا به صلاحدید خود و با پذیرش خطر خاموشی نامناسب، (با استفاده از گزینه OBLBDURATION ) به تأخیر بیندازند.

یک مقدار مثبت وضعیت "OB LB" را تنها در صورتی اعمال می‌کند که برای این تعداد ثانیه تداوم یابد. یک مقدار غیرمثبت، تأثیر FSD وضعیت شناسایی‌شده "OB LB" را فوری می‌سازد. مقدار پیش‌فرض توکار 0 (ثانیه) است.


نکته
اگر هر دو گزینه OBLBDURATION و HOSTSYNC روی یک سیستم کلاینت upsmon (ثانویه) تنظیم شده باشند و HOSTSYNC کوتاه‌تر باشد، عملاً نادیده گرفته خواهد شد: upsmon حداکثر تا OBLBDURATION ثانیه منتظر برطرف شدن وضعیت "OB LB" می‌ماند و سپس منطق کلاینت ثانویه به خاموشی فوری منتهی می‌شود. اگر سیستم اولیه روی این UPS یک FSD صادر کند، به محض مشاهده، تأثیری با اولویت بالاتر خواهد داشت.

RBWARNTIME seconds

هنگامی که یک UPS اعلام کند که باتری آن نیاز به تعویض دارد، upsmon یک رویداد NOTIFY_REPLBATT ایجاد می‌کند. به طور پیش‌فرض، این رویداد هر ۴۳۲۰۰ ثانیه (۱۲ ساعت) یک‌بار رخ می‌دهد.

اگر به مقدار دیگری نیاز دارید، آن را در اینجا تنظیم کنید.

ALARMCRITICAL 0 | 1

پروژه NUT به طور معمول UPSهای دارای هشدارهای فعال را ناپایدار تلقی می‌کند، به این معنی که با دقت بیشتری تحت نظر قرار می‌گیرند و ممکن است زودتر از سایر وضعیت‌های عادی UPS به عنوان بحرانی/مرده تلقی شوند. این موضوع به ویژه در شرایط عدم برقراری ارتباط صادق است، جایی که UPS در وضعیت ALARM از دست رفته تلقی شده و در نتیجه ممکن است خاموشی‌های سیستم آغاز شود.

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

هنگامی که این تنظیم غیرفعال باشد، upsmon یک UPS در وضعیت هشدار را ناپایدار در نظر نمی‌گیرد و باعث می‌شود با وضعیت ALARM همانند هر وضعیت دیگری برخورد کند.

RUN_AS_USER username

برنامه upsmon به طور معمول به دو فرایند تقسیم می‌شود؛ بخش کوچکی را که تحت مالکیت root باقی می‌ماند حفظ می‌کند تا در صورت رسیدن زمان موعود، با فراخوانی SHUTDOWNCMD خاموشی سیستم را آغاز کند، و بخش عمده وظایف پایش را پس از رها کردن امتیازات ریشه، تحت شناسه کاربری دیگری اجرا می‌کند. در اکثر سیستم‌های سفارشی‌ساخت، این بدان معناست که به عنوان "nobody" اجرا می‌شود، زیرا این مقدار پیش‌فرض زمان کامپایل است؛ بسته‌ها اغلب یک کاربر "nut" یا "ups" را برای اجرای دیمن‌های سرویس NUT فراهم می‌کنند.

نکته اینجاست که کاربر پیش‌فرض سیستم "nobody" نمی‌تواند فایل upsmon.conf شما را بخواند، زیرا به طور پیش‌فرض طوری نصب شده که فقط root می‌تواند آن را باز کند (زیرا این فایل می‌تواند حاوی اطلاعات حساسی مانند اعتبارنامه‌های سرور داده راه دور NUT باشد). این بدان معناست که شما قادر به بارگذاری مجدد فایل پیکربندی نخواهید بود، زیرا برای بخش بدون امتیاز دیمن upsmon غیرقابل دسترسی خواهد بود.

راهکار این است که یک کاربر جدید فقط برای upsmon ایجاد کنید، سپس آن را طوری تنظیم کنید که به عنوان آن کاربر اجرا شود. این حساب کاربری می‌تواند همان حسابی باشد که برای درایورهای NUT یا سرور داده استفاده می‌شود، اما الزامی به آن نیست. در سیستم‌هایی با ملاحظات امنیتی بالاتر و تفکیک امتیازات، ما "nutmon" را پیشنهاد می‌کنیم، اما شما می‌توانید از هر نامی که قبلاً در سیستم شما گرفته نشده است استفاده کنید. فقط یک کاربر معمولی بدون امتیازات ویژه و با یک گذرواژه غیرقابل حدس ایجاد کنید.

سپس، به upsmon بگویید که به عنوان آن کاربر اجرا شود، و فایل upsmon.conf را برای آن قابل خواندن کنید. بارگذاری‌های مجدد شما کار خواهند کرد و فایل پیکربندی شما امن باقی خواهد ماند.

این فایل نباید توسط کاربر upsmon قابل نوشتن باشد، زیرا ممکن است از یک روزنه سوءاستفاده شده، SHUTDOWNCMD به چیزی مخرب تغییر داده شود و سپس منتظر راه‌اندازی مجدد upsmon بمانند. بنابراین معمولاً شما یک گروه نیز برای دیمن‌های NUT ایجاد می‌کنید (که کاربر عضو آن باشد) و به آن گروه دسترسی فقط‌خواندنی به فایل‌های پیکربندی متعلق به root را اعطا می‌کنید.

با این اوصاف، حالت‌های دیگری نیز ممکن است امکان‌پذیر باشد — برای مثال اجرای کل upsmon به عنوان یک فرایند منفرد که در ابتدا توسط nut شروع شده و تحت مالکیت آن است، و فراخوانی یک اسکریپت خاموشی با پیشوند sudo، pfexec یا سایر ابزارهای RBAC. با این حال، این کار باعث افزودن «بخش‌های متحرک» بیشتر و شکنندگی می‌شود (به عنوان مثال، تنظیمات sudoers ممکن است در LDAP قرار داشته باشد، و آن سرور در زمان خاموشی هنگامی که نیمی از رک خاموش شده است، دقیقاً در همان زمانی که در اینجا به آن نیاز دارید، در دسترس نباشد)، و روی همه پلتفرم‌ها نیز در دسترس نیست — بنابراین چنین تنظیماتی مواردی هستند که کاربران تاکنون به تنهایی بررسی کرده‌اند (هرچند از ارسال پست‌ها در ویکی NUT یا پیوند به وبلاگ‌ها استقبال می‌کنیم).

SHUTDOWNCMD command

هنگامی که سیستم نیاز به خاموش شدن دارد، upsmon این دستور را اجرا می‌کند. اگر یک سیستم ثانویه باشد، هر زمان که مقدار توان کلی فعلی به زیر مقدار MINSUPPLIES بالا افت کند، بلافاصله این کار را انجام می‌دهد.

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

توجه داشته باشید که این دستور باید یک مؤلفه منفرد در فایل پیکربندی باشد. اگر دستور خاموشی شما حاوی فاصله است، آن را در علامت نقل‌قول قرار دهید تا یکپارچه بماند، یعنی:

SHUTDOWNCMD "/sbin/shutdown -h +0"

SHUTDOWNEXIT boolean|number

پس از آغاز خاموشی، آیا خود این دیمن upsmon باید خارج شود؟ با انجام این کار، سیستم‌های ثانویه NUT می‌توانند به سیستم اولیه NUT اطلاع دهند که می‌تواند خاموشی خود را ادامه دهد و در نهایت به UPS دستور دهد برق بار را قطع کند. (به طور پیش‌فرض "Yes")

برخی سیستم‌های «ثانویه» با بارهای کاری که توقف آن‌ها زمان قابل توجهی می‌برد (مانند ماشین‌های مجازی یا پایگاه‌های داده بزرگ) می‌توانند از این موضوع بهره‌مند شوند که اعلام آمادگی خود را برای شروع خاموشی سیستم «اولیه» و در نهایت قطع برق توسط UPS (از طریق قطع اتصال از سرور داده) — نه به محض آغاز خاموشی خود، بلکه در نقطه‌ای دیرتر گزارش دهند (مثلاً هنگامی که سرویس upsmon پس از بارهای کاری سنگین‌تر متوقف می‌شود).

توجه داشته باشید که توانایی واقعی برای تکمیل چنین خاموشی به مدت‌زمان کارکرد باقی‌مانده باتری در لحظه‌ای بستگی دارد که وضعیت برق UPS بحرانی تلقی شده و خاموشی‌ها آغاز می‌شوند. همچنین ممکن است مجبور شوید HOSTSYNC را در سیستم اولیه NUT به اندازه کافی طولانی تنظیم کنید تا آن سیستم‌های ثانویه بتوانند سرویس‌های خود را متوقف کنند. در عمل، ممکن است ارزش داشته باشد که راه‌هایی برای آغاز زودهنگام‌تر خاموشی در این سیستم‌ها بررسی شود، به عنوان مثال با راه‌اندازی یکپارچه‌سازی با upssched یا درایور dummy-ups همراه با بازنویسی‌هایی برای محرک‌های سخت‌گیرانه‌تر battery.charge یا battery.runtime نسبت به آنچه توسط سایر سرورهای شما استفاده می‌شود.

این گزینه از رشته‌های به سبک دودویی (yes/on/true یا no/off/false) یا اعداد برای تعیین یک تاخیر (به ثانیه) بین فراخوانی SHUTDOWNCMD و خروج از دیمن پشتیبانی می‌کند. صفر به معنای خروج فوری است (پیش‌فرض)، مقادیر منفی به معنای هرگز خارج نشدن به اراده خود است.

CERTPATH certificate file or database

هنگامی که برنامه با پشتیبانی از SSL کامپایل شده باشد، می‌توانید مسیر گواهی را در اینجا وارد کنید.

با NSS:

گواهی‌ها در یک پایگاه‌داده اختصاصی ذخیره می‌شوند (داده‌ها به ۳ فایل تقسیم شده‌اند). مسیر پوشه پایگاه‌داده را مشخص کنید.

با OpenSSL:

پوشه حاوی گواهی‌های CA در قالب PEM که برای اعتبارسنجی گواهی سرور ارائه‌شده توسط سرور upsd استفاده می‌شود. این فایل‌ها هر کدام حاوی یک گواهی CA هستند. فایل‌ها با مقدار درهم‌سازی نام موضوع (subject name hash) مرجع صدور گواهی جستجو می‌شوند، بنابراین این مقدار باید در دسترس باشد.

CERTIDENT certificate name database password

هنگامی که برنامه با پشتیبانی از SSL به همراه NSS کامپایل شده باشد، می‌توانید نام گواهی را برای بازیابی از پایگاه‌داده جهت احراز هویت خود و گذرواژه لازم برای دسترسی به کلید خصوصی مربوط به گواهی را مشخص کنید.

در حال حاضر در صورت ساخت با OpenSSL این گزینه بدون عمل (no-op) است.


نکته
اگر از مقداری استفاده می‌کنید که حاوی فاصله است، حتماً «نام گواهی» را در علامت نقل‌قول دوتایی قرار دهید.

CERTHOST hostname certificate name certverify forcessl

هنگامی که برنامه با پشتیبانی از SSL به همراه NSS کامپایل شده باشد، می‌توانید دستورالعمل امنیتی را برای هر سروری که می‌توانید با آن تماس بگیرید مشخص کنید.

هر مدخل نام سرور را با نام گواهی مورد انتظار و فلگ‌هایی که نشان می‌دهند آیا گواهی سرور اعتبارسنجی می‌شود و آیا اتصال باید امن باشد، نگاشت می‌کند.

در حال حاضر در صورت ساخت با OpenSSL این گزینه بدون عمل (no-op) است.


نکته
اگر از مقداری استفاده می‌کنید که حاوی فاصله است، حتماً «نام گواهی» را در علامت نقل‌قول دوتایی قرار دهید.

CERTVERIFY 0 | 1

هنگامی که برنامه با پشتیبانی از SSL کامپایل شده باشد، upsmon را وادار به اعتبارسنجی تمام اتصالات با گواهی‌ها می‌کند.

بدون این گزینه، هیچ تضمینی وجود ندارد که upsd میزبان درستی باشد. فعال کردن این گزینه خطر حملات مرد میانی (man-in-the-middle) را به شدت کاهش می‌دهد. این گزینه عملاً استفاده از SSL را اجباری می‌کند، بنابراین تا زمانی که تمام میزبان‌های upsd شما برای SSL آماده نشده‌اند و گواهی‌هایشان مرتب نیست، از این گزینه استفاده نکنید.

هنگامی که برنامه با پشتیبانی NSS از SSL کامپایل شده باشد، این مقدار می‌تواند برای میزبانی که با دستورالعمل CERTHOST مشخص شده بازنویسی شود.

FORCESSL 0 | 1

هنگامی که برنامه با SSL کامپایل شده باشد، مشخص می‌کند که برای برقراری ارتباط با upsd باید از یک اتصال امن استفاده شود.

اگر از CERTVERIFY 1 استفاده نکنید، این گزینه دست‌کم اطمینان حاصل می‌کند که هیچ‌کس نمی‌تواند بدون زحمت زیاد نشست‌های شما را شنود کند. تنظیم این گزینه باعث می‌شود اگر upsd راه دور از SSL پشتیبانی نکند، upsmon اتصالات را قطع کند، بنابراین تا زمانی که همه آن‌ها SSL را اجرا نمی‌کنند از آن استفاده نکنید.

هنگامی که برنامه با پشتیبانی NSS از SSL کامپایل شده باشد، این مقدار می‌تواند برای میزبانی که با دستورالعمل CERTHOST مشخص شده بازنویسی شود.

DEBUG_MIN INTEGER

به صورت اختیاری یک حداقل سطح اشکال‌زدایی را برای دیمن upsmon مشخص کنید، مثلاً برای عیب‌یابی یک استقرار، بدون اینکه مستقیماً بر حالت اجرای پیش‌زمینه یا پس‌زمینه تأثیر بگذارد. گزینه خط فرمان -D فقط می‌تواند این سطح پرگویی (verbosity) را افزایش دهد.

نکته
اگر دیمن در حال اجرا دستور reload را دریافت کند، وجود مقدار DEBUG_MIN NUMBER در فایل پیکربندی می‌تواند برای تنظیم پرگویی اشکال‌زدایی در دیمن سرویس در حال اجرا استفاده شود (توصیه می‌شود پس از اتمام کار، آن را کامنت کنید یا حداقل مقدار را روی صفر صریح قرار دهید تا از ژورنال‌های حجیم و سوءاستفاده از سیستم ورودی/خروجی جلوگیری شود). به یاد داشته باشید که برای این تنظیم زمان اجرا، مقدار DEBUG_MIN موجود در فایل‌های پیکربندی بارگذاری‌مجددشده فوراً اعمال می‌شود و هر مقدار قبلی تعیین‌شده را، از طریق فایل یا گزینه‌های CLI، صرف نظر از اینکه سطح قبلی ثبت وقایع بالاتر یا پایین‌تر از عدد تازه یافت‌شده باشد بازنویسی می‌کند؛ با این حال، یک مقدار مفقود (یا کامنت‌شده) میزان پرگویی ثبت وقایع قبلی فعال را تغییر نمی‌دهد.

upsmon(8), upsd(8), nutupsdrv(8).

صفحه اصلی ابزارهای NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5

06/21/2026 Network UPS Tools 2.8.5