نام (NAME)

upsd - کارساز داده‌های Network UPS Tools

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

upsd -h

upsd [گزینه‌ها]

توضیحات (DESCRIPTION)

برنامه upsd مسئول ارائه داده‌ها از درایورها به کلاینت‌ها است. این برنامه به هر درایور متصل می‌شود و یک حافظه موقت (کش) محلی از وضعیت فعلی نگهداری می‌کند. پرس‌وجوهای کلاینت‌ها از این کش پاسخ داده می‌شوند، بنابراین تأخیرها به حداقل می‌رسد.

همچنین پیام‌های مدیریتی را از کلاینت‌ها به درایورها منتقل می‌کند، مانند شروع آزمایش‌ها یا تنظیم مقادیر.

ارتباط بین upsd و کلاینت‌ها روی یک پورت TCP انجام می‌شود. جزئیات پیکربندی این پورت در upsd.conf(5) توضیح داده شده است.

این برنامه ضروری است و برای استفاده عملی از درایورها و کلاینت‌ها باید همیشه در حال اجرا باشد (به‌جز دستورات نهایی خاموش کردن برق یوپی‌اس درست پیش از خاموش شدن سرور، که برنامه‌های درایور NUT می‌توانند هنگام فراخوانی با drivername -k در یک هوک خاموش‌سازی یا اسکریپت دیرهنگام SysV init، به تنهایی انجام دهند).

کنترل‌های موجود در فایل‌های پیکربندی به شما امکان می‌دهند دسترسی به سرور را محدود کنید، اما برای حفاظت بیشتر باید از یک فایروال نیز استفاده نمایید. فرایندهای کلاینت مانند upsmon(8) برای اطلاعات وضعیت سخت‌افزار یوپی‌اس به upsd اعتماد می‌کنند، بنابراین امنیت آن را حفظ کنید.

گزینه‌ها (OPTIONS)

-c دستور

ارسال دستور به فرایند پس‌زمینه به عنوان یک سیگنال. دستورات معتبر عبارتند از:

reload

خواندن مجدد فایل‌های پیکربندی

stop

توقف فرایند و خروج

-P pid

ارسال سیگنال دستور فوق با استفاده از شماره PID مشخص‌شده، به‌جای مراجعه به فایل PID. این کار می‌تواند در تعریف واحدهای سرویسی که upsd را به عنوان یک فرایند پیش‌زمینه اجرا می‌کنند تا فایل PID ایجاد نکند، مفید باشد. همچنین گزینه -FF را به عنوان یک جایگزین ببینید.

-D

افزایش سطح اشکال‌زدایی. در حالت پیش‌فرض upsd در پیش‌زمینه اجرا خواهد شد و اطلاعاتی درباره فرایند نظارت در stdout چاپ می‌کند. برای دریافت جزئیات بیشتر، از این گزینه چندین بار استفاده کنید.

-F

اجرای upsd در پیش‌زمینه، صرف‌نظر از تنظیمات اشکال‌زدایی. این گزینه را دو بار (-FF یا -F -F) مشخص کنید تا فایل PID حتی در این حالت نیز ذخیره شود.

-B

اجرای upsd در پس‌زمینه، صرف‌نظر از تنظیمات اشکال‌زدایی.

-h

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

-r پوشه

با تنظیم این گزینه، upsd اندکی پس از راه‌اندازی و پیش از تجزیه هرگونه فایل پیکربندی، به پوشه مشخص‌شده chroot(2) می‌کند. می‌توانید از این قابلیت برای ایجاد یک «زندان» (jail) جهت امنیت بیشتر استفاده کنید.

باید این مورد را با درایورهای خود هماهنگ کنید، زیرا upsd باید بتواند مسیر وضعیت (state path) را درون پوشه پیدا کند. به upsdrvctl(8) و nutupsdrv(8) مراجعه کنید.

-u کاربر

تغییر کاربر به کاربر پس از راه‌اندازی در صورتی که به عنوان ریشه (root) اجرا شده باشد. این گزینه بر هر مقداری که هنگام کامپایل با configure --with-user تنظیم شده باشد اولویت دارد.

-V

نمایش نسخه برنامه.

بارگذاری مجدد (RELOADING)

برنامه upsd می‌تواند بدون خاموش کردن فرایند، فایل‌های پیکربندی خود را مجدداً بارگذاری کند در صورتی که سیگنال SIGHUP به آن ارسال کنید یا آن را دوباره با -c reload اجرا نمایید. این قابلیت تنها زمانی کار می‌کند که فرایند پس‌زمینه قادر به خواندن آن فایل‌ها باشد (مجوزها، زندان chroot)، و دیمون هنگام راه‌اندازی فایل PID را ذخیره کرده باشد (تا دستور بارگذاری مجدد بتواند نمونه قبلی را پیدا کند).

نکته

نمونه‌های سرویسی که توسط systemd یا SMF مدیریت می‌شوند ممکن است به‌طور پیش‌فرض آن‌ها را ذخیره نکنند — در این صورت به‌جای آن از کنش‌های reload/refresh چارچوب مربوطه استفاده کنید، مانند: systemctl reload nut-server

نسخه‌های NUT پس از 2.8.0 نام‌های مستعاری (aliases) برای این واحدها تعریف می‌کنند، بنابراین اگر توزیع لینوکس شما از تعاریف ارائه‌شده توسط NUT استفاده می‌کند، دستور systemctl reload upsd نیز ممکن است کار کند.

اگر فکر می‌کنید upsd نمی‌تواند پیکربندی را مجدداً بارگذاری کند، گزارش‌های syslog را برای پیام‌های خطا بررسی کنید. اگر پیام حاکی از عدم امکان خواندن فایل‌ها است، باید سیستم خود را طوری تنظیم کنید که خواندن آن‌ها امکان‌پذیر شود. یا مجوزهای فایل‌ها را تغییر دهید، یا upsd را با کاربر دیگری اجرا کنید که قادر به خواندن آن‌ها باشد، یا آن را کاملاً راه‌اندازی مجدد (restart) کنید (مثلاً در صورت اجرا در یک زندان chroot ممکن است لازم باشد).

فایل‌های upsd.conf(5) یا upsd.users(5) خود را برای همگان قابل‌خواندن (world-readable) نکنید، زیرا حاوی اطلاعات مهم احراز هویت هستند. در دست افراد ناشایست، این اطلاعات می‌تواند برای جعل upsmon در حالت اصلی (primary-mode) و مثلاً ارسال دستور خاموش شدن به سیستم‌های شما استفاده شود.

عیب‌یابی (DIAGNOSTICS)

برنامه upsd انتظار دارد که درایورها یا وضعیت خود را به‌طور منظم به‌روز کنند یا دست‌کم به پرس‌وجوهای دوره‌ای، موسوم به پینگ (ping)، پاسخ دهند. اگر درایوری پاسخ ندهد، upsd آن را «کهنه» (stale) اعلام می‌کند و اطلاعات بیشتری به کلاینت‌ها ارائه نخواهد شد.

اگر upsd هنگام راه‌اندازی از کهنگی داده‌ها شکایت کرد، احتمالاً درایور یا فایل‌های پیکربندی شما دچار مشکل هستند. اطمینان حاصل کنید که درایور واقعاً در حال اجرا است و تعریف یوپی‌اس در ups.conf(5) درست است. همچنین مطمئن شوید که پیش از شروع upsd، درایور(های) خود را راه‌اندازی کرده‌اید.

داده‌ها همچنین در صورتی که درایور دیگر نتواند با یوپی‌اس ارتباط برقرار کند، ممکن است کهنه (stale) علامت‌گذاری شوند. در این حالت، درایور باید اطلاعات تشخیصی را در syslog نیز ارائه دهد. اگر این اتفاق افتاد، کابل‌کشی سریال یا USB را بررسی کنید، یا در مورد یوپی‌اس‌های SNMP، مسیر شبکه را بازرسی نمایید.

کنترل دسترسی (ACCESS CONTROL)

اگر سرور با پشتیبانی فعال از tcp-wrappers ساخته شده باشد، بررسی خواهد کرد که آیا نام کاربری NUT مجاز به اتصال از آدرس کلاینت از طریق فایل‌های /etc/hosts.allow و /etc/hosts.deny است یا خیر. توجه داشته باشید که این بررسی تنها برای دستوراتی انجام می‌شود که نیازمند ورود به سرور هستند. جزئیات بیشتر در hosts_access(5) توضیح داده شده است.

فایل‌ها (FILES)

فایل پیکربندی عمومی upsd پرونده upsd.conf(5) است.

توابع مدیریتی مانند SET و INSTCMD برای کاربران، و نقش‌های مختلف upsmon در upsd.users(5) تعریف و کنترل می‌شوند.

تعاریف یوپی‌اس در ups.conf(5) یافت می‌شوند (که با درایورهای واقعی به اشتراک گذاشته شده است).

متغیرهای محیطی (ENVIRONMENT VARIABLES)

متغیر NUT_DEBUG_LEVEL سطح پیش‌فرض پرگویی اشکال‌زدایی را در صورتی که هیچ آرگومان -D در خط فرمان داده نشده باشد تنظیم می‌کند، اما اجرای دیمون در حالت پیش‌زمینه را درخواست نمی‌کند.

متغیر NUT_CONFPATH نام مسیر پوشه‌ای است که شامل upsd.conf و سایر فایل‌های پیکربندی است. اگر این متغیر تنظیم نشده باشد، upsd از یک پیش‌فرض توکار استفاده می‌کند که اغلب /usr/local/ups/etc است.

متغیر NUT_STATEPATH نام مسیر پوشه‌ای است که upsd اطلاعات وضعیت را در آن نگهداری می‌کند. اگر این متغیر تنظیم نشده باشد، upsd از یک پیش‌فرض توکار استفاده می‌کند که اغلب /var/state/ups است. دستورالعمل STATEPATH در upsd.conf(5) بر این متغیر اولویت دارد.

متغیر NUT_ALTPIDPATH نام مسیر پوشه‌ای است که upsd و درایورها فایل‌های .pid را در آن ذخیره می‌کنند. اگر این متغیر تنظیم نشده باشد، upsd و درایورها در صورت تنظیم بودن از NUT_STATEPATH، یا در صورت تنظیم بودن از ALTPIDPATH، و در غیر این صورت از پیش‌فرض توکار STATEPATH استفاده می‌کنند.

مقدار NUT_QUIET_INIT_UPSNOTIFY=true می‌تواند برای جلوگیری از ارسال اعلان‌هایی استفاده شود که دیمون‌های قادر به آگاه‌سازی چارچوب‌های مدیریت سرویس (مانند systemd) درباره گذر از نقاط عطف چرخه حیات خود ارسال می‌کنند (شامل اعلان‌های مربوط به عدم پشتیبانی سیستم از چنین ویژگی‌های مدرنی، یک بار در هر اجرا).

مقدار NUT_QUIET_INIT_BANNER=true می‌تواند برای پنهان کردن بنر نام و نسخه ابزار NUT استفاده شود. به دلیل تأثیر منفی بر عیب‌یابی برای سرویس‌ها توصیه نمی‌شود، اما ممکن است در پروفایل‌های شل یا اسکریپت‌هایی که خروجی ابزارهای NUT را پردازش می‌کنند مفید باشد.