نام (NAME)

clone - کلون کردن یک UPS و در نظر گرفتن خروجی برق آن به عنوان یک UPS مستقل (با پشتیبانی از دستورات فوری خاموش‌سازی INSTCMD)

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

clone -h

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

توضیحات (DESCRIPTION)

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

برخلاف درایور clone-outlet(8)، این درایور یک دستگاه قابل‌مدیریت را نشان می‌دهد که هم برای نظارت و هم برای خاموش‌سازی کامپیوترهای کلاینت و خروجی UPS/ePDU قابل استفاده است (از ارسال دستورات فوری مرتبط در زمان اجرا پشتیبانی می‌کند).

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

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

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

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

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

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

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

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

port=drivername-devicename

load.off=command

load.on=command

load.status=value

offdelay=num

ondelay=num

mincharge=value

minruntime=value

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

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

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

این درایور از دستورات فوری (instant commands) برای آغاز یک خاموش‌سازی اجباری (forced shutdown) برای upsmon یا کلاینت‌های مشابه که این دستگاه UPS مجازی را MONITOR می‌کنند، پشتیبانی می‌کند؛ در صورتی که وضعیت خروجی در حال حاضر on باشد و هیچ خاموش‌سازی دیگری تاکنون آغاز نشده باشد (با تنظیم تایمر تاخیر خاموش‌سازی UPS مجازی روی offdelay و صدور FSD از طریق ups.status):

چنین دستوراتی با استفاده از پروتکل سوکت NUT (با استفاده از نام دستورات مشخص‌شده در گزینه‌های پیکربندی درایور load.off و load.on) به درایور «واقعی» ارسال می‌شوند، مشروط بر اینکه تایمرهای خاموش‌سازی یا راه‌اندازی در آن لحظه تنظیم شده باشند، یا دستگاه «واقعی» برخط (online) نبوده و شارژ باتری یا زمان کارکرد شناخته‌شده آن زیر آستانه‌های پیکربندی‌شده "low" باشد.

وضعیت خروجی با استفاده از نام مشخص‌شده توسط گزینه load.status درایور (در صورت تنظیم) تعیین می‌شود، یا صرفاً بر اساس آخرین عملیات خاموش‌سازی/راه‌اندازی تکمیل‌شده (با استفاده از شماره خروجی نامشخص) فرض می‌شود.

این درایور از عملیات خاموش‌سازی معمول دستگاه‌های NUT پشتیبانی نمی‌کند (اجرای clone -k فقط یک خطا چاپ کرده و خارج می‌شود).

این درایور همچنین از تنظیم برخی متغیرهای NUT در زمان اجرا پشتیبانی می‌کند:

در مقایسه با مقادیر درایور «واقعی»، این درایور داده‌های زیر را نیز اضافه (یا بازنویسی) می‌کند: ups.delay.shutdown، ups.delay.start، ups.timer.shutdown و ups.timer.start. این درایور مقادیر درایور «واقعی» برای battery.charge و battery.runtime (خوانش‌های واقعی کنونی) را ردیابی می‌کند تا بعداً درباره خاموش‌سازی خودکار خروجی تصمیم‌گیری کند.

مهم (IMPORTANT)

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

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

هشدارها (CAVEATS)

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

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

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

نویسنده (AUTHOR)

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

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

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