نام (NAME)

netxml-ups - درایور تجهیزات کارت یا پروکسی مدیریت شبکه Eaton / MGE (پروتکل XML/HTTP)

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

netxml-ups -h

netxml-ups -a UPS_NAME [گزینه‌ها]

یادداشت

این صفحه راهنما صرفاً ویژگی‌های وابسته به سخت‌افزار درایور netxml-ups را مستند می‌کند. برای اطلاعات درباره هسته درایور، به nutupsdrv(8) مراجعه کنید.

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

درایور netxml-ups از تمامی مدل‌های جدید Eaton / MGE که از یک کارت یا پروکسی مدیریت شبکه (بر پایه پروتکل MGE XML/HTTP) استفاده می‌کنند پشتیبانی می‌نماید. این موضوع شامل هر دو دسته Eaton (پیش‌تر MGE Office Protection Systems) و MGE UPS SYSTEMS می‌شود. مدل‌های کارت و پروکسی پشتیبانی‌شده عبارتند از:

•مدل NMC Minislot (شناسه Ref 66102، سفت‌افزار EA یا جدیدتر)،

•کارت SNMP/Web Minislot (شناسه Ref 66244)

•مدل NMC Transverse (شناسه Ref 66074)،

•مدل NMC & Modbus/JBus (شناسه Ref 66103)،

•پروکسی مدیریت شبکه (Network Management Proxy)،

•مدل ePDU Monitored (نسخه‌های جدیدتر).

مدل‌های قدیمی‌تر، نظیر کارت SNMP (شناسه Ref 66062 و Ref 66045)، از پروتکل SNMP استفاده می‌کنند و باید از درایور snmp-ups(8) همراه با پارامتر mibs=mge برای آن‌ها استفاده شود.

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

این درایور از تنظیمات اختیاری زیر در ups.conf(5) پشتیبانی می‌کند:

timeout=مقدار

مدت زمان مهلت انتظار برای اتصال و خواندن از UPS. مقدار پیش‌فرض ۵ ثانیه است. این مقدار را تغییر ندهید مگر اینکه دقیقاً بدانید چه کاری انجام می‌دهید.

این مقدار هرگز نباید بیشتر از نصف مقدار MAXAGE مشخص‌شده در upsd.conf(5) باشد، در غیر این صورت این خطر وجود دارد که upsd(8) درایور را در حالی که منتظر اتمام مهلت اتصال است کهنه (stale) اعلام کند.

subscribe

اتصال به NMC در حالت اشتراکی (subscribed). این امر دریافت سریع‌تر اعلان‌ها و هشدارها را علاوه بر درخواست‌های دوره‌ای معمول ممکن می‌سازد.

login=مقدار

تنظیم نام کاربری ورود برای حالت احراز هویت‌شده. این قابلیت همچنین به آرگومان password نیاز دارد و امکان تنظیم مقادیر در کارت را فراهم می‌کند. این قابلیت هنوز استفاده نشده است.

password=مقدار

تنظیم گذرواژه لازم به همراه نام کاربری برای حالت احراز هویت‌شده. این قابلیت هنوز استفاده نشده است.

shutdown_duration=مقدار

تنظیم مدت‌زمان خاموش شدن سیستم‌عامل بر حسب ثانیه. این عدد نشان‌دهنده مدت‌زمانی است که سیستم برای اجرای یک خاموشی پاکیزه نیاز دارد. پیش‌فرض ۱۲۰ ثانیه است.

shutdown_timer=مقدار

تنظیم زمان‌سنج خاموشی بر حسب ثانیه. پس از سپری شدن مقدار ثانیه فعالیت روی باتری، سیستم محلی اعلانی برای خاموش شدن دریافت خواهد کرد. مقدار پیش‌فرض "none" (غیرفعال) است.

do_convert_deci

در صورت وجود این پرچم، درایور فرض می‌کند شما یک UPS تحت شبکه بسیار قدیمی MGE (یا در اصل نسخه سفت‌افزار قدیمی کارت مدیریت شبکه) دارید که برخی مقادیر اندازه‌گیری‌شده را در نشانه‌گذاری XML ده برابر بزرگ‌تر گزارش می‌کند.

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

پیاده‌سازی (IMPLEMENTATION)

نام میزبان UPS تحت شبکه از طریق مقدار port در ups.conf مشخص می‌شود، به عنوان مثال:

[mgexml]
        driver = netxml-ups
        port = http://netxml-ups.example.com:80

مشخص کردن شیوه اتصال به UPS (مانند http یا https) الزامی است. اگر درگاه برابر با مقدار پیش‌فرض پروتکل باشد (۸۰ برای http و ۴۴۳ برای https) می‌توان از ذکر آن صرف‌نظر کرد.

جهت جلوگیری از تحمیل بار اضافی بر NMCهای قدیمی ناشی از پرس‌وجوی مکرر، پیشنهاد می‌شود مقدار "pollinterval" (به nutupsdrv(8) و ups.conf(5) مراجعه کنید) به حداقل ۵ ثانیه افزایش یابد.

مشکلات شناخته‌شده (KNOWN ISSUES)

پروکسی‌های HTTP(S)

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

استفاده از نام میزبان برای NMC دستگاه UPS

ممکن است به کارت مدیریت شبکه UPS در شبکه شما یک نشانی IP ایستا یا پویا (مثلاً از طریق DHCP) اختصاص داده شده باشد. به همین دلیل شاید مایل باشید یا ناچار شوید از سرویس نام‌گذاری پویا برای دسترسی به UPS استفاده کنید. توجه داشته باشید که این مسئله به ویژه در زمان قطعی‌های گسترده و خاموشی‌ها می‌تواند دردسرساز شود، زیرا ممکن است سرور DHCP/DNS شما پیش از این که درایور نام میزبان را تحلیل کند از کار بیفتد (به‌ویژه در جریان قلاب‌های پایانی خاموشی، زمانی که نمونه جدیدی از برنامه درایور ممکن است تنها برای ارسال فرمان خاموشی یا قطع و وصل مجدد برق به UPS اجرا شود).

معقول است اطمینان یابید که کلاینت سرویس نام سیستم‌عامل شما می‌تواند نام UPS را به اندازه کافی ذخیره (cache) کند، یا از آدرس‌دهی ثابت IP (و برای اطمینان بیشتر، یک مدخل در /etc/hosts تا در نهایت تنها یک مکان برای پیکربندی مجدد آن داشته باشید) بهره ببرید.

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

Arjen de Korte <adkorte-guest@alioth.debian.org>

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

هسته درایور:

nutupsdrv(8)

منابع اینترنتی:

صفحه خانگی NUT (ابزارهای UPS تحت شبکه): https://www.networkupstools.org/historic/v2.8.5