SNMP-UPS(8)                       راهنمای NUT                      SNMP-UPS(8)

نام (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

همچنین ببینید (SEE ALSO)
   درایور اصلی (The core driver):
       nutupsdrv(8)

   کتابخانه پروتکل‌های SNMP در NUT (NUT SNMP Protocols Library)
       در دسترس در: https://www.networkupstools.org/ups-protocols.html#_snmp

   منابع اینترنتی (Internet resources):
       صفحه خانگی NUT (Network UPS Tools):
       https://www.networkupstools.org/historic/v2.8.5/

Network UPS Tools 2.8.5           06/21/2026                       SNMP-UPS(8)