'\" t .\" Title: snmp-ups .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 06/21/2026 .\" Manual: راهنمای NUT .\" Source: Network UPS Tools 2.8.5 .\" Language: Persian .\" .TH "SNMP\-UPS" "8" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "راهنمای NUT" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" snmp-ups \- درایور چند\-MIB برای تجهیزات یوپی‌اس SNMP .SH "خلاصه دستور (SYNOPSIS)" .sp \fBsnmp\-ups\fR \-h .sp \fBsnmp\-ups\fR \-a \fIUPS_NAME\fR [\fIOPTIONS\fR] .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBنکته\fR .ps -1 .br .sp این صفحه راهنما فقط ویژگی‌های وابسته به سخت‌افزار درایور snmp\-ups را مستند می‌کند\&. برای اطلاعات بیشتر درباره درایور اصلی، به \fBnutupsdrv\fR(8) مراجعه کنید\&. .sp .5v .RE .SH "سخت‌افزارهای پشتیبانی‌شده (SUPPORTED HARDWARE)" .sp درایور snmp\-ups با بارگذاری MIBهای گوناگون، طیف گسترده‌ای از دستگاه‌ها را به طور خودکار شناسایی و پشتیبانی می‌کند، مانند: .PP \fBietf\fR .RS 4 یوپی‌اس‌های سازگار با استاندارد RFC 1628 (UPS MIB)، مانند MGE UPS SYSTEMS، Liebert و احتمالاً موارد دیگر (پیش‌فرض) .RE .PP \fBmge\fR .RS 4 دستگاه‌های MGE UPS SYSTEMS و MGE Office Protection Systems دارای کارت‌های SNMP (شناسه‌های 66062، 66045، 66074 و 66244) .RE .PP \fBapcc\fR .RS 4 کارت‌های مدیریت شبکه APC شامل AP9605، AP9606، AP9617 و AP9618، و همچنین هر کارت دیگری که از APC POWERNET MIB پشتیبانی کند .RE .PP \fBnetvision\fR .RS 4 یوپی‌اس Socomec Sicon به همراه کارت مدیریت/باکس خارجی وب/SNMP مدل Netvision .RE .PP \fBeaton_pw_nm2\fR .RS 4 دستگاه‌های Powerware با کارت‌های SNMP مدل ConnectUPS، و همچنین یوپی‌اس‌های با کارت‌های شبکه گیگابیت Eaton (Network\-M2) (تغییر نام‌یافته از pw) .RE .PP \fBeaton_pxg_ups\fR .RS 4 دستگاه‌های Eaton با کارت Power Xpert Gateway UPS Card (تغییر نام‌یافته از pxgx_ups) .RE .PP \fBaphel_genesisII\fR .RS 4 دستگاه Eaton Powerware ePDU Monitored .RE .PP \fBaphel_revelation\fR .RS 4 دستگاه Eaton Powerware ePDU Managed .RE .PP \fBraritan\fR .RS 4 واحدهای مختلف توزیع برق (PDU) شرکت Raritan (مدل‌های Dominion PX، PM، RPC) .RE .PP \fBraritan\-px2\fR .RS 4 واحدهای مختلف توزیع برق (PDU) شرکت Raritan (مدل Dominion PX2) .RE .PP \fBbaytech\fR .RS 4 واحدهای مختلف توزیع برق (PDU) شرکت BayTech .RE .PP \fBcpqpower\fR .RS 4 کارت مدیریت HP/Compaq AF401A، و احتمالاً موارد دیگر .RE .PP \fBcyberpower\fR .RS 4 دستگاه Cyberpower RMCARD201\&. همچنین باید از RMCARD100 (نسخه شبکه)، RMCARD202 و RMCARD301 نیز پشتیبانی کند\&. .RE .PP \fBhuawei\fR .RS 4 دستگاه Huawei UPS5000\-E، و احتمالاً موارد دیگر .RE .PP \fBtripplite\fR .RS 4 یوپی‌اس‌های TrippLite؛ در حال حاضر این نگاشت همان نگاشت IETF MIB است که فقط از OID نقطه ورود Tripplite برای تأیید سازنده دستگاه استفاده می‌کند، و یک پیکربندی واقعی وابسته به سخت‌افزار در توسعه آینده افزوده خواهد شد\&. .RE .sp برای یک فهرست کامل و به‌روز، می‌توانید با ارسال آرگومان \fBmibs=\-\-list\fR از درایور پرس‌وجو کنید (به زیر مراجعه کنید)\&. .SH "آرگومان‌های اضافی (EXTRA ARGUMENTS)" .sp این درایور از تنظیمات اختیاری زیر در \fBups.conf\fR(5) پشتیبانی می‌کند: .PP \fBport\fR=\fIhostname[:port]\fR .RS 4 تنظیم نام میزبان (hostname) یا نشانی IP و شماره پورت عامل SNMP در طرف مقابل\&. هیچ مقدار پیش‌فرضی برای نام میزبان وجود ندارد، اما پورت پیش‌فرض 161 است\&. .RE .PP \fBmibs\fR=\fI\-\-list\fR .RS 4 گزینه‌ای ویژه که امکان فهرست کردن نگاشت‌های فعلی شناخته‌شده بین MIB به NUT و خروج از برنامه اجرایی درایور را فراهم می‌کند؛ برای استفاده در خط فرمان به این صورت در نظر گرفته شده است: .sp .if n \{\ .RS 4 .\} .nf :; snmp\-ups \-a snmp\-test \-x mibs=\-\-list .fi .if n \{\ .RE .\} .RE .PP \fBmibs\fR=\fIname\fR .RS 4 تنظیم سازگاری با MIB (پیش‌فرض=\fIauto\fR، مقادیر مجاز: به بخش سخت‌افزارهای پشتیبانی‌شده در بالا مراجعه کنید)\&. .sp با مقدار "auto"، درایور مجموعه‌ای برگزیده از اشیاء SNMP را امتحان می‌کند تا زمانی که شیئی بیابد که دستگاه به آن پاسخ می‌دهد\&. .sp توجه داشته باشید که از NUT 2\&.6\&.2 به بعد، snmp\-ups روش جدیدی دارد که از sysObjectID (که اشاره‌گری به MIB ترجیحی دستگاه است) برای شناسایی دستگاه‌های پشتیبانی‌شده استفاده می‌کند\&. این امر \fBالزام\fR استفاده از گزینه "mibs" را بی‌اثر می‌کند\&. .RE .PP \fBcommunity\fR=\fIname\fR .RS 4 تنظیم نام انجمن (community name) (پیش‌فرض \fIpublic\fR است) برای اتصالات SNMPv1 و SNMPv2c\&. توجه داشته باشید که برای تغییر تنظیمات یوپی‌اس و ارسال دستورات (مانند خاموش کردن دستگاه)، یک نام انجمن با قابلیت خواندن و نوشتن (RW) لازم است\&. .RE .PP \fBsnmp_version\fR=\fIversion\fR .RS 4 تنظیم نسخه SNMP (پیش‌فرض = v1، مقادیر مجاز: v2c، v3) .RE .PP \fBsnmp_retries\fR=\fIretries\fR .RS 4 تعداد تلاش‌های مجدد Net\-SNMP را برای استفاده در درخواست‌ها مشخص می‌کند (پیش‌فرض=5) .RE .PP \fBsnmp_timeout\fR=\fItimeout\fR .RS 4 مدت‌زمان انتظار Net\-SNMP بر حسب ثانیه بین تلاش‌های مجدد را مشخص می‌کند (پیش‌فرض=1) .RE .PP \fBsymmetrathreephase\fR .RS 4 فعال‌سازی رفتارهای ویژه سه‌فاز APCC Symmetra (قابل استفاده روی تجهیزات سه‌فاز APCC Symmetra): تبدیل ولتاژ سه‌فاز خط به خط (line\-to\-line) به ولتاژ خط به نول (line\-to\-neutral) (پیش‌فرض: غیرفعال) .RE .PP \fBpollfreq\fR=\fInum\fR .RS 4 تنظیم بازه زمانی نظرسنجی (polling) برای به‌روزرسانی‌های کامل، بر حسب ثانیه، جهت کاهش ترافیک شبکه SNMP در مقایسه با به‌روزرسانی‌های سریعی که در هر "pollinterval" انجام می‌شوند (گزینه اخیر در \fBups.conf\fR(5) توضیح داده شده است)\&. مقدار پیش‌فرض ۳۰ (بر حسب ثانیه) است\&. .RE .PP \fBnotransferoids\fR .RS 4 غیرفعال کردن نظارت بر OIDهای انتقال ولتاژ بالا و پایین در سخت‌افزار\&. این گزینه input\&.transfer\&.low و input\&.transfer\&.high را از فهرست متغیرها حذف می‌کند\&. این گزینه فقط باید روی تجهیزات APCC Symmetra استفاده شود که در گزارش برق سه‌فاز رفتارهای نامتعارفی دارند\&. .RE .PP \fBsecLevel\fR=\fIvalue\fR .RS 4 تنظیم securityLevel مورد استفاده برای پیام‌های SNMPv3 (پیش‌فرض=noAuthNoPriv، مقادیر مجاز: authNoPriv,authPriv)\&. این پارامتر در صورت استفاده از احراز هویت غیربدیهی (غیرساده) الزامی است\&. .RE .PP \fBsecName\fR=\fIvalue\fR .RS 4 تنظیم securityName مورد استفاده برای پیام‌های احراز هویت‌شده SNMPv3 (بدون پیش‌فرض) .RE .PP \fBauthPassword\fR=\fIvalue\fR .RS 4 تنظیم عبارت عبور احراز هویت برای پیام‌های احراز هویت‌شده SNMPv3 (بدون پیش‌فرض) .RE .PP \fBprivPassword\fR=\fIvalue\fR .RS 4 تنظیم عبارت عبور محرمانگی برای پیام‌های رمزگذاری‌شده SNMPv3 (بدون پیش‌فرض) .RE .PP \fBauthProtocol\fR=\fIvalue\fR .RS 4 تنظیم پروتکل احراز هویت (MD5، SHA، SHA256، SHA384 یا SHA512) مورد استفاده برای پیام‌های احراز هویت‌شده SNMPv3 (پیش‌فرض=MD5)\&. توجه داشته باشید که فهرست دقیق پروتکل‌ها به قابلیت‌های کتابخانه Net\-SNMP بستگی دارد؛ راهنمای برنامه باینری snmp\-ups را برای فهرست موارد پشتیبانی‌شده در زمان اجرا بررسی کنید\&. .RE .PP \fBprivProtocol\fR=\fIvalue\fR .RS 4 تنظیم پروتکل محرمانگی (DES، AES، AES192 یا AES256) مورد استفاده برای پیام‌های رمزگذاری‌شده SNMPv3 (پیش‌فرض=DES)\&. توجه داشته باشید که فهرست دقیق پروتکل‌ها به قابلیت‌های کتابخانه Net\-SNMP بستگی دارد؛ راهنمای برنامه باینری snmp\-ups را برای فهرست موارد پشتیبانی‌شده در زمان اجرا بررسی کنید\&. .RE .SH "نیازمندی‌ها (REQUIREMENTS)" .sp پیش از ساخت این درایور، لازم است بسته Net\-SNMP را از وب‌سایت http://www\&.net\-snmp\&.org/ نصب کنید\&. .sp پروتکل SNMP v3 همچنین نیازمند پشتیبانی OpenSSL از http://www\&.openssl\&.org است\&. .SH "محدودیت‌ها (LIMITATIONS)" .SS "خاموش کردن (Shutdown)" .sp پیش از اتکا به NUT برای ارسال دستور خاموش‌سازی به یوپی‌اس، توالی خاموش شدن باید آزمایش شود\&. مشکل این است که ممکن است پشته شبکه میزبان (host network stack) تا زمانی که درایور برای ارسال دستور خاموش‌سازی فراخوانی می‌شود از کار افتاده باشد\&. درایور تلاش می‌کند دستورات shutdown\&.return، shutdown\&.reboot و load\&.off\&.delay را به ترتیب به یوپی‌اس ارسال کند و پس از اولین دستور پشتیبانی‌شده متوقف می‌شود\&. .SS "استفاده از نام میزبان برای NMC یوپی‌اس (Using host names for UPS NMC)" .sp کارت مدیریت شبکه (NMC) یوپی‌اس ممکن است در شبکه شما یک نشانی IP ثابت/استاتیک یا یک نشانی پویا (مثلاً از طریق DHCP) دریافت کرده باشد\&. به همین دلیل، ممکن است بخواهید یا مجبور باشید از یک سرویس نام‌گذاری پویا برای دسترسی به یوپی‌اس استفاده کنید\&. توجه داشته باشید که این موضوع می‌تواند به‌ویژه در هنگام قطعی‌های گسترده برق و خاموش شدن‌ها مشکل‌ساز شود، زیرا ممکن است سرور DHCP/DNS شما پیش از این که درایور بتواند نام مورد نظر را تحلیل (resolve) کند از دسترس خارج شده باشد (به‌ویژه در قلاب‌های خاموش‌سازی دیرهنگام، زمانی که یک نمونه جدید از برنامه درایور ممکن است تنها برای دستور خاموش کردن یا بازنشانی چرخه برق یوپی‌اس اجرا شود)\&. .sp شاید هوشمندانه باشد اطمینان حاصل کنید که کلاینت سرویس نام‌گذاری سیستم‌عامل شما می‌تواند نام یوپی‌اس را به مدت کافی در حافظه موقت (cache) نگه دارد، یا از آدرس‌دهی IP ثابت (و برای محکم‌کاری، یک مدخل در etc/hosts/ تا در صورت نیاز به پیکربندی مجدد فقط یک نقطه را تغییر دهید) استفاده کنید\&. .SH "نصب (INSTALLATION)" .sp این درایور تنها در صورتی ساخته می‌شود که فایل‌های توسعه Net\-SNMP در زمان پیکربندی موجود باشند\&. شما همچنین می‌توانید پیش از فراخوانی make، با استفاده از configure \-\-with\-snmp=yes ساخت آن را اجباری کنید\&. .SH "مثال‌ها (EXAMPLES)" .sp نام میزبان یوپی‌اس با مقدار "port" در ups\&.conf مشخص می‌شود و می‌تواند شامل یک پورت دوردست غیر استاندارد (غیر از 161) نیز باشد: .sp .if n \{\ .RS 4 .\} .nf [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" .fi .if n \{\ .RE .\} .SH "نویسندگان (AUTHORS)" .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Arnaud Quette .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Dmitry Frolov .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Jim Klimov .RE .SH "همچنین ببینید (SEE ALSO)" .SS "درایور اصلی (The core driver):" .sp \fBnutupsdrv\fR(8) .SS "کتابخانه پروتکل‌های SNMP در NUT (NUT SNMP Protocols Library)" .sp در دسترس در: https://www\&.networkupstools\&.org/ups\-protocols\&.html#_snmp .SS "منابع اینترنتی (Internet resources):" .sp صفحه خانگی NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5/