'\" t
.\"     Title: upsmon.conf
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/21/2026
.\"    Manual: NUT Manual
.\"    Source: Network UPS Tools 2.8.5
.\"  Language: Persian
.\"
.TH "UPSMON\&.CONF" "5" "06/21/2026" "Network UPS Tools 2\&.8\&.5" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
upsmon.conf \- پیکربندی کلاینت upsmon ابزارهای Network UPS Tools (NUT)
.SH "توضیحات (DESCRIPTION)"
.sp
وظیفه اصلی این فایل تعریف سیستم‌هایی است که \fBupsmon\fR(8) آن‌ها را پایش خواهد کرد، و همچنین مشخص کردن نحوه خاموش کردن سیستم در زمان‌های ضروری است\&. این فایل حاوی گذرواژه‌ها خواهد بود، بنابراین آن را امن نگه دارید\&. در حالت ایده‌آل، فقط فرایند upsmon باید قادر به خواندن آن باشد\&.
.sp
یک پیکربندی حداقلی باید دست‌کم شامل یک دستور MONITOR، یک MINSUPPLIES (اگر این سیستم فقط سایر سرورهای NUT را پایش می‌کند، می‌تواند \fI0\fR باشد)، و یک POWERDOWNFLAG باشد (اگر این دستگاه یک سیستم «اصلی» (primary) متصل به UPS است و فرمان قطع برق خاموشی دیرهنگام آن را در مواقع اضطراری هدایت می‌کند)\&.
.sp
علاوه بر این، مقادیر پیکربندی اختیاری دیگری نیز می‌توانند در این فایل تنظیم شوند\&.
.SH "نکات مهم (IMPORTANT NOTES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
محتوای این فایل باید تماماً ASCII باشد (کدهای نویسه‌ای که در این محدوده نباشند با یک پیام هشدار نادیده گرفته می‌شوند)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مجوزهای دسترسی کاربر زمان اجرا به این فایل (و شاید پوشه‌ای که در آن قرار دارد) را به گونه‌ای متوازن کنید که فقط
upsmon
قادر به خواندن آن باشد؛ دسترسی نوشتن لازم نیست\&. معمولاً از
chown root:nut
و
chmod 640
برای تنظیم مجوزهای دسترسی قابل قبول فایل استفاده می‌شود\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بسته‌ها (و دستورالعمل‌های ساخت) معمولاً یک مجموعه از حساب‌های کاربری و گروهی را برای NUT آماده می‌کنند\&. ساخت‌های سفارشی با پیکربندی حداقلی ممکن است حتی از
nobody:nogroup
یا موارد مشابه استفاده کنند که ذاتاً ناامن است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
در سیستم‌هایی با دغدغه‌های امنیتی بیشتر، درایورهای NUT، سرور داده و هرگونه کلاینت پایش، ثبت وقایع و غیره باید تحت حساب‌های کاربری جداگانه اجرا شوند\&. این کار نیازمند آن است که برخی دیمن‌ها از تنظیمات سفارشی
user،
group،
RUN_AS_USER
و/یا
RUN_AS_GROUP
برای بازنویسی و جایگزینی مقدار توکار استفاده کنند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
امنیت نسخه‌های پشتیبان این فایل، برای مثال فایل‌های آرشیوی که ممکن است در آن‌ها قرار گیرد را نیز مد نظر داشته باشید\&.
.RE
.RE
.SH "دستورات پیکربندی (CONFIGURATION DIRECTIVES)"
.PP
\fBDEADTIME\fR \fIseconds\fR
.RS 4
upsmon اجازه می‌دهد یک UPS به مدت این تعداد ثانیه ناپدید شود پیش از آنکه آن را «مرده» (dead) اعلام کند\&. مقدار پیش‌فرض ۱۵ ثانیه است\&.
.sp
upsmon نیازمند آن است که یک UPS هر چند ثانیه یک‌بار اطلاعات وضعیت را ارائه دهد (POLLFREQ و POLLFREQALERT را ببینید) تا همه چیز به‌روز بماند\&. اگر واکشی وضعیت ناموفق باشد، UPS به عنوان بیات (stale) علامت‌گذاری می‌شود\&. اگر بیش از DEADTIME ثانیه در وضعیت بیات باقی بماند، به عنوان مرده (dead) علامت‌گذاری خواهد شد\&.
.sp
یک UPS مرده که آخرین وضعیت شناخته‌شده آن کارکرد با باتری بوده است، فرض می‌شود به وضعیت باتری ضعیف (low battery) تغییر یافته است\&. اگر این UPS بخش بحرانی توان سیستم شما را تامین کند، این امر ممکن است سیستم را مجبور به خاموش شدن کند\&. این کار ممکن است مخرب به نظر برسد، اما راه جایگزین، پیشروی کورکورانه به سوی ناکجاآباد و از کار افتادن ناگهانی سیستم هنگام قطع کامل برق است\&.
.sp
نکته: مقدار DEADTIME باید مضربی از POLLFREQ و POLLFREQALERT باشد\&. در غیر این صورت، تنها به این دلیل که upsmon با سرعت کافی آن‌ها را نظرسنجی نمی‌کند، با UPSهای «مرده» مواجه خواهید شد\&. یک قانون سرانگشتی: مقدار بزرگتر از میان دو مقدار POLLFREQ را بگیرید و آن را در ۳ ضرب کنید\&.
.RE
.PP
\fBFINALDELAY\fR \fIseconds\fR
.RS 4
هنگام مدیریت خاموشی اجباری (FSD) به دلیل وضعیت بحرانی UPS یا سیگنال صریح کاربر،
upsmon
پس از ارسال پیام NOTIFY_SHUTDOWN برای هشدار به کاربران، به مدت این زمان منتظر می‌ماند\&. پس از سپری شدن این زمان‌سنج، دستور SHUTDOWNCMD شما را اجرا می‌کند\&. به طور پیش‌فرض این مقدار روی ۵ ثانیه تنظیم شده است\&.
.sp
اگر نیاز دارید به کاربران خود (یا اسکریپت NOTIFYCMD) اجازه دهید بین این رویدادها کاری انجام دهند، این عدد را افزایش دهید\&. به یاد داشته باشید در این مرحله باتری UPS شما تقریباً خالی شده است، بنابراین این زمان را بیش از حد طولانی نکنید\&.
.sp
به عنوان راه جایگزین، می‌توانید این مقدار را بسیار پایین تنظیم کنید تا هنگام رسیدن زمان خاموشی معطل نشوید\&. برخی UPSها هشدار چندانی برای باتری ضعیف ارائه نمی‌دهند و برای یک خاموشی ایمن به مقدار 0 در اینجا نیاز خواهند داشت\&.
.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
اگر مقدار FINALDELAY در سیستم ثانویه بزرگتر از HOSTSYNC در سیستم اولیه باشد، سیستم اولیه از انتظار برای قطع اتصال آن upsmon ثانویه منصرف خواهد شد\&.
.sp .5v
.RE
.RE
.PP
\fBHOSTSYNC\fR \fIseconds\fR
.RS 4
upsmon در حالت اولیه (primary) در طول شرایط خاموشی، حداکثر تا این تعداد ثانیه منتظر قطع اتصال سیستم‌های ثانویه می‌ماند\&. به طور پیش‌فرض، این مقدار ۱۵ ثانیه است\&.
.sp
هنگامی که یک UPS وارد وضعیت بحرانی می‌شود (روی باتری + باتری ضعیف، یا "FSD": خاموشی اجباری)، سیستم‌های ثانویه باید بلافاصله اتصال خود را قطع کرده و خاموش شوند\&. زمان‌سنج HOSTSYNC مانع از آن می‌شود که اگر یکی از سیستم‌های ثانویه گیر کرد، upsmon اولیه تا ابد منتظر بماند\&.
.sp
این مقدار همچنین برای جلوگیری از معطل ماندن سیستم‌های ثانویه در صورتی که سیستم اولیه به موقع پاسخ ندهد استفاده می‌شود\&. پس از اینکه UPS بحرانی شد، سیستم ثانویه تا HOSTSYNC ثانیه منتظر می‌ماند تا سیستم اولیه فلگ FSD را تنظیم کند\&. اگر آن زمان‌سنج منقضی شود، upsmon ثانویه فرض می‌کند که سیستم اولیه (یا مسیر ارتباطی به آن) دچار مشکل شده است و به هر حال خاموش خواهد شد\&.
.sp
این کار مانع از آن می‌شود که سیستم‌های ثانویه در طول یک تغییر وضعیت کوتاه‌مدت به "OB LB" و بازگشت از آن (که سیستم‌های ثانویه می‌بینند اما سیستم اولیه متوجه آن نمی‌شود) خاموش شوند\&.
.RE
.PP
\fBMINSUPPLIES\fR \fInum\fR
.RS 4
تعداد منابع تغذیه‌ای را تعیین کنید که برای روشن ماندن این سیستم باید برق دریافت کنند\&. رایانه‌های معمولی تنها یک منبع تغذیه دارند، بنابراین مقدار پیش‌فرض 1 قابل قبول است\&.
.sp
سیستم‌های سرور بزرگ/گران‌قیمت معمولاً منابع تغذیه بیشتری دارند و می‌توانند با قطع بودن چندتای آن‌ها نیز به کار خود ادامه دهند\&. به عنوان مثال، سرور HP NetServer LH4 می‌تواند با ۲ منبع تغذیه از ۴ منبع کار کند، بنابراین شما آن را روی 2 تنظیم می‌کنید\&. ایده اصلی این است که دستگاه تا جای ممکن روشن بماند، درست است؟
.sp
بدیهی است که برای منطقی بودن این سازوکار، باید منابع تغذیه افزونه را روی مدارهای UPS مختلف قرار دهید! برای اطلاعات بیشتر و ایده‌هایی در مورد نحوه استفاده از این ویژگی، big\-servers\&.txt را در زیرپوشه docs ببینید\&.
.sp
همچنین بخش مربوط به «مقادیر توان» در
\fBupsmon\fR(8)
را ببینید\&.
.RE
.PP
\fBMONITOR\fR \fIsystem\fR \fIpowervalue\fR \fIusername\fR \fIpassword\fR \fItype\fR
.RS 4
هر UPS که نیاز به پایش آن دارید باید دارای یک خط MONITOR باشد\&. نیازی نیست که همه آن‌ها برق سیستم اجراکننده upsmon را تامین کنند\&. اگر می‌خواهید بتوانید اعلان‌های مربوط به تغییر وضعیت آن‌ها را ارسال کنید، می‌توانید سیستم‌های دیگر را نیز پایش کنید\&.
.sp
شما باید حداقل یک دستور MONITOR در
upsmon\&.conf
داشته باشید\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIsystem\fR
شناسه یک UPS است\&. این شناسه به این فرمت است:
.sp
<upsname>[@<hostname>[:<port>]]
.sp
نام میزبان پیش‌فرض "localhost" است\&. چند مثال:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
عبارت "su700@mybox" به معنای یک UPS با نام "su700" روی سیستمی به نام "mybox" است\&. این فرمت معمول است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
عبارت "fenton@bigbox:5678" یک UPS به نام "fenton" روی سیستمی با نام "bigbox" است که
\fBupsd\fR(8)
را روی درگاه "5678" اجرا می‌کند\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIpowervalue\fR
یک عدد صحیح است که نمایانگر تعداد منابع تغذیه‌ای است که UPS در این سیستم تغذیه می‌کند\&. اکثر رایانه‌های معمولی یک منبع تغذیه دارند و UPS آن را تغذیه می‌کند، بنابراین این مقدار 1 خواهد بود\&. برای داشتن هر مقداری بالاتر از این، به یک سیستم بسیار بزرگ یا خاص نیاز دارید\&.
.sp
اگر می‌خواهید یک UPS را پایش کنید که در واقع برق این سیستم را تامین نمی‌کند، می‌توانید
\fIpowervalue\fR
را روی 0 تنظیم کنید\&. این قابلیت زمانی مفید است که می‌خواهید upsmon اعلان‌هایی درباره تغییر وضعیت یک UPS ارسال کند بدون اینکه هنگام بحرانی شدن وضعیت آن، سیستم خاموش شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مقادیر
\fIusername\fR
و
\fIpassword\fR
در این خط باید با یک مدخل در فایل
\fBupsd.users\fR(5)
سیستم سرور
upsd
مطابقت داشته باشد\&.
.sp
اگر نام کاربری شما "observer" و گذرواژه شما "abcd" باشد، خط MONITOR ممکن است شبیه این باشد (احتمالاً در یک سیستم ثانویه راه دور):
.sp
.if n \{\
.RS 4
.\}
.nf
MONITOR myups@bigserver 1 observer abcd secondary
.fi
.if n \{\
.RE
.\}
.sp
در همین حال، فایل
upsd\&.users
روی
bigserver
به این شکل خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
[observer]
        password = abcd
        upsmon secondary

[upswired]
        password = blah
        upsmon primary
.fi
.if n \{\
.RE
.\}
.sp
و نسخه upsmon روی آن bigserver با پیکربندی اولیه اجرا می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
MONITOR myups@bigserver 1 upswired blah primary
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
پارامتر
\fItype\fR
به رابطه با
\fBupsd\fR(8)
اشاره دارد\&. این مقدار می‌تواند "primary" یا "secondary" باشد\&. برای اطلاعات بیشتر در مورد مفهوم این حالت‌ها،
\fBupsmon\fR(8)
را ببینید\&. حالتی که در اینجا انتخاب می‌کنید در فایل
upsd\&.users
نیز قرار می‌گیرد، همان‌طور که در مثال بالا دیده شد\&.
.RE
.RE
.PP
\fBNOCOMMWARNTIME\fR \fIseconds\fR
.RS 4
اگر upsmon نتواند به هیچ‌یک از مدخل‌های UPS در این فایل پیکربندی دسترسی پیدا کند، پس از این تعداد ثانیه یک NOTIFY_NOCOMM را راه‌اندازی می‌کند\&. تا زمانی که مشکل برطرف نشود، به هشدار دادن به شما ادامه می‌دهد\&. به طور پیش‌فرض این مقدار ۳۰۰ ثانیه است\&.
.RE
.PP
\fBPOLLFAIL_LOG_THROTTLE_MAX\fR \fIcount\fR
.RS 4
upsmon معمولاً خرابی‌های نظرسنجی را برای هر دستگاه که در هر چرخه POLLFREQ برقرار است (مانند "Data stale" یا "Driver not connected") طبق پیکربندی در گزارش‌های سیستم ثبت می‌کند\&. اگر انتظار می‌رود دستگاه‌های شما برای مدتی طولانی غایب باشند، می‌توانید از این محدودکننده برای کاهش بار روی ترافیک و ذخیره‌سازی syslog استفاده کنید؛ با ارسال این پیام‌ها تنها یک بار در هر چند چرخه، و زمانی که وضعیت خطا تغییر کرده یا برطرف شده باشد\&.
.sp
یک مقدار منفی به معنای رفتار استاندارد است (ثبت در گزارش در هر چرخه، عملاً همانند حالتی که
max=1
است)، و مقدار صفر به این معناست که پیام هرگز تکرار نشود (تنها در شروع و پایان/تغییر وضعیت خرابی ثبت شود)\&.
.sp
توجه داشته باشید که این محدودکننده تنها برای یک وضعیت خطای فعال اخیر به ازای هر دستگاه پایش‌شده اعمال می‌شود\&.
.RE
.PP
\fBNOTIFYCMD\fR \fIcommand\fR
.RS 4
هنگام وقوع رویدادها، upsmon این دستور را برای ارسال پیام‌ها فرامی‌خواند\&.
.sp
این دستور با متن کامل پیام به عنوان یک آرگومان فراخوانی می‌شود\&. متغیر محیطی NOTIFYTYPE حاوی رشته نوع عاملی خواهد بود که باعث وقوع این رویداد شده است\&.
.sp
اگر نیاز به استفاده از
\fBupssched\fR(8)
دارید، باید با ذکر نام آن در اینجا، آن را به عنوان NOTIFYCMD خود قرار دهید\&.
.sp
توجه داشته باشید که این دستور تنها برای رویدادهای NOTIFY فراخوانی می‌شود که EXEC برای آن‌ها با NOTIFYFLAG تنظیم شده باشد\&. برای جزئیات بیشتر، NOTIFYFLAG را در ادامه ببینید\&.
.sp
تبدیل این دستور به نوعی اسکریپت شل می‌تواند ایده بدی نباشد\&. برای اطلاعات و ایده‌های بیشتر، docs/scheduling\&.txt را ببینید\&.
.sp
به یاد داشته باشید، این دستور همچنین باید یک مؤلفه منفرد در فایل پیکربندی باشد، بنابراین اگر دستور شما دارای فاصله است، آن را در علامت نقل‌قول قرار دهید\&.
.sp
NOTIFYCMD "/path/to/script \-\-foo \-\-bar"
.sp
این اسکریپت در پس‌زمینه اجرا می‌شود\(emیعنی upsmon پیش از فراخوانی برای شروع آن، یک انشعاب (fork) ایجاد می‌کند\&. این بدان معناست که اگر رویدادهای زیادی به طور همزمان رخ دهند، NOTIFYCMD شما ممکن است چندین نمونه در حال اجرای همزمان داشته باشد\&. هنگام طراحی اعلان‌کننده‌های پیچیده این نکته را مد نظر داشته باشید\&.
.RE
.PP
\fBNOTIFYMSG\fR \fItype\fR \fImessage\fR
.RS 4
برنامه upsmon همراه با مجموعه‌ای از پیام‌های پیش‌فرض برای رویدادهای مختلف عرضه می‌شود\&. در صورت تمایل می‌توانید آن‌ها را تغییر دهید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
NOTIFYMSG ONLINE "UPS %s is getting line power"
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
NOTIFYMSG ONBATT "Someone pulled the plug on %s"
.fi
.if n \{\
.RE
.\}
.sp
توجه داشته باشید که
%s
با شناسه UPS مورد نظر جایگزین می‌شود\&.
.sp
پیام باید یک مؤلفه منفرد در فایل پیکربندی باشد، بنابراین اگر حاوی فاصله است، باید آن را در علامت نقل‌قول قرار دهید\&.
.sp
.if n \{\
.RS 4
.\}
.nf
NOTIFYMSG NOCOMM "Someone stole UPS %s"
.fi
.if n \{\
.RE
.\}
.sp
مقادیر ممکن برای
\fItype\fR:
.PP
ONLINE
.RS 4
یوپی‌اس دوباره آنلاین است
.RE
.PP
ONBATT
.RS 4
یوپی‌اس روی باتری است
.RE
.PP
LOWBATT
.RS 4
یوپی‌اس روی باتری است و باتری ضعیف دارد (وضعیت بحرانی است)
.RE
.PP
FSD
.RS 4
یوپی‌اس توسط سیستم اولیه در حال خاموش شدن است (FSD = «خاموشی اجباری» یا "Forced Shutdown")
.RE
.PP
COMMOK
.RS 4
ارتباط با UPS برقرار شد
.RE
.PP
COMMBAD
.RS 4
ارتباط با UPS قطع شد
.RE
.PP
SHUTDOWN
.RS 4
سیستم در حال خاموش شدن است
.RE
.PP
SHUTDOWN_HOSTSYNC
.RS 4
این سیستم اولیه خاموشی را آغاز کرد و منتظر سیستم‌های ثانویه است
.RE
.PP
REPLBATT
.RS 4
باتری UPS خراب است و نیاز به تعویض دارد
.RE
.PP
NOCOMM
.RS 4
یک UPS در دسترس نیست (برای پایش امکان برقراری ارتباط با آن وجود ندارد)
.RE
.PP
NOPARENT
.RS 4
فرایند والد
upsmon
از بین رفت \- خاموش کردن سیستم غیرممکن است
.RE
.PP
CAL
.RS 4
کالیبراسیون UPS در حال انجام است
.RE
.PP
NOTCAL
.RS 4
کالیبراسیون UPS پایان یافت
.RE
.PP
OFF
.RS 4
یوپی‌اس به صورت مدیریتی خاموش یا به خواب رفته است
.RE
.PP
NOTOFF
.RS 4
یوپی‌اس دیگر به صورت مدیریتی خاموش یا به خواب رفته نیست
.RE
.PP
BYPASS
.RS 4
یوپی‌اس روی بای‌پس است (برق متصل است اما محافظت نمی‌کند)
.RE
.PP
NOTBYPASS
.RS 4
یوپی‌اس دیگر روی حالت بای‌پس نیست
.RE
.PP
ECO
.RS 4
یوپی‌اس در حالت ECO یا حالت مشابه است (همان‌طور که توسط سازنده تعریف و نام‌گذاری شده است)؛ برای جزئیات بیشتر
\fBupsmon\fR(8)
را ببینید\&.
.RE
.PP
NOTECO
.RS 4
یوپی‌اس دیگر در حالت ECO نیست (بالا را ببینید)
.RE
.PP
ALARM
.RS 4
یوپی‌اس دارای یک یا چند هشدار فعال است (ups\&.alarm را بررسی کنید)؛ برای این اعلان،
message
می‌تواند حاوی یک جانگهدارنده دوم
%s
باشد تا مقدار فعلی
ups\&.alarm
را جایگزین کند\&.
.RE
.PP
NOTALARM
.RS 4
یوپی‌اس دیگر در وضعیت هشدار نیست (بدون هشدار فعال)
.RE
.PP
OVER
.RS 4
یوپی‌اس دچار اضافه‌بار شده است
.RE
.PP
NOTOVER
.RS 4
یوپی‌اس دیگر دچار اضافه‌بار نیست
.RE
.PP
TRIM
.RS 4
یوپی‌اس در حال کاهش ولتاژ ورودی است
.RE
.PP
NOTTRIM
.RS 4
یوپی‌اس دیگر ولتاژ ورودی را کاهش نمی‌دهد
.RE
.PP
BOOST
.RS 4
یوپی‌اس در حال افزایش ولتاژ ورودی است
.RE
.PP
NOTBOOST
.RS 4
یوپی‌اس دیگر ولتاژ ورودی را افزایش نمی‌دهد
.RE
.PP
OTHER
.RS 4
یوپی‌اس دست‌کم یک نشانه طبقه‌بندی‌نشده در
ups\&.status
دارد؛ برای این اعلان،
message
می‌تواند حاوی یک جانگهدارنده دوم
%s
باشد تا مجموعه فعلی چنین نشانه‌هایی را جایگزین کند\&.
.RE
.PP
NOTOTHER
.RS 4
یوپی‌اس دیگر هیچ نشانه وضعیت طبقه‌بندی‌نشده‌ای ندارد
.RE
.PP
SUSPEND_STARTING
.RS 4
سیستم‌عامل در حال ورود به حالت خواب/تعلیق/خواب زمستانی است
.RE
.PP
SUSPEND_FINISHED
.RS 4
سیستم‌عامل به تازگی از حالت خواب/تعلیق/خواب زمستانی خارج شده است، غیرفعال‌سازی خوانش‌های منسوخ UPS برای جلوگیری از خاموشی ناخواسته
.RE
.RE
.PP
\fBNOTIFYFLAG\fR \fItype\fR \fIflag\fR[+\fIflag\fR]\&...
.RS 4
به طور پیش‌فرض، هنگام وقوع رویدادها upsmon پیام‌های عمومی (wall) را از طریق
/bin/wall
برای همه کاربران واردشده به سیستم ارسال می‌کند و در syslog می‌نویسد؛ به جز ویندوز که در آن upsmon به طور پیش‌فرض فقط در Event Log می‌نویسد\&. شما می‌توانید این رفتار را تغییر دهید\&.
.sp
مثال‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
NOTIFYFLAG ONLINE SYSLOG
NOTIFYFLAG ONBATT SYSLOG+WALL+EXEC
.fi
.if n \{\
.RE
.\}
.sp
مقادیر ممکن برای فلگ‌ها:
.PP
SYSLOG
.RS 4
نوشتن پیام در syslog
.RE
.PP
WALL
.RS 4
ارسال پیام به همه کاربران با /bin/wall
.RE
.PP
EXEC
.RS 4
اجرای NOTIFYCMD (بالا را ببینید) به همراه پیام
.RE
.PP
IGNORE
.RS 4
هیچ کاری انجام نده
.sp
اگر از IGNORE استفاده می‌کنید، هیچ فلگ دیگری را در همان خط به کار نبرید\&.
.RE
.RE
.PP
\fBPOLLFREQ\fR \fIseconds\fR
.RS 4
به طور معمول upsmon هر ۵ ثانیه یک‌بار از سرور
\fBupsd\fR(8)
نظرسنجی می‌کند\&. اگر این کار شبکه شما را با ترافیک بیش از حد مواجه می‌کند، می‌توانید این مقدار را افزایش دهید\&. همچنین در برخی موارد می‌توانید آن را کاهش دهید تا به‌روزرسانی‌های سریع‌تری دریافت کنید\&.
.sp
در این میان نکاتی وجود دارد\&. نخست، اگر POLLFREQ را بیش از حد بالا تنظیم کنید، ممکن است رویدادهای کوتاه‌مدت برق را به کلی از دست بدهید\&. همچنین اگر از عدد بسیار بزرگی استفاده کنید، خطر فعال شدن DEADTIME (بالا را ببینید) وجود دارد\&.
.sp
دوم، اگر آن را بیش از حد پایین تنظیم کنید، با کاهش بازدهی مواجه خواهید شد\&. در حالی که upsd معمولاً تمام داده‌ها را فوراً در دسترس دارد، اکثر درایورها وضعیت UPS را تنها هر ۲ ثانیه یک‌بار تازه‌سازی می‌کنند\&. نظرسنجی با فاصله‌ای کمتر از آن معمولاً اطلاعات را سریع‌تر به شما نمی‌رساند\&.
.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
این تنظیم با
pollfreq
پشتیبانی‌شده توسط برخی از برنامه‌های درایور NUT، مانند
\fBusbhid-ups\fR(8)
(در مورد اینکه درایور با چه فاصله‌ای یک دستگاه خاص را نظرسنجی می‌کند) متفاوت است\&.
.sp .5v
.RE
.RE
.PP
\fBPOLLFREQALERT\fR \fIseconds\fR
.RS 4
این فاصله‌ای است که اگر هر یک از UPSهای آن روی باتری باشند، upsmon بین نظرسنجی‌ها منتظر می‌ماند\&. می‌توانید از این گزینه همراه با POLLFREQ در بالا استفاده کنید تا نظرسنجی‌ها در رفتار عادی کندتر شوند، اما هنگامی که اتفاق ناگواری رخ می‌دهد، به‌روزرسانی‌های سریع‌تری دریافت کنید\&.
.sp
این مقدار همیشه باید برابر یا کمتر از مقدار POLLFREQ باشد\&. به طور پیش‌فرض این مقدار نیز ۵ ثانیه تنظیم شده است\&.
.sp
هشدارهای مربوط به مقادیر بیش از حد بالا و بیش از حد پایین در مدخل POLLFREQ در اینجا نیز صدق می‌کنند\&.
.RE
.PP
\fBPOWERDOWNFLAG\fR \fIfilename\fR
.RS 4
هنگامی که upsmon در حالت اولیه اجرا می‌شود و UPS نیاز به خاموش شدن دارد، این فایل را ایجاد می‌کند\&. شما باید در اسکریپت‌های خاموشی دیرهنگام خود وجود این فایل را بررسی کنید و در صورت وجود،
upsdrvctl shutdown
را فراخوانی کنید؛ توجه داشته باشید که اگر فایل‌های پیکربندی NUT در آن مرحله همچنان قابل خواندن باشند (فایل‌سیستم‌ها بیشتر پیاده شده یا به حالت فقط‌خواندنی تغییر کرده باشند)، ممکن است
upsmon \-K
برای این منظور فراخوانی شود\&.
.sp
از نظر تاریخی، این مسیر اغلب
/etc/killpower
بود، اما امروزه ممکن است بخواهید آن را در یک سیستم فایل موقت (مثلاً زیر
(/var)/run
یا حتی یک مسیر اختصاصی
(/var)/run/nut
) قرار دهید\&.
.sp
توجه داشته باشید که برای مسیرهای ویندوز باید از بک‌اسلش دوتایی استفاده شود، مثلاً
C:\e\eTemp\e\ekillpower
(ویندوزهای مدرن ممکن است اسلش‌های رو به جلو مانند
C:/Temp/killpower
را نیز بپذیرند، اما ممکن است نتیجه متفاوت باشد)\&.
.sp
این کار برای بازنشانی اجباری سیستم‌های ثانویه انجام می‌شود، تا حتی اگر برق در طول فرایند خاموشی بازگردد، آن‌ها در مرحله "halted" متوقف نمانند\&. این سازوکار معمولاً روی UPSهای بستن تماس (contact\-closure) که از درایور genericups استفاده می‌کنند، به خوبی کار نمی‌کند\&.
.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
برنامه باینری
upsmon
فاقد یک مقدار پیش‌فرض توکار است، بنابراین این تنظیم حتماً باید در پیکربندی مشخص شود تا ادغام خاموشی دیرهنگام روی آن سیستم خاص با حالت اولیه به درستی عمل کند!
.sp .5v
.RE
برای اطلاعات بیشتر، فایل config\-notes\&.txt را در زیرپوشه docs ببینید\&. به بخش زیر مراجعه کنید:

"Configuring automatic shutdowns for low battery events" یا به نسخه آنلاین مراجعه کنید\&.
.RE
.PP
\fBOFFDURATION\fR \fIseconds\fR
.RS 4
پروژه NUT از یک «خاموشی مدیریتی» (administrative OFF) برای دستگاه‌های برقی پشتیبانی می‌کند که می‌توان آن‌ها را طوری مدیریت کرد که بار کاری برنامه‌های خود را خاموش کنند، در حالی که UPS یا ePDU برای پایش و مدیریت همچنان قابل دسترسی باقی بماند\&. این سوئیچ اجازه می‌دهد تا انتشار چنین وضعیتی به یک فقدان شناخته‌شده تغذیه با تاخیر انجام شود (که احتمالاً راه‌اندازی FSD را در کلاینت‌های
upsmon
که دستگاه را
MONITOR
می‌کنند و در واقع هنوز فعال هستند در پی دارد \(em مثلاً با چندین منبع تغذیه یا به این دلیل که آن‌ها به عنوان بار واقعاً خاموش نشده‌اند)، زیرا هنگامی که برخی دستگاه‌ها کالیبراسیون باتری را آغاز می‌کنند، برای چند ثانیه وضعیت "OFF" را گزارش می‌دهند و تنها پس از تغییر وضعیت تمام رله‌های برق ممکن است "CAL" را گزارش کنند \(em در نتیجه هشدارهای مثبت کاذب برای راه‌انداز FSD در
upsmon
ایجاد می‌کنند\&.
.sp
یک مقدار منفی به معنای غیرفعال کردن کاهش شمارنده منابع تغذیه فعال در چنین مواردی است، و مقدار صفر تاثیر وضعیت شناسایی‌شده "OFF" را فوری می‌سازد\&. مقدار پیش‌فرض توکار ۳۰ (ثانیه) است، تا اگر یک وضعیت "OFF" به مدت این تعداد ثانیه تداوم یابد، اعمال شود (کاهش تعداد منابع تغذیه شناخته‌شده)\&.
.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
تاکنون ما از گزارش وضعیت "OFF" توسط دستگاه پشتیبانی می‌کنیم که معمولاً به معنای قطع کامل برق بار است؛ یک گزارش در ردیاب باگ ثبت شده تا پشتیبانی مشابهی را فقط برای برخی پریزها یا گروه‌های پریز قابل مدیریت طراحی کند\&.
.sp .5v
.RE
.RE
.PP
\fBOVERDURATION\fR \fIseconds\fR
.RS 4
این تنظیم نحوه برخورد با یک UPS دچار اضافه‌بار را در شرایطی که ارتباط کاملی ندارد مدیریت می‌کند\&. از آنجا که چنین یوپی‌اسی ممکن است در وضعیتی بالقوه وخیم باشد، برخی کاربران ممکن است بخواهند سیستم‌هایشان بلافاصله یا پس از سپری شدن یک زمان انتظار مشخص خاموش شوند\&. تنظیم OVERDURATION این زمان انتظار (به ثانیه) را مشخص می‌کند که پس از آن، یک UPS دچار اضافه‌بار که در حال ارتباط نیست، بحرانی تلقی خواهد شد\&.
.sp
یک مقدار منفی به این معناست که یک UPS دچار اضافه‌بار هرگز بحرانی تلقی نخواهد شد (حداقل نه به خاطر خود اضافه‌بار)\&. مقدار صفر به این معناست که UPS در صورت داشتن اضافه‌بار و عدم برقراری ارتباط، فوراً بحرانی تلقی می‌شود\&. مقدار پیش‌فرض توکار \-1 (ثانیه) است\&.
.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
این تنظیم تنها بر رفتار زمانی تأثیر می‌گذارد که یک UPS هم دچار اضافه‌بار باشد و هم ارتباط برقرار نکند\&. هنگامی که UPS به طور عادی در حال برقراری ارتباط است، وضعیت اضافه‌بار ممکن است اعلان‌هایی ایجاد کند اما به خودی خود باعث خاموش شدن سیستم نخواهد شد\&.
.sp .5v
.RE
.RE
.PP
\fBOBLBDURATION\fR \fIseconds\fR
.RS 4
پروژه NUT به طور معمول برای مصرف‌کنندگان یک UPS که مشخص شده روی باتری است ("OB") و به وضعیت باتری ضعیف ("LB") رسیده است، در صورتی که این آخرین منبع تغذیه باقی‌مانده آن‌ها برای برآورده کردن تنظیم
MINSUPPLIES
باشد، هشدارهای خاموشی فوری (FSD) را ایجاد می‌کند\&. در برخی موارد خاص، کاربران ممکن است بخواهند ایجاد هشدار را بنا به صلاحدید خود و با پذیرش خطر خاموشی نامناسب، (با استفاده از گزینه
OBLBDURATION
) به تأخیر بیندازند\&.
.sp
یک مقدار مثبت وضعیت "OB LB" را تنها در صورتی اعمال می‌کند که برای این تعداد ثانیه تداوم یابد\&. یک مقدار غیرمثبت، تأثیر FSD وضعیت شناسایی‌شده "OB LB" را فوری می‌سازد\&. مقدار پیش‌فرض توکار 0 (ثانیه) است\&.
.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
اگر هر دو گزینه
OBLBDURATION
و
HOSTSYNC
روی یک سیستم کلاینت
upsmon
(ثانویه) تنظیم شده باشند و
HOSTSYNC
کوتاه‌تر باشد، عملاً نادیده گرفته خواهد شد:
upsmon
حداکثر تا
OBLBDURATION
ثانیه منتظر برطرف شدن وضعیت "OB LB" می‌ماند و سپس منطق کلاینت ثانویه به خاموشی فوری منتهی می‌شود\&. اگر سیستم اولیه روی این UPS یک FSD صادر کند، به محض مشاهده، تأثیری با اولویت بالاتر خواهد داشت\&.
.sp .5v
.RE
.RE
.PP
\fBRBWARNTIME\fR \fIseconds\fR
.RS 4
هنگامی که یک UPS اعلام کند که باتری آن نیاز به تعویض دارد، upsmon یک رویداد NOTIFY_REPLBATT ایجاد می‌کند\&. به طور پیش‌فرض، این رویداد هر ۴۳۲۰۰ ثانیه (۱۲ ساعت) یک‌بار رخ می‌دهد\&.
.sp
اگر به مقدار دیگری نیاز دارید، آن را در اینجا تنظیم کنید\&.
.RE
.PP
\fBALARMCRITICAL\fR \fI0 | 1\fR
.RS 4
پروژه NUT به طور معمول UPSهای دارای هشدارهای فعال را ناپایدار تلقی می‌کند، به این معنی که با دقت بیشتری تحت نظر قرار می‌گیرند و ممکن است زودتر از سایر وضعیت‌های عادی UPS به عنوان بحرانی/مرده تلقی شوند\&. این موضوع به ویژه در شرایط عدم برقراری ارتباط صادق است، جایی که UPS در وضعیت
ALARM
از دست رفته تلقی شده و در نتیجه ممکن است خاموشی‌های سیستم آغاز شود\&.
.sp
از آنجا که استاندارد مشترکی برای اینکه چه چیزی یک هشدار را تشکیل می‌دهد وجود ندارد، چنین وضعیت‌های هشداری در واقع ممکن است ماهیتی پیش‌پاافتاده داشته باشند و رفتار فوق به دلیل احتمال منجر شدن به خاموشی‌های بی‌مورد سیستم، نامطلوب باشد\&.
.sp
هنگامی که این تنظیم غیرفعال باشد،
upsmon
یک UPS در وضعیت هشدار را ناپایدار در نظر نمی‌گیرد و باعث می‌شود با وضعیت
ALARM
همانند هر وضعیت دیگری برخورد کند\&.
.RE
.PP
\fBRUN_AS_USER\fR \fIusername\fR
.RS 4
برنامه upsmon به طور معمول به دو فرایند تقسیم می‌شود؛ بخش کوچکی را که تحت مالکیت
root
باقی می‌ماند حفظ می‌کند تا در صورت رسیدن زمان موعود، با فراخوانی
SHUTDOWNCMD
خاموشی سیستم را آغاز کند، و بخش عمده وظایف پایش را پس از رها کردن امتیازات ریشه، تحت شناسه کاربری دیگری اجرا می‌کند\&. در اکثر سیستم‌های سفارشی‌ساخت، این بدان معناست که به عنوان "nobody" اجرا می‌شود، زیرا این مقدار پیش‌فرض زمان کامپایل است؛ بسته‌ها اغلب یک کاربر "nut" یا "ups" را برای اجرای دیمن‌های سرویس NUT فراهم می‌کنند\&.
.sp
نکته اینجاست که کاربر پیش‌فرض سیستم "nobody" نمی‌تواند فایل upsmon\&.conf شما را بخواند، زیرا به طور پیش‌فرض طوری نصب شده که فقط
root
می‌تواند آن را باز کند (زیرا این فایل می‌تواند حاوی اطلاعات حساسی مانند اعتبارنامه‌های سرور داده راه دور NUT باشد)\&. این بدان معناست که شما قادر به بارگذاری مجدد فایل پیکربندی نخواهید بود، زیرا برای بخش بدون امتیاز دیمن
upsmon
غیرقابل دسترسی خواهد بود\&.
.sp
راهکار این است که یک کاربر جدید فقط برای upsmon ایجاد کنید، سپس آن را طوری تنظیم کنید که به عنوان آن کاربر اجرا شود\&. این حساب کاربری می‌تواند همان حسابی باشد که برای درایورهای NUT یا سرور داده استفاده می‌شود، اما الزامی به آن نیست\&. در سیستم‌هایی با ملاحظات امنیتی بالاتر و تفکیک امتیازات، ما "nutmon" را پیشنهاد می‌کنیم، اما شما می‌توانید از هر نامی که قبلاً در سیستم شما گرفته نشده است استفاده کنید\&. فقط یک کاربر معمولی بدون امتیازات ویژه و با یک گذرواژه غیرقابل حدس ایجاد کنید\&.
.sp
سپس، به upsmon بگویید که به عنوان آن کاربر اجرا شود، و فایل
upsmon\&.conf
را برای آن قابل خواندن کنید\&. بارگذاری‌های مجدد شما کار خواهند کرد و فایل پیکربندی شما امن باقی خواهد ماند\&.
.sp
این فایل نباید توسط کاربر upsmon قابل نوشتن باشد، زیرا ممکن است از یک روزنه سوءاستفاده شده،
SHUTDOWNCMD
به چیزی مخرب تغییر داده شود و سپس منتظر راه‌اندازی مجدد upsmon بمانند\&. بنابراین معمولاً شما یک گروه نیز برای دیمن‌های NUT ایجاد می‌کنید (که کاربر عضو آن باشد) و به آن گروه دسترسی فقط‌خواندنی به فایل‌های پیکربندی متعلق به
root
را اعطا می‌کنید\&.
.sp
با این اوصاف، حالت‌های دیگری نیز ممکن است امکان‌پذیر باشد \(em برای مثال اجرای کل
upsmon
به عنوان یک فرایند منفرد که در ابتدا توسط
nut
شروع شده و تحت مالکیت آن است، و فراخوانی یک اسکریپت خاموشی با پیشوند
sudo،
pfexec
یا سایر ابزارهای RBAC\&. با این حال، این کار باعث افزودن «بخش‌های متحرک» بیشتر و شکنندگی می‌شود (به عنوان مثال، تنظیمات
sudoers
ممکن است در LDAP قرار داشته باشد، و آن سرور در زمان خاموشی هنگامی که نیمی از رک خاموش شده است، دقیقاً در همان زمانی که در اینجا به آن نیاز دارید، در دسترس نباشد)، و روی همه پلتفرم‌ها نیز در دسترس نیست \(em بنابراین چنین تنظیماتی مواردی هستند که کاربران تاکنون به تنهایی بررسی کرده‌اند (هرچند از ارسال پست‌ها در ویکی NUT یا پیوند به وبلاگ‌ها استقبال می‌کنیم)\&.
.RE
.PP
\fBSHUTDOWNCMD\fR \fIcommand\fR
.RS 4
هنگامی که سیستم نیاز به خاموش شدن دارد، upsmon این دستور را اجرا می‌کند\&. اگر یک سیستم ثانویه باشد، هر زمان که مقدار توان کلی فعلی به زیر مقدار MINSUPPLIES بالا افت کند، بلافاصله این کار را انجام می‌دهد\&.
.sp
هنگامی که upsmon یک سیستم اولیه است، پیش از شروع فرایند خاموشی محلی، به سیستم‌های ثانویه اجازه می‌دهد اتصال خود را قطع کنند\&.
.sp
توجه داشته باشید که این دستور باید یک مؤلفه منفرد در فایل پیکربندی باشد\&. اگر دستور خاموشی شما حاوی فاصله است، آن را در علامت نقل‌قول قرار دهید تا یکپارچه بماند، یعنی:
.sp
.if n \{\
.RS 4
.\}
.nf
SHUTDOWNCMD "/sbin/shutdown \-h +0"
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fBSHUTDOWNEXIT\fR \fIboolean|number\fR
.RS 4
پس از آغاز خاموشی، آیا خود این دیمن upsmon باید خارج شود؟ با انجام این کار، سیستم‌های ثانویه NUT می‌توانند به سیستم اولیه NUT اطلاع دهند که می‌تواند خاموشی خود را ادامه دهد و در نهایت به UPS دستور دهد برق بار را قطع کند\&. (به طور پیش‌فرض "Yes")
.sp
برخی سیستم‌های «ثانویه» با بارهای کاری که توقف آن‌ها زمان قابل توجهی می‌برد (مانند ماشین‌های مجازی یا پایگاه‌های داده بزرگ) می‌توانند از این موضوع بهره‌مند شوند که اعلام آمادگی خود را برای شروع خاموشی سیستم «اولیه» و در نهایت قطع برق توسط UPS (از طریق قطع اتصال از سرور داده) \(em نه به محض آغاز خاموشی خود، بلکه در نقطه‌ای دیرتر گزارش دهند (مثلاً هنگامی که سرویس upsmon پس از بارهای کاری سنگین‌تر متوقف می‌شود)\&.
.sp
توجه داشته باشید که توانایی واقعی برای تکمیل چنین خاموشی به مدت‌زمان کارکرد باقی‌مانده باتری در لحظه‌ای بستگی دارد که وضعیت برق UPS بحرانی تلقی شده و خاموشی‌ها آغاز می‌شوند\&. همچنین ممکن است مجبور شوید
HOSTSYNC
را در سیستم اولیه NUT به اندازه کافی طولانی تنظیم کنید تا آن سیستم‌های ثانویه بتوانند سرویس‌های خود را متوقف کنند\&. در عمل، ممکن است ارزش داشته باشد که راه‌هایی برای آغاز زودهنگام‌تر خاموشی در این سیستم‌ها بررسی شود، به عنوان مثال با راه‌اندازی یکپارچه‌سازی با
upssched
یا درایور
dummy\-ups
همراه با بازنویسی‌هایی برای محرک‌های سخت‌گیرانه‌تر
battery\&.charge
یا
battery\&.runtime
نسبت به آنچه توسط سایر سرورهای شما استفاده می‌شود\&.
.sp
این گزینه از رشته‌های به سبک دودویی (yes/on/true یا no/off/false) یا اعداد برای تعیین یک تاخیر (به ثانیه) بین فراخوانی
SHUTDOWNCMD
و خروج از دیمن پشتیبانی می‌کند\&. صفر به معنای خروج فوری است (پیش‌فرض)، مقادیر منفی به معنای هرگز خارج نشدن به اراده خود است\&.
.RE
.PP
\fBCERTPATH\fR \fIcertificate file or database\fR
.RS 4
هنگامی که برنامه با پشتیبانی از SSL کامپایل شده باشد، می‌توانید مسیر گواهی را در اینجا وارد کنید\&.
.PP
با NSS:
.RS 4
گواهی‌ها در یک پایگاه‌داده اختصاصی ذخیره می‌شوند (داده‌ها به ۳ فایل تقسیم شده‌اند)\&. مسیر پوشه پایگاه‌داده را مشخص کنید\&.
.RE
.PP
با OpenSSL:
.RS 4
پوشه حاوی گواهی‌های CA در قالب PEM که برای اعتبارسنجی گواهی سرور ارائه‌شده توسط سرور upsd استفاده می‌شود\&. این فایل‌ها هر کدام حاوی یک گواهی CA هستند\&. فایل‌ها با مقدار درهم‌سازی نام موضوع (subject name hash) مرجع صدور گواهی جستجو می‌شوند، بنابراین این مقدار باید در دسترس باشد\&.
.RE
.RE
.PP
\fBCERTIDENT\fR \fIcertificate name\fR \fIdatabase password\fR
.RS 4
هنگامی که برنامه با پشتیبانی از SSL به همراه NSS کامپایل شده باشد، می‌توانید نام گواهی را برای بازیابی از پایگاه‌داده جهت احراز هویت خود و گذرواژه لازم برای دسترسی به کلید خصوصی مربوط به گواهی را مشخص کنید\&.
.sp
در حال حاضر در صورت ساخت با OpenSSL این گزینه بدون عمل (no\-op) است\&.
.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 .5v
.RE
.RE
.PP
\fBCERTHOST\fR \fIhostname\fR \fIcertificate name\fR \fIcertverify\fR \fIforcessl\fR
.RS 4
هنگامی که برنامه با پشتیبانی از SSL به همراه NSS کامپایل شده باشد، می‌توانید دستورالعمل امنیتی را برای هر سروری که می‌توانید با آن تماس بگیرید مشخص کنید\&.
.sp
هر مدخل نام سرور را با نام گواهی مورد انتظار و فلگ‌هایی که نشان می‌دهند آیا گواهی سرور اعتبارسنجی می‌شود و آیا اتصال باید امن باشد، نگاشت می‌کند\&.
.sp
در حال حاضر در صورت ساخت با OpenSSL این گزینه بدون عمل (no\-op) است\&.
.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 .5v
.RE
.RE
.PP
\fBCERTVERIFY\fR \fI0 | 1\fR
.RS 4
هنگامی که برنامه با پشتیبانی از SSL کامپایل شده باشد، upsmon را وادار به اعتبارسنجی تمام اتصالات با گواهی‌ها می‌کند\&.
.sp
بدون این گزینه، هیچ تضمینی وجود ندارد که upsd میزبان درستی باشد\&. فعال کردن این گزینه خطر حملات مرد میانی (man\-in\-the\-middle) را به شدت کاهش می‌دهد\&. این گزینه عملاً استفاده از SSL را اجباری می‌کند، بنابراین تا زمانی که تمام میزبان‌های upsd شما برای SSL آماده نشده‌اند و گواهی‌هایشان مرتب نیست، از این گزینه استفاده نکنید\&.
.sp
هنگامی که برنامه با پشتیبانی NSS از SSL کامپایل شده باشد، این مقدار می‌تواند برای میزبانی که با دستورالعمل CERTHOST مشخص شده بازنویسی شود\&.
.RE
.PP
\fBFORCESSL\fR \fI0 | 1\fR
.RS 4
هنگامی که برنامه با SSL کامپایل شده باشد، مشخص می‌کند که برای برقراری ارتباط با upsd باید از یک اتصال امن استفاده شود\&.
.sp
اگر از
\fICERTVERIFY 1\fR
استفاده نکنید، این گزینه دست‌کم اطمینان حاصل می‌کند که هیچ‌کس نمی‌تواند بدون زحمت زیاد نشست‌های شما را شنود کند\&. تنظیم این گزینه باعث می‌شود اگر upsd راه دور از SSL پشتیبانی نکند، upsmon اتصالات را قطع کند، بنابراین تا زمانی که همه آن‌ها SSL را اجرا نمی‌کنند از آن استفاده نکنید\&.
.sp
هنگامی که برنامه با پشتیبانی NSS از SSL کامپایل شده باشد، این مقدار می‌تواند برای میزبانی که با دستورالعمل CERTHOST مشخص شده بازنویسی شود\&.
.RE
.PP
\fBDEBUG_MIN\fR \fIINTEGER\fR
.RS 4
به صورت اختیاری یک حداقل سطح اشکال‌زدایی را برای دیمن
upsmon
مشخص کنید، مثلاً برای عیب‌یابی یک استقرار، بدون اینکه مستقیماً بر حالت اجرای پیش‌زمینه یا پس‌زمینه تأثیر بگذارد\&. گزینه خط فرمان
\-D
فقط می‌تواند این سطح پرگویی (verbosity) را افزایش دهد\&.
.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
اگر دیمن در حال اجرا دستور
reload
را دریافت کند، وجود مقدار
DEBUG_MIN NUMBER
در فایل پیکربندی می‌تواند برای تنظیم پرگویی اشکال‌زدایی در دیمن سرویس در حال اجرا استفاده شود (توصیه می‌شود پس از اتمام کار، آن را کامنت کنید یا حداقل مقدار را روی صفر صریح قرار دهید تا از ژورنال‌های حجیم و سوءاستفاده از سیستم ورودی/خروجی جلوگیری شود)\&. به یاد داشته باشید که برای این تنظیم زمان اجرا، مقدار
DEBUG_MIN
\fBموجود\fR
در فایل‌های پیکربندی
\fBبارگذاری‌مجددشده\fR
فوراً اعمال می‌شود و هر مقدار قبلی تعیین‌شده را، از طریق فایل یا گزینه‌های CLI، صرف نظر از اینکه سطح قبلی ثبت وقایع بالاتر یا پایین‌تر از عدد تازه یافت‌شده باشد بازنویسی می‌کند؛ با این حال، یک مقدار مفقود (یا کامنت‌شده) میزان پرگویی ثبت وقایع قبلی فعال را تغییر نمی‌دهد\&.
.sp .5v
.RE
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBupsmon\fR(8), \fBupsd\fR(8), \fBnutupsdrv\fR(8)\&.
.SS "منابع اینترنتی (Internet resources):"
.sp
صفحه اصلی ابزارهای NUT (Network UPS Tools): https://www\&.networkupstools\&.org/historic/v2\&.8\&.5