نام (NAME)

clone-outlet - شبیه‌سازی یک یوپی‌اس و مدیریت پریز آن به‌صورت یک یوپی‌اس مستقل (فقط پایش)

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

clone-outlet -h

clone-outlet -a UPS_NAME [گزینه‌ها]

توضیحات (DESCRIPTION)

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

برخلاف درایور clone(8) یا درایور dummy-ups(8) که در حالت تکرارکننده (repeater) اجرا می‌شوند، این درایور نمایانگر یک دستگاه فقط‌خواندنی برای پایش و خاموش‌سازی است (این درایور تنظیم هیچ مقداری یا ارسال دستورات آنی را در حین اجرا نمی‌پذیرد).

برخلاف dummy-ups(8) به‌طور کلی، این درایور نیازی به اجرای سرور داده upsd ندارد و از پروتکل شبکه‌ای NUT برای ارتباط با درایور «واقعی» (که در حالت تکرارکننده dummy-ups ممکن است از راه دور باشد) استفاده نمی‌کند.

این درایور یک دستگاه مجازی کاملاً جدید ایجاد نمی‌کند، بلکه برخی از مقادیر اصلی گزارش‌شده توسط درایور «واقعی» را با استفاده از اطلاعات پریز مشخص‌شده جایگزین کرده یا گسترش می‌دهد و سایر مقادیر را همان‌طور که بودند بازپخش می‌کند.

کلاینت‌های راه دور مانند upsmon می‌توانند مدخل دستگاه ارائه‌شده توسط سرور داده را در حالی که این درایور (و درایور «واقعی») در حال اجرا و منتشرشده هستند، با MONITOR پایش کنند.

یک پیاده‌سازی بزرگ‌تر با یک یا چند دستگاه با اولویت پایین‌تر متصل به یک پریز قابل مدیریت از یوپی‌اس یا ePDU احتمالاً شامل راه‌اندازی چندین درایور بر روی سیستمی خواهد بود که عملاً قادر به تعامل با یوپی‌اس و اجرای سرور داده NUT یعنی upsd(8) است (و احتمالاً از پریز دیگری تغذیه می‌شود):

با این رویکرد، سیستم‌های با اولویت پایین‌تر متصل به چنین پریزی، کلاینت NUT یعنی upsmon(8) را اجرا می‌کنند تا یوپی‌اس مجازی ارائه‌شده توسط درایور فقط‌خواندنی clone-outlet را پایش (MONITOR) کرده و به محض بالا رفتن پرچم "FSD" (که بر اساس آستانه‌های شارژ و/یا زمان کارکرد پیکربندی‌شده برای آن درایور، نسبتاً زود رخ می‌دهد) خاموش شوند؛ این کار به دستگاه‌های با اولویت بالاتر (که احتمالاً شامل خود سرور NUT نیز می‌شود) امکان می‌دهد مدت‌زمان بیشتری از باتری استفاده کنند.

درایور clone که مسئول تغییرات وضعیت برق پریز است، معمولاً به‌طور مستقیم پایش نمی‌شود (برای مثال جهت جلوگیری از درخواست‌های خاموش‌سازی ناخواسته و مستقیم از سوی آن کلاینت‌ها)، هرچند در شبکه‌هایی با ضریب اطمینان کافی، می‌توان آن را (به‌جای clone-outlet) مستقیماً پایش کرد.

آرگومان‌های اضافی (EXTRA ARGUMENTS)

این درایور از تنظیمات زیر پشتیبانی می‌کند:

port=drivername-devicename

prefix=outlet.N

پیاده‌سازی (IMPLEMENTATION)

مشخصه پورت در ups.conf(5) باید به سوکت درایور محلی (یا پایپ نام‌گذاری‌شده ویندوز) که درایور یوپی‌اس «واقعی» از آن استفاده می‌کند ارجاع دهد. برای مثال:

[realups]
   driver = usbhid-ups
   port = auto
[clone-outlet-1]
   driver = clone-outlet
   port = usbhid-ups-realups
   prefix = outlet.1
   desc = "Outlet 1 of the Real UPS"
   [...]

این درایور در لایه داخلی خود، اطلاعات درایور «واقعی» درباره تاخیر خاموش‌سازی و تایمر خاموش‌سازی، وضعیت کل یوپی‌اس و وضعیت این پریز را تفسیر کرده و سایر نقاط داده را همان‌طور که بودند بازپخش می‌کند.

اگر پریز از قطع با تاخیر برق پشتیبانی و آن را گزارش کند، یوپی‌اس مجازی از طریق ups.status یک وضعیت FSD (خاموش‌سازی اجباری) صادر می‌کند تا کلاینت‌های آن با ایمنی خاموش شوند.

با جزئیات بیشتر:

با در نظر گرفتن مقدار پیشوند (اجباری) مانند outlet.1، درایور به‌طور مشخص نقاط داده <prefix>.status، <prefix>.delay.shutdown و <prefix>.timer.shutdown گزارش‌شده توسط درایور «واقعی» را دنبال می‌کند. مقادیر عددی خوانش‌های *.shutdown توسط این درایور ثبت شده و وضعیت بولی پریز ("off" یا غیر آن) به خاطر سپرده می‌شود. این مقادیر همچنین توسط این درایور «به همان صورت» مجدداً منتشر خواهند شد.

مقدار ups.status از درایور «واقعی» به خاطر سپرده می‌شود، اما بلافاصله توسط این درایور بازنشر نمی‌شود. در عوض، در طول چرخه‌های منظم حلقه «به‌روزرسانی اطلاعات» به یکی از اشکال زیر منتشر می‌شود:

مهم (IMPORTANT)

برخلاف یک یوپی‌اس واقعی، شما نباید حالت اصلی (primary) در upsmon را برای این درایور پیکربندی کنید. هنگامی که یک نسخه اصلی upsmon(8) پرچم‌های OB LB را می‌بیند و به سرور upsd(8) اعلام می‌کند که آغاز توالی خاموش‌سازی مجاز است، سرور وضعیت FSD را قفل (latch) می‌کند و بدون راه‌اندازی مجدد سرور upsd، امکان راه‌اندازی مجدد سیستم‌های متصل وجود نخواهد داشت.

این موضوع زمانی مشکل‌ساز خواهد شد که برق پس از آغاز توالی خاموش‌سازی توسط یوپی‌اس کلون روی پریز آن برگردد، اما قبل از اینکه یوپی‌اس واقعی خاموش شدن را آغاز کند بازگردد. راه‌حل در درایور clone نهفته است که در صورت نیاز، بدون کمک نسخه اصلی upsmon، پرچم FSD را درج می‌کند.

هشدارها (CAVEATS)

یوپی‌اس کلون از وضعیت درایور یوپی‌اس واقعی پیروی خواهد کرد. شما فقط می‌توانید کاری کنید که یوپی‌اس کلون زودتر از درایور یوپی‌اس واقعی خاموش شود، نه دیرتر. اگر درایور یوپی‌اس واقعی فرآیند خاموش‌سازی را آغاز کند، درایور یوپی‌اس clone-outlet بلافاصله از آن تبعیت خواهد کرد.

توجه داشته باشید که دستورات خاموش‌سازی/راه‌اندازی مجدد یک پریز در درایورهای یوپی‌اس واقعی تحت تأثیر قرار نمی‌گیرند؛ بنابراین اگر به درایور یوپی‌اس واقعی دستور دهید پریز مربوط به درایور یوپی‌اس کلون را فوراً خاموش کند، کلاینت‌های شما بدون هشدار برق خود را از دست خواهند داد. قطع برق با تاخیر برای پریز باید به‌صورت FSD منتشر شود و این تاخیر باید به اندازه کافی طولانی باشد تا فرصت خاموش شدن کلاینت‌ها را فراهم کند.

اگر از چارچوب‌های مدیریت سرویس مانند systemd یا SMF برای مدیریت وابستگی‌ها بین نمونه‌های درایور و سایر واحدها استفاده می‌کنید، ممکن است مجبور شوید وابستگی‌های ویژه‌ای (مثلاً با فایل‌های قطعه‌کد "drop-in" در systemd) تنظیم کنید تا درایورهای کلون شما پس از درایورهای دستگاه‌های «واقعی» در صف راه‌اندازی قرار گیرند.

نویسنده (AUTHOR)

Arjen de Korte <adkorte-guest@alioth.debian.org>

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

upscmd(8), upsrw(8), ups.conf(5), clone(8), nutupsdrv(8)