نام (NAME)

nut-driver-enumerator - ابزاری برای نگاشت مدخل‌های دستگاه NUT به نمونه‌های سرویس

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

nut-driver-enumerator.sh -h

nut-driver-enumerator.sh (بدون آرگومان)

nut-driver-enumerator.sh [--COMMAND]

توضیحات (DESCRIPTION)

اسکریپت nut-driver-enumerator.sh (که با نام «NDE» نیز شناخته می‌شود) راه‌اندازی و پرس‌وجوی نگاشت میان بخش‌های پیکربندی درایور NUT برای هر دستگاه تحت‌نظر و نمونه‌های سرویس در چارچوب مدیریت سرویس سیستم‌عامل را پیاده‌سازی می‌کند (در پلتفرم‌هایی که NUT از قبل از این یکپارچه‌سازی پشتیبانی می‌کند — در حال حاضر این پلتفرم‌ها شامل توزیع‌های لینوکس با systemd و سیستم‌های مشتق‌شده از پایه‌کد Solaris 10، از جمله Sun/Oracle Solaris تجاری و توزیع‌های متعدد متن‌باز illumos با SMF است)، که چنین درایورهایی برای اجرا و مدیریت مستقل درون آن‌ها کپسوله‌سازی می‌شوند. این اسکریپت ممکن است در بسته‌بندی سایر سیستم‌عامل‌ها نصب نشده باشد.

با نمایش هر درایور NUT به‌صورت یک نمونه سرویس جداگانه، می‌توان وابستگی‌ها را تعریف کرد (برای نمونه، درایورهای شبکه باید پس از فعال شدن قابلیت شبکه در سیستم‌عامل شروع به کار کنند، اما درایورهای USB/Serial نباید منتظر آن بمانند)، و همچنین این درایورها می‌توانند به‌طور مستقل با خطا مواجه شده یا به وضعیت نگهداری برده شوند (برخلاف یک سرویس یکپارچه مبتنی بر upsdrvctl(8) که نیازمند اجرای تمام موارد پیکربندی‌شده است). برای چند درایور خاص مانند dummy-ups(8)، clone(8)، clone-outlet(8) و failover(8)، این موضوع حتی ممکن است شامل وابستگی متقابل میان نمونه‌های سرویس درایورهای گوناگون NUT به یکدیگر باشد.

این اسکریپت یک رابط یکپارچه برای ابزارهای بعدی NUT مانند upsdrvsvcctl(8) فراهم می‌کند تا منطق خود را تا حد ممکن و کاربردی، به‌صورت مستقل از پلتفرم پیاده‌سازی کنند. این اسکریپت در حال حاضر برای استفاده مستقیم کاربر نهایی در نظر گرفته نشده است (و به همین دلیل در پوشه libexec قرار دارد)، و در عوض upsdrvsvcctl داده‌ها و عملکردهای پرکاربرد را با آرگومان‌های list و resync خود ارائه می‌دهد.

بخشی از پیچیدگی پلتفرم که nut-driver-enumerator.sh آن را پنهان می‌سازد، تفاوت در قوانین نام‌های معتبر نمونه‌های سرویس در چارچوب‌های مختلف، و نیز ابزارهای سیستمی و الگوهای نام‌گذاری مرتبط است.

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

دستورها (COMMANDS)

nut-driver-enumerator.sh (بدون آرگومان)

nut-driver-enumerator.sh --daemon(=freq)

nut-driver-enumerator.sh --daemon-after(=freq)

nut-driver-enumerator.sh --reconfigure

nut-driver-enumerator.sh --get-service-framework

nut-driver-enumerator.sh --list-devices

nut-driver-enumerator.sh --list-services

nut-driver-enumerator.sh --list-instances

nut-driver-enumerator.sh --get-service-for-device DEV

nut-driver-enumerator.sh --get-device-for-service SVC

nut-driver-enumerator.sh --list-services-for-devices

nut-driver-enumerator.sh --show-all-configs

nut-driver-enumerator.sh --show-device-config DEV

nut-driver-enumerator.sh --show-device-config-value DEV KEY

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

به‌طور پیش‌فرض، اجرای nut-driver-enumerator.sh بدون آرگومان، به‌طور خودکار هر نمونه سرویس تازه‌ثبت‌شده‌ای را که دستگاه‌های NUT را در بر می‌گیرد راه‌اندازی می‌کند و در صورت تغییر پیکربندی، سرویس nut-server را نیز راه‌اندازی مجدد می‌نماید. متغیر محیطی AUTO_START=no این بخش از رفتار پیش‌فرض را غیرفعال می‌کند.

همچنین برای متغیر محیطی REPORT_RESTART_42=no به بخش زیر مراجعه کنید.

عیب‌یابی (DIAGNOSTICS)

در صورتی که اسکریپت nut-driver-enumerator.sh کاری برای انجام نداشته باشد (تمامی درایورهای تعریف‌شده فعلی دقیقاً و یک‌به‌یک با نمونه‌های سرویس تعریف‌شده مطابقت داشته باشند) و در عملیات آن خطایی رخ نداده باشد، کد خروج صفر را برمی‌گرداند.

کدهای دیگر ممکن است در نتیجه همگام‌سازی مجدد نگاشت‌ها بازگردانده شوند:

42

13

1

2

نویسنده (AUTHOR)

Jim Klimov <jimklimov+nut@gmail.com>

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

upsdrvsvcctl(8), ups.conf(5)