نام (NAME)

nutconf - ابزار پیکربندی NUT

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

nutconf --help

nutconf [گزینه‌ها]

توضیحات (DESCRIPTION)

ابزار nutconf برای ایجاد و دستکاری فایل‌های پیکربندی NUT به کار می‌رود. همچنین از پویش دستگاه‌ها (جهت پیشنهاد دادن پیکربندی دستگاه‌ها) پشتیبانی می‌کند.

نصب (INSTALLATION)

قابلیت پویش به همان وابستگی‌های زمان کامپایل و زمان اجرای ابزار nut-scanner وابسته است.

گزینه‌ها (OPTIONS)

-h | -help | --help

نمایش متن راهنما.

-D

افزایش سطح اشکال‌زدایی. برای جزئیات بیشتر این گزینه را چندین بار به کار ببرید. متغیر محیطی اختیاری NUT_DEBUG_LEVEL را بازنویسی (override) می‌کند.

-v | --verbose

افزایش پرگویی خروجی (می‌تواند چندین بار استفاده شود).

--is-configured

بررسی می‌کند که آیا پیش‌تر NUT پیکربندی شده است یا خیر.

--system

دایرکتوری پیکربندی سیستمی باید استفاده شود.

--local directory

یک دایرکتوری پیکربندی جایگزین را تنظیم می‌کند.

--get-mode

حالت کنونی پیکربندی NUT را چاپ می‌کند.

--set-mode mode

حالت پیکربندی NUT را تنظیم می‌کند.

حالت‌های شناخته‌شده عبارتند از:

•standalone

•netserver

•netclient

•controlled

•manual

•none

گزینه‌های تنظیم/افزودن مدخل پیکربندی (CONFIGURATION ENTRY SET/ADD OPTIONS)

این گزینه‌ها بیشتر دارای ۲ شکل هستند: --set-... یا --add-....

تفاوت در این است که گزینه‌های set تنظیمات قبلی را دور می‌ریزند، در حالی که گزینه‌های add آن‌ها را حفظ می‌کنند.

توجه داشته باشید که این‌گونه گزینه‌ها را می‌توان چندین بار در یک مرتبه اجرا مشخص کرد (تا تنظیم هم‌زمان چندین مدخل امکان‌پذیر باشد).

--set-monitor | --add-monitor <arguments>

یک ناظر (monitor) برای NUT تنظیم می‌کند/می‌افزاید.

•آرگومان‌ها:

'<ups_ID>' '<host>[:<port>]' '<power_value>' '<user>' '<passwd>' '(\"master\"|\"slave\")'

--set-listen | --add-listen <address> [<port>]

نشانی شنود دیمن upsd(8) را تنظیم می‌کند/می‌افزاید.

--set-device | --add-device <arguments>

یک دستگاه (معمولاً یک UPS) را تنظیم می‌کند/می‌افزاید.

•آرگومان‌ها:

'<ups_ID>' '<driver>' '<port>' '[<attribute>=<value>]*'

جفت‌های ویژگی/مقدار (attribute/value) از قواعد نحوی پیکربندی دستگاه پیروی می‌کنند. دستگاه‌ها بسته به درایور ممکن است ویژگی‌های پیکربندی بسیار متفاوتی داشته باشند. شرح کامل آن‌ها فراتر از این صفحه man است و می‌توان آن را در مستندات NUT یافت.

--set-notifyflags | --add-notifyflags <type> <flag>+

پرچم‌های اعلان را برای نوع اعلان مشخص‌شده تنظیم می‌کند/می‌افزاید.

•انواع اعلان عبارتند از:

•ONLINE (برق شهر وصل است)

•ONBATT (برق شهر قطع شده و روی باتری است)

•LOWBATT (ظرفیت باقی‌مانده باتری کم است)

•FSD (خاموش شدن اجباری صادر شده است)

•COMMOK (ارتباط با دستگاه برقرار شد)

•COMMBAD (ارتباط با دستگاه قطع شد)

•SHUTDOWN (سیستم اکنون در حال خاموش شدن است)

•REPLBATT (باتری UPS نیاز به تعویض دارد)

•NOCOMM (دستگاه در دسترس نیست)

•NOPARENT (فرایند والد upsmon خاتمه یافته است، خاموش شدن غیرممکن است)

•CAL (کالیبراسیون در حال انجام است)

•NOTCAL (کالیبراسیون پایان یافت)

•OFF (یوپی‌اس از نظر مدیریتی خاموش یا در خواب است، باید با دستور بیدار شود)

•NOTOFF (یوپی‌اس دیگر از نظر مدیریتی خاموش یا در خواب نیست)

•BYPASS (روی حالت بای‌پس = دارای برق، اما بدون محافظت)

•NOTBYPASS (دیگر روی حالت بای‌پس نیست)

•ALARM (یوپی‌اس در وضعیت هشدار است (هشدارهای فعال دارد))

•NOTALARM (یوپی‌اس دیگر در وضعیت هشدار نیست (هشدار فعالی ندارد))

•OVER (دارای بار بیش از حد / اضافه‌بار)

•NOTOVER (دیگر در وضعیت اضافه‌بار نیست)

•TRIM (در حال تعدیل/کاهش ولتاژ ورودی)

•NOTTRIM (دیگر در حال تعدیل/کاهش ولتاژ ورودی نیست)

•BOOST (در حال تقویت ولتاژ ورودی)

•NOTBOOST (دیگر در حال تقویت ولتاژ ورودی نیست)

•OTHER (یوپی‌اس دست‌کم یک نشانه وضعیت دسته‌بندی‌نشده دارد)

•NOTOTHER (یوپی‌اس دیگر هیچ نشانه وضعیت دسته‌بندی‌نشده‌ای ندارد)

•SUSPEND_STARTING (سیستم‌عامل در حال ورود به حالت تعلیق/خواب/خواب‌زمستانی است)

•SUSPEND_FINISHED (خروج سیستم‌عامل از حالت تعلیق/خواب/خواب‌زمستانی به‌تازگی پایان یافت)

•پرچم‌های اعلان:

•SYSLOG (استفاده از syslogd برای ثبت لاگ اعلان)

•WALL (ارسال پیام همگانی به ترمینال‌های کاربران)

•EXEC (اجرای یک دستور)

•IGNORE (عدم اقدام / نادیده گرفتن)

--set-notifymsg <type> <message>

پیام مربوط به نوع اعلان مشخص‌شده را تنظیم می‌کند.

--set-shutdowncmd <command>

دستور مورد استفاده برای خاموش کردن سیستم را تنظیم می‌کند.

--set-user | --add-user <arguments>

کاربر NUT را تنظیم می‌کند/می‌افزاید.

•آرگومان‌ها:

•<username> (نام کاربری را مشخص می‌کند). برای کاربر upsmon، دارای شکل ویژه‌ای به صورت upsmon=(primary|master|secondary|slave) است که حالت نظارت را تعیین می‌کند.

•password=<passwd> گذرواژه را برای کاربر تنظیم می‌کند

•actions=<actions> اقدامات را تنظیم می‌کند (از SET و FSD پشتیبانی می‌شود)

•instcmds=<command> دستورات فوری مجاز برای کاربر را تنظیم می‌کند (می‌تواند چندین بار استفاده شود)

گزینه‌های پویش (SCANNING OPTIONS)

در دسترس بودن هر گزینه پویش به در دسترس بودن کتابخانه‌های شخص ثالث مختلف در زمان کامپایل و زمان اجرا بستگی دارد.

ابزار را با گزینه --help اجرا کنید تا بررسی کنید کدام‌یک از گزینه‌های --scan-... در عمل پشتیبانی می‌شوند.

تمام زمان‌های مهلت (timeout) بر حسب میکروثانیه هستند.

--scan-snmp <start IP> <stop IP> [<attribute>=<value>]*

دستگاه‌های SNMP را روی نشانی‌های IP در محدوده مشخص‌شده پویش می‌کند.

•ویژگی‌های شناخته‌شده عبارتند از:

•timeout مهلت زمانی پویش دستگاه

•community جامعه SNMP (پیش‌فرض: public)

•sec-level سطح امنیت (SNMPv3)؛ یکی از noAuthNoPriv، authNoPriv، authPriv

•sec-name نام امنیت (SNMPv3)؛ همراه اجباری sec-level

•auth-password گذرواژه احراز هویت (SNMPv3)؛ اجباری برای authNoPriv و authPriv

•priv-password گذرواژه حریم خصوصی (SNMPv3)؛ اجباری برای authPriv

•auth-protocol پروتکل احراز هویت (SNMPv3): MD5 یا SHA، که MD5 پیش‌فرض است

•priv-protocol پروتکل حریم خصوصی (SNMPv3): DES یا AES، که DES پیش‌فرض است

•peer-name نام همتا

--scan-usb

گذرگاه USB را برای یافتن دستگاه‌های شناخته‌شده پویش می‌کند.

--scan-xml-http [<timeout>]

دستگاه‌های XML/HTTP را در شبکه پویش می‌کند.

--scan-nut <start IP> <stop IP> <port> [<timeout>]

(شبه‌)دستگاه‌های NUT را در شبکه پویش می‌کند.

--scan-avahi [<timeout>]

دستگاه‌های Avahi را پویش می‌کند.

--scan-ipmi <start IP> <stop IP> [<attribute>=<value>]*

دستگاه‌های IPMI را روی نشانی‌های IP در محدوده مشخص‌شده پویش می‌کند.

•ویژگی‌های شناخته‌شده عبارتند از:

•username نام کاربری (برای IPMI/LAN اجباری است)

•password گذرواژه کاربر (برای IPMI/LAN اجباری است)

•auth-type نوع احراز هویت (در ادامه را ببینید)

•cipher-suite-id شناسه مجموعه‌رمز (در ادامه را ببینید)

•K-g-BMC-key کلید دوم اختیاری (؟؟؟)

•priv-level سطح دسترسی

•workaround-flags پرچم‌های راهکار موقت

•version (1.5 یا 2.0)

•انواع احراز هویت:

نوع احراز هویت IPMI 1.5 را برای استفاده با میزبان راه دور مشخص می‌کند (NONE، STRAIGHT_PASSWORD_KEY، MD2 و MD5) (پیش‌فرض=MD5). این امر اتصال را از طریق رابط IPMI با نام lan و در نتیجه در حالت IPMI 1.5 اجبار می‌کند.

•none (احراز هویت غیرفعال است)

•MD2

•MD5 (پیش‌فرض)

•plain-password (هیچ رمزنگاری برای ارسال گذرواژه استفاده نمی‌شود)

•OEM

•RMCPplus

•شناسه‌های مجموعه‌رمز (Cipher suite IDs):

شناسه مجموعه‌رمز IPMI 2.0 را برای استفاده مشخص می‌کند.

شناسه مجموعه‌رمز، مجموعه‌ای از الگوریتم‌های احراز هویت، یکپارچگی، و محرمانگی را که برای ارتباطات IPMI 2.0 استفاده می‌شوند، مشخص می‌کند.

الگوریتم احراز هویت، الگوریتم مورد استفاده برای برپایی نشست را مشخص می‌کند، الگوریتم یکپارچگی، الگوریتم مورد استفاده برای امضای بسته‌های نشست را مشخص می‌کند، و الگوریتم محرمانگی، الگوریتم مورد استفاده برای رمزنگاری داده‌ها (payload) را تعیین می‌کند (پیش‌فرض=3).

شناسه‌های مجموعه‌رمز زیر در حال حاضر پشتیبانی می‌شوند:

کد	احراز هویت	یکپارچگی	محرمانگی
0	None	None	None
1	HMAC-SHA1	None	None
2	HMAC-SHA1	HMAC-SHA1-96	None
3	HMAC-SHA1	HMAC-SHA1-96	AES-CBC-128
6	HMAC-MD5	None	None
7	HMAC-MD5	HMAC-MD5-128	None
8	HMAC-MD5	HMAC-MD5-128	AES-CBC-128
11	HMAC-MD5	MD5-128	None
12	HMAC-MD5	MD5-128	AES-CBC-128
15	HMAC-SHA256	None	None
16	HMAC-SHA256	HMAC_SHA256_128	None
17	HMAC-SHA256	HMAC_SHA256_128	AES-CBC-128

--scan-serial <port>*

پویش برای یافتن دستگاه‌های سریال (از انواع پشتیبانی‌شده) روی درگاه(های) سریال مشخص‌شده.

مثال‌ها (EXAMPLES)

برای تنظیم دایرکتوری جایگزین برای فایل‌های پیکربندی:

:; nutconf --local ~/test/nut/etc

برای افزودن کاربری دیگر (با حفظ کاربران موجود):

:; nutconf --add-user bart password=qwerty

برای پویش دستگاه‌های USB و دستگاه‌های سریال (روی دو درگاه اول):

:; nutconf --scan-usb --scan-serial /dev/ttyS1 /dev/ttyS2

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

ups.conf(5) nut-scanner(8)

منابع اینترنتی (INTERNET RESOURCES)

صفحه اصلی NUT (Network UPS Tools): http://www.networkupstools.org/