| UPS.CONF(5) | NUT Manual | UPS.CONF(5) |
نام (NAME)
ups.conf - تعاریف یوپیاس برای مجموعه ابزارهای Network UPS Tools
توضیحات (DESCRIPTION)
این فایل توسط کنترلکننده درایور upsdrvctl(8)، درایورهای یوپیاس که از هسته مشترک استفاده میکنند (به nutupsdrv(8) مراجعه کنید)، nut-driver-enumerator(8) و سرور داده NUT یعنی upsd(8) خوانده میشود. فایل با دستورالعملهای سراسری (global) آغاز میشود و سپس هر یوپیاس دارای بخشی است که شامل تعدادی دستورالعمل برای تنظیم پارامترهای آن یوپیاس میباشد.
بخش مربوط به هر یوپیاس با نام آن یوپیاس درون براکت آغاز میشود و تا نام یوپیاس بعدی درون براکت یا پایان فایل ادامه مییابد. نام "default" به صورت داخلی در upsd(8) استفاده میشود، بنابراین نمیتوانید از آن در این فایل استفاده کنید.
شما باید عناصر driver و port را برای هر مدخل تعریف کنید. هر مورد دیگری پس از آن در یک بخش اختیاری است. یک مثال ساده ممکن است به این شکل باشد:
[myups]
driver = blazer_ser
port = /dev/ttyS0
desc = "Web server UPS"
یک نسخه کمی پیچیدهتر شامل مواردی اضافی برای بخش وابسته به سختافزار درایور است:
[bigups]
driver = apcsmart
port = /dev/cua00
cable = 940-0095B
sdtype = 2
desc = "Database server UPS"
در این حالت، درایور apcsmart(8) متغیرهایی به نام "cable" و "sdtype" را دریافت میکند که معانی خاصی دارند. برای اطلاع از اینکه چه متغیرهایی پشتیبانی میشوند و چه کاری انجام میدهند، به صفحات راهنمای درایور(های) خود مراجعه کنید.
در اینجا مثال دیگری هنگام اتصال یک یوپیاس سریال در ویندوز آورده شده است:
[windows-ups]
driver = mge-shut
port = "\\\\.\\COM10"
desc = "UPS on a Windows machine"
نکات مهم (IMPORTANT NOTES)
دستورالعملهای سراسری (GLOBAL DIRECTIVES)
chroot
driverpath
statepath
توجه داشته باشید که درایورها باید از همان مسیر مورد استفاده upsd استفاده کنند، بنابراین سرور داده در صورت وجود، این تنظیم از بخش سراسری ups.conf را بر تنظیم موجود در upsd.conf ترجیح میدهد.
متغیر محیطی NUT_STATEPATH تنظیمشده توسط فراخوان میتواند این تنظیم را بازنویسی کند.
maxstartdelay
maxretry
مقدار پیشفرض ۱ بار تلاش است.
nowait
حالت پیشفرض (عدم درج) صبر کردن است.
این گزینه را میتوان با متغیر محیطی NUT_IGNORE_NOWAIT بازنویسی کرد (برای نمونه، جهت رفع برخی مشکلات مربوط به systemd).
retrydelay
مقدار پیشفرض ۵ ثانیه است.
pollinterval
توجه داشته باشید که برخی درایورها (مانند usbhid-ups(8)، snmp-ups(8) و nutdrv_qx(8)) همچنین دارای گزینهای به نام pollfreq هستند که دفعات پایش برخی از پارامترهای با اهمیت کمتر را کنترل میکند. جزئیات در صفحات راهنمای هر درایور ارائه شده است.
synchronous
write XX bytes to socket Y failed
با فعال کردن فلگ synchronous (مقدار = yes)، درایور قبل از انتشار دادههای بیشتر، منتظر میماند تا دادهها توسط upsd مصرف شوند. این ویژگی را میتوان به صورت سراسری یا برای هر درایور فعال کرد.
حالت پیشفرض auto برای سازگاری با گذشته در رفتار درایور مانند no (یعنی حالت ناهمگام) عمل میکند، تا زمانی که ارتباطات با وضعیت "Resource temporarily unavailable" دچار شکست شود؛ این حالت زمانی رخ میدهد که درایور دادههای زیادی برای ارسال به صورت انفجاری دارد و سرور نمیتواند با سرعت کافی آن را پردازش کند، در نتیجه بافر پر میشود.
user
group
debug_min INTEGER
LIBUSB_DEBUG INTEGER
برای جزئیات بیشتر، از جمله مقادیر پشتیبانیشده جاری برای نسخه کتابخانه شما، ببینید:
فیلدهای یوپیاس (UPS FIELDS)
driver
port
user
group
sdorder
مقدار پیشفرض برای این پارامتر 0 است.
sdcommands
منطق پیشفرض در هر درایور (در صورت پشتیبانی) تعبیه شده است و میتوان در اینجا به عنوان مقدار shutdown.default به آن ارجاع داد.
کاربرد اصلی برای دستگاههایی است که درایورهای آنها به صورت بومی تلاش برای چند دستور را پشتیبانی میکنند، اما ترتیب پیشفرض تعبیهشده دستوری را فراخوانی میکند که توسط مدل دستگاه خاص به درستی مدیریت نمیشود (بنابراین گزارش موفقیت داده میشود و حلقه متوقف میشود، اما در عمل هیچ اتفاقی در مورد قطع برق بار رخ نمیدهد).
کاربرد دیگر تمایز سناریوهای خاموش کردن خودکار برق است که در آنها یوپیاس و بار متصل باید در حالت "OFF" باقی بمانند (مانند قطع برق اضطراری ساختمان) در مقایسه با سناریوهایی که بار باید پس از ایمن شدن وضعیت به طور خودکار به کار بازگردد. توجه: در حال حاضر برای چنین مواردی نیاز به ویرایش ups.conf پیش از مشاهده فایل توسط nutshutdown است؛ اما در نسخههای آینده NUT میتواند به شکل بهتری خودکار شود.
نکته
دستورات ارائهشده توسط کاربر ممکن است چیزی غیر از خاموشسازی واقعی باشند، برای نمونه یک بیپر (beeper) برای آزمایش اینکه INSTCMD همانطور و در زمانی که انتظار میرفت رخ داده و با دستگاه ارتباط برقرار شده است، بدون تأثیر بر بار تغذیهشده توسط یوپیاس.
allow_killpower
desc
nolock
تنها در صورتی باید از این گزینه استفاده کنید که سیستم شما بدون آن کار نکند.
این گزینه ممکن است در سیستمهای Mac OS X مورد نیاز باشد.
ignorelb
battery.charge < battery.charge.low battery.runtime < battery.runtime.low
ایده این است که سطوح battery.charge.low و/یا battery.runtime.low در ups.conf روی مقداری تنظیم شوند که زمان کافی برای خاموشسازی تمیز سیستم فراهم کند:
override.battery.charge.low = 30 override.battery.runtime.low = 180
برای کارکرد این قابلیت، یوپیاس شما باید بتواند میزان شارژ و/یا زمان کارکرد باقیمانده روی باتری را (به طور قابل اعتماد) گزارش کند. با احتیاط استفاده کنید!
maxstartdelay
توجه داشته باشید که پس از سپری شدن این مدت، upsdrvctl به کار خود ادامه میدهد (چه تلاش مجدد برای همان درایور در صورت maxretry>1، یا تلاش برای درایوری دیگر در صورت راهاندازی همه آنها، یا در نهایت خروج)؛ با این حال، هر یک از این فرایندهای درایور "گیرکرده" که به تازگی راهاندازی شدهاند ممکن است در پسزمینه به مقداردهی اولیه ادامه دهند و حتی در نهایت با موفقیت روبرو شوند.
آنها پس از پایان این مهلت زمانی توسط upsdrvctl به صورت فعال متوقف (kill) نمیشوند.
مقدار پیشفرض ۷۵ ثانیه است.
maxretry
retrydelay
synchronous
usb_set_altinterface[=altinterface]
usb_config_index, usb_hid_rep_index, usb_hid_desc_index, usb_hid_ep_in, usb_hid_ep_out
به عنوان یک قاعده کلی برای کشف usb_hid_desc_index، میتوانید مقادیر بزرگتر wDescriptorLength (تقریباً بیش از ۶۰۰ بایت) را در گزارشهای lsusb یا ابزارهای مشابه مشاهده کنید.
default.<variable>
default.input.voltage.nominal = 230
دستور بالا ولتاژ اسمی ورودی را ۲۳۰ گزارش میکند، مگر اینکه یوپیاس مقدار دیگری اعلام کند.
override.<variable>
override.battery.voltage.nominal = 12
با احتیاط استفاده کنید! این کار تنها ظاهر متغیر را برای دنیای بیرون تغییر میدهد؛ درون یوپیاس همچنان از مقدار اصلی استفاده میشود.
تمام فیلدهای دیگر به بخش وابسته به سختافزار درایور منتقل میشوند. برای فهرست موارد مجاز به آن راهنماها مراجعه کنید.
debug_min INTEGER
LIBUSB_DEBUG INTEGER
برای جزئیات بیشتر، از جمله مقادیر پشتیبانیشده جاری برای نسخه کتابخانه شما، ببینید:
یکپارچهسازی (INTEGRATION)
upsdrvctl(8) از این فایل برای راهاندازی و متوقف کردن درایورها استفاده میکند.
خود درایورها نیز دادههای پیکربندی را از این فایل دریافت میکنند. هر درایور بخش مربوط به خود را جستجو کرده و از آن برای پیکربندی خود استفاده مینماید.
upsd(8) با خواندن این فایل متوجه میشود چه یوپیاسهایی روی این سیستم نصب شدهاند. اگر این سیستم "doghouse" نامیده شود و شما یوپیاسی را در ups.conf خود به نام "snoopy" تعریف کرده باشید، میتوانید آن را از طریق upsc(8) یا برنامههای مشابه به صورت "snoopy@doghouse" پایش کنید.
همچنین ببینید (SEE ALSO)
upsd(8), nutupsdrv(8), upsdrvctl(8), upsdrvsvcctl(8)
منابع اینترنتی (Internet resources)
صفحه اصلی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5
| 06/21/2026 | Network UPS Tools 2.8.5 |