نام (NAME)

snmp-ups - درایور چند-MIB برای تجهیزات یوپی‌اس SNMP

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

snmp-ups -h

snmp-ups -a UPS_NAME [OPTIONS]

نکته

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

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

درایور snmp-ups با بارگذاری MIBهای گوناگون، طیف گسترده‌ای از دستگاه‌ها را به طور خودکار شناسایی و پشتیبانی می‌کند، مانند:

ietf

یوپی‌اس‌های سازگار با استاندارد RFC 1628 (UPS MIB)، مانند MGE UPS SYSTEMS، Liebert و احتمالاً موارد دیگر (پیش‌فرض)

mge

دستگاه‌های MGE UPS SYSTEMS و MGE Office Protection Systems دارای کارت‌های SNMP (شناسه‌های 66062، 66045، 66074 و 66244)

apcc

کارت‌های مدیریت شبکه APC شامل AP9605، AP9606، AP9617 و AP9618، و همچنین هر کارت دیگری که از APC POWERNET MIB پشتیبانی کند

netvision

یوپی‌اس Socomec Sicon به همراه کارت مدیریت/باکس خارجی وب/SNMP مدل Netvision

eaton_pw_nm2

دستگاه‌های Powerware با کارت‌های SNMP مدل ConnectUPS، و همچنین یوپی‌اس‌های با کارت‌های شبکه گیگابیت Eaton (Network-M2) (تغییر نام‌یافته از pw)

eaton_pxg_ups

دستگاه‌های Eaton با کارت Power Xpert Gateway UPS Card (تغییر نام‌یافته از pxgx_ups)

aphel_genesisII

دستگاه Eaton Powerware ePDU Monitored

aphel_revelation

دستگاه Eaton Powerware ePDU Managed

raritan

واحدهای مختلف توزیع برق (PDU) شرکت Raritan (مدل‌های Dominion PX، PM، RPC)

raritan-px2

واحدهای مختلف توزیع برق (PDU) شرکت Raritan (مدل Dominion PX2)

baytech

واحدهای مختلف توزیع برق (PDU) شرکت BayTech

cpqpower

کارت مدیریت HP/Compaq AF401A، و احتمالاً موارد دیگر

cyberpower

دستگاه Cyberpower RMCARD201. همچنین باید از RMCARD100 (نسخه شبکه)، RMCARD202 و RMCARD301 نیز پشتیبانی کند.

huawei

دستگاه Huawei UPS5000-E، و احتمالاً موارد دیگر

tripplite

یوپی‌اس‌های TrippLite؛ در حال حاضر این نگاشت همان نگاشت IETF MIB است که فقط از OID نقطه ورود Tripplite برای تأیید سازنده دستگاه استفاده می‌کند، و یک پیکربندی واقعی وابسته به سخت‌افزار در توسعه آینده افزوده خواهد شد.

برای یک فهرست کامل و به‌روز، می‌توانید با ارسال آرگومان mibs=--list از درایور پرس‌وجو کنید (به زیر مراجعه کنید).

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

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

port=hostname[:port]

تنظیم نام میزبان (hostname) یا نشانی IP و شماره پورت عامل SNMP در طرف مقابل. هیچ مقدار پیش‌فرضی برای نام میزبان وجود ندارد، اما پورت پیش‌فرض 161 است.

mibs=--list

گزینه‌ای ویژه که امکان فهرست کردن نگاشت‌های فعلی شناخته‌شده بین MIB به NUT و خروج از برنامه اجرایی درایور را فراهم می‌کند؛ برای استفاده در خط فرمان به این صورت در نظر گرفته شده است:

:; snmp-ups -a snmp-test -x mibs=--list

mibs=name

تنظیم سازگاری با MIB (پیش‌فرض=auto، مقادیر مجاز: به بخش سخت‌افزارهای پشتیبانی‌شده در بالا مراجعه کنید).

با مقدار "auto"، درایور مجموعه‌ای برگزیده از اشیاء SNMP را امتحان می‌کند تا زمانی که شیئی بیابد که دستگاه به آن پاسخ می‌دهد.

توجه داشته باشید که از NUT 2.6.2 به بعد، snmp-ups روش جدیدی دارد که از sysObjectID (که اشاره‌گری به MIB ترجیحی دستگاه است) برای شناسایی دستگاه‌های پشتیبانی‌شده استفاده می‌کند. این امر الزام استفاده از گزینه "mibs" را بی‌اثر می‌کند.

community=name

تنظیم نام انجمن (community name) (پیش‌فرض public است) برای اتصالات SNMPv1 و SNMPv2c. توجه داشته باشید که برای تغییر تنظیمات یوپی‌اس و ارسال دستورات (مانند خاموش کردن دستگاه)، یک نام انجمن با قابلیت خواندن و نوشتن (RW) لازم است.

snmp_version=version

تنظیم نسخه SNMP (پیش‌فرض = v1، مقادیر مجاز: v2c، v3)

snmp_retries=retries

تعداد تلاش‌های مجدد Net-SNMP را برای استفاده در درخواست‌ها مشخص می‌کند (پیش‌فرض=5)

snmp_timeout=timeout

مدت‌زمان انتظار Net-SNMP بر حسب ثانیه بین تلاش‌های مجدد را مشخص می‌کند (پیش‌فرض=1)

symmetrathreephase

فعال‌سازی رفتارهای ویژه سه‌فاز APCC Symmetra (قابل استفاده روی تجهیزات سه‌فاز APCC Symmetra): تبدیل ولتاژ سه‌فاز خط به خط (line-to-line) به ولتاژ خط به نول (line-to-neutral) (پیش‌فرض: غیرفعال)

pollfreq=num

تنظیم بازه زمانی نظرسنجی (polling) برای به‌روزرسانی‌های کامل، بر حسب ثانیه، جهت کاهش ترافیک شبکه SNMP در مقایسه با به‌روزرسانی‌های سریعی که در هر "pollinterval" انجام می‌شوند (گزینه اخیر در ups.conf(5) توضیح داده شده است). مقدار پیش‌فرض ۳۰ (بر حسب ثانیه) است.

notransferoids

غیرفعال کردن نظارت بر OIDهای انتقال ولتاژ بالا و پایین در سخت‌افزار. این گزینه input.transfer.low و input.transfer.high را از فهرست متغیرها حذف می‌کند. این گزینه فقط باید روی تجهیزات APCC Symmetra استفاده شود که در گزارش برق سه‌فاز رفتارهای نامتعارفی دارند.

secLevel=value

تنظیم securityLevel مورد استفاده برای پیام‌های SNMPv3 (پیش‌فرض=noAuthNoPriv، مقادیر مجاز: authNoPriv,authPriv). این پارامتر در صورت استفاده از احراز هویت غیربدیهی (غیرساده) الزامی است.

secName=value

تنظیم securityName مورد استفاده برای پیام‌های احراز هویت‌شده SNMPv3 (بدون پیش‌فرض)

authPassword=value

تنظیم عبارت عبور احراز هویت برای پیام‌های احراز هویت‌شده SNMPv3 (بدون پیش‌فرض)

privPassword=value

تنظیم عبارت عبور محرمانگی برای پیام‌های رمزگذاری‌شده SNMPv3 (بدون پیش‌فرض)

authProtocol=value

تنظیم پروتکل احراز هویت (MD5، SHA، SHA256، SHA384 یا SHA512) مورد استفاده برای پیام‌های احراز هویت‌شده SNMPv3 (پیش‌فرض=MD5). توجه داشته باشید که فهرست دقیق پروتکل‌ها به قابلیت‌های کتابخانه Net-SNMP بستگی دارد؛ راهنمای برنامه باینری snmp-ups را برای فهرست موارد پشتیبانی‌شده در زمان اجرا بررسی کنید.

privProtocol=value

تنظیم پروتکل محرمانگی (DES، AES، AES192 یا AES256) مورد استفاده برای پیام‌های رمزگذاری‌شده SNMPv3 (پیش‌فرض=DES). توجه داشته باشید که فهرست دقیق پروتکل‌ها به قابلیت‌های کتابخانه Net-SNMP بستگی دارد؛ راهنمای برنامه باینری snmp-ups را برای فهرست موارد پشتیبانی‌شده در زمان اجرا بررسی کنید.

نیازمندی‌ها (REQUIREMENTS)

پیش از ساخت این درایور، لازم است بسته Net-SNMP را از وب‌سایت http://www.net-snmp.org/ نصب کنید.

پروتکل SNMP v3 همچنین نیازمند پشتیبانی OpenSSL از http://www.openssl.org است.

محدودیت‌ها (LIMITATIONS)

خاموش کردن (Shutdown)

پیش از اتکا به NUT برای ارسال دستور خاموش‌سازی به یوپی‌اس، توالی خاموش شدن باید آزمایش شود. مشکل این است که ممکن است پشته شبکه میزبان (host network stack) تا زمانی که درایور برای ارسال دستور خاموش‌سازی فراخوانی می‌شود از کار افتاده باشد. درایور تلاش می‌کند دستورات shutdown.return، shutdown.reboot و load.off.delay را به ترتیب به یوپی‌اس ارسال کند و پس از اولین دستور پشتیبانی‌شده متوقف می‌شود.

استفاده از نام میزبان برای NMC یوپی‌اس (Using host names for UPS NMC)

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

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

نصب (INSTALLATION)

این درایور تنها در صورتی ساخته می‌شود که فایل‌های توسعه Net-SNMP در زمان پیکربندی موجود باشند. شما همچنین می‌توانید پیش از فراخوانی make، با استفاده از configure --with-snmp=yes ساخت آن را اجباری کنید.

مثال‌ها (EXAMPLES)

نام میزبان یوپی‌اس با مقدار "port" در ups.conf مشخص می‌شود و می‌تواند شامل یک پورت دوردست غیر استاندارد (غیر از 161) نیز باشد:

[snmpv1]
        driver = snmp-ups
        port = snmp-ups.example.com
        community = public
        snmp_version = v1
        pollfreq = 15
        desc = "Example SNMP v1 device"
[snmpv3]
        driver = snmp-ups
        port = 166.99.224.132:170
        snmp_version = v3
        secLevel = authPriv
        secName = mysecurityname
        authPassword = myauthenticationpassphrase
        privPassword = myprivatepassphrase
        desc = "Example SNMP v3 device, with the highest security level"

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

•Arnaud Quette

•Dmitry Frolov

•Jim Klimov