libvirt-guests(8) Virtualization Support libvirt-guests(8)

libvirt-guests - اسکریپت تعلیق و از سرگیری ماشین‌های مجازی libvirt

libvirt-guests COMMAND

libvirt-guests سرویسی است که می‌تواند برای هماهنگ‌سازی کنش‌های چرخه حیات مهمان و میزبان استفاده شود. به‌طور پیش‌فرض، libvirt-guests هنگام خاموش شدن میزبان، مهمان‌های در حال اجرا را تعلیق می‌کند و هنگام راه‌اندازی مجدد میزبان، آن‌ها را به وضعیت پیش از خاموشی بازمی‌گرداند.

libvirt-guests معمولاً تحت کنترل systemd است. هنگامی که libvirt-guests.service فعال باشد، systemd در زمان بوت شدن میزبان، libvirt-guests را با COMMAND مربوط به start فراخوانی می‌کند. برعکس، systemd در زمان خاموش شدن میزبان، libvirt-guests را با COMMAND مربوط به stop فراخوانی خواهد کرد.

libvirt-guests می‌تواند به‌طور مستقیم نیز استفاده شود. علاوه بر دستورهای start و stop، از دستورهای status، restart، condrestart، try-restart، reload، force-reload، gueststatus و shutdown نیز پشتیبانی می‌کند.

libvirt-guests چندین متغیر برای کنترل رفتار سرویس تعریف می‌کند. مقادیر پیش‌فرض این متغیرها را می‌توان در فایل زیر بازنویسی کرد:

•
/etc/conf.d/libvirt-guests

متغیرهای زیر پشتیبانی می‌شوند:

  • URIS=default

    شناسه‌های یکنواخت منبع (URIs) برای بررسی مهمان‌های در حال اجرا. مثال: URIS='default xen:///system xen+tcp://host/system lxc:///system'

  • ON_BOOT=start

    عملیاتی که هنگام بوت میزبان انجام می‌شود

  • start

    تمام مهمان‌هایی که هنگام خاموش شدن در حال اجرا بودند، بدون توجه به تنظیمات autostart آن‌ها، در زمان بوت آغاز می‌شوند

  • ignore

    libvirt-guests هیچ مهمانی را هنگام بوت آغاز نمی‌کند، با این حال، مهمان‌هایی که دارای نشان autostart هستند همچنان به‌طور خودکار توسط libvirtd آغاز خواهند شد

  • START_DELAY=0

    تعداد ثانیه‌های انتظار بین شروع هر مهمان. برای اجازه راه‌اندازی موازی، روی 0 تنظیم کنید.

  • ON_SHUTDOWN=suspend

    عملیاتی که هنگام خاموش شدن میزبان انجام می‌شود

  • suspend

    تمام مهمان‌های در حال اجرا با استفاده از virsh managedsave تعلیق می‌شوند

  • shutdown

    از تمام مهمان‌های در حال اجرا درخواست خاموش شدن می‌شود. لطفاً در استفاده از این تنظیم احتیاط کنید زیرا راهی برای تمایز بین مهمانی که متوقف شده است یا درخواست‌های خاموش شدن را نادیده می‌گیرد و مهمانی که فقط به زمان زیادی برای خاموش شدن نیاز دارد، وجود ندارد. هنگام تنظیم ON_SHUTDOWN=shutdown، باید SHUTDOWN_TIMEOUT را نیز روی مقداری مناسب برای مهمان‌های خود تنظیم کنید.

  • PARALLEL_SHUTDOWN=0

    تعداد مهمان‌هایی که به‌طور هم‌زمان خاموش می‌شوند، که وقتی "ON_SHUTDOWN" روی "shutdown" تنظیم شده باشد اعمال می‌شود. اگر روی 0 تنظیم شود، مهمان‌ها یکی پس از دیگری خاموش خواهند شد. تعداد مهمان‌ها در حال خاموش شدن در هر لحظه از مقدار تعیین‌شده در این متغیر بیشتر نخواهد بود.

  • SHUTDOWN_TIMEOUT=300

    تعداد ثانیه‌هایی که مایل به انتظار برای خاموش شدن یک مهمان هستیم. اگر خاموش‌سازی موازی فعال باشد، این مهلت زمانی به عنوان مهلت خاموش کردن تمام مهمان‌ها در یک URI منفرد تعریف‌شده در متغیر URIS اعمال می‌شود. اگر این مقدار 0 باشد، هیچ مهلت زمانی وجود ندارد (با احتیاط استفاده شود، زیرا مهمان‌ها ممکن است به درخواست خاموش شدن پاسخ ندهند). مقدار پیش‌فرض 300 ثانیه (5 دقیقه) است.

  • BYPASS_CACHE=0

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

  • SYNC_TIME=0

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

  • PERSISTENT_ONLY=default

    تعیین می‌کند که عمل ON_SHUTDOWN روی چه نوع ماشین مجازی مهمانی اعمال شود

  • default

    این رفتار پیش‌فرض موجود را پیاده‌سازی می‌کند. اگر عمل ON_SHUTDOWN برابر با shutdown باشد، از ماشین‌های مجازی مهمان گذرا (transient) و ماندگار (persistent) درخواست می‌شود که خاموش شوند. اگر عمل ON_SHUTDOWN برابر با suspend باشد، فقط از ماشین‌های مجازی مهمان ماندگار درخواست می‌شود که تعلیق شوند.

  • true

    عمل ON_SHUTDOWN فقط بر روی ماشین‌های مجازی مهمان ماندگار اجرا می‌شود. ماشین‌های مجازی مهمان گذرا تحت تأثیر قرار نمی‌گیرند.

  • false

    عمل ON_SHUTDOWN روی ماشین‌های مجازی مهمان ماندگار و گذرا اجرا می‌شود.

لطفاً هرگونه اشکالی که پیدا می‌کنید را گزارش دهید. این کار باید از طریق یکی از موارد زیر انجام شود:

1.
فهرست پستی

https://libvirt.org/contact.html

2.
ردیاب اشکال

https://libvirt.org/bugs.html

همچنین می‌توانید اشکالات را به توزیع‌کننده / ارائه‌دهنده نرم‌افزار خود گزارش دهید.

لطفاً به فایل AUTHORS توزیع‌شده همراه با libvirt مراجعه کنید.

libvirt-guests تحت شرایط مجوز GNU LGPL v2.1+ توزیع شده است. این یک نرم‌افزار آزاد است؛ برای شرایط نسخه‌برداری به سورس مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

libvirtd(8), https://libvirt.org