.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "libvirt-guests" "8" "" "" "Virtualization Support"
.SH "نام (NAME)"
libvirt\-guests \- اسکریپت تعلیق و از سرگیری ماشین‌های مجازی libvirt
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlibvirt\-guests\fP \fICOMMAND\fP
.SH "توضیحات (DESCRIPTION)"
.sp
\fBlibvirt\-guests\fP سرویسی است که می‌تواند برای هماهنگ‌سازی کنش‌های چرخه حیات مهمان و میزبان استفاده شود. به‌طور پیش‌فرض، \fBlibvirt\-guests\fP هنگام خاموش شدن میزبان، مهمان‌های در حال اجرا را تعلیق می‌کند و هنگام راه‌اندازی مجدد میزبان، آن‌ها را به وضعیت پیش از خاموشی بازمی‌گرداند.
.sp
\fBlibvirt\-guests\fP معمولاً تحت کنترل systemd است. هنگامی که \fBlibvirt\-guests.service\fP فعال باشد، systemd در زمان بوت شدن میزبان، \fBlibvirt\-guests\fP را با \fICOMMAND\fP مربوط به \fBstart\fP فراخوانی می‌کند. برعکس، systemd در زمان خاموش شدن میزبان، \fBlibvirt\-guests\fP را با \fICOMMAND\fP مربوط به \fBstop\fP فراخوانی خواهد کرد.
.sp
\fBlibvirt\-guests\fP می‌تواند به‌طور مستقیم نیز استفاده شود. علاوه بر دستورهای \fBstart\fP و \fBstop\fP، از دستورهای \fBstatus\fP، \fBrestart\fP، \fBcondrestart\fP، \fBtry\-restart\fP، \fBreload\fP، \fBforce\-reload\fP، \fBgueststatus\fP و \fBshutdown\fP نیز پشتیبانی می‌کند.
.SH "فایل‌ها (FILES)"
.sp
\fBlibvirt\-guests\fP چندین متغیر برای کنترل رفتار سرویس تعریف می‌کند. مقادیر پیش‌فرض این متغیرها را می‌توان در فایل زیر بازنویسی کرد:
.INDENT 0.0
.IP \(bu 2
\fB/etc/conf.d/libvirt\-guests\fP
.UNINDENT
.sp
متغیرهای زیر پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
URIS=default
.sp
شناسه‌های یکنواخت منبع (URIs) برای بررسی مهمان‌های در حال اجرا. مثال:
\fBURIS=\(aqdefault xen:///system xen+tcp://host/system lxc:///system\(aq\fP
.IP \(bu 2
ON_BOOT=start
.sp
عملیاتی که هنگام بوت میزبان انجام می‌شود
.INDENT 2.0
.IP \(bu 2
start
.sp
تمام مهمان‌هایی که هنگام خاموش شدن در حال اجرا بودند، بدون توجه به تنظیمات autostart آن‌ها، در زمان بوت آغاز می‌شوند
.IP \(bu 2
ignore
.sp
\fBlibvirt\-guests\fP هیچ مهمانی را هنگام بوت آغاز نمی‌کند، با این حال، مهمان‌هایی که دارای نشان autostart هستند همچنان به‌طور خودکار توسط libvirtd آغاز خواهند شد
.UNINDENT
.IP \(bu 2
START_DELAY=0
.sp
تعداد ثانیه‌های انتظار بین شروع هر مهمان. برای اجازه راه‌اندازی موازی، روی 0 تنظیم کنید.
.IP \(bu 2
ON_SHUTDOWN=suspend
.sp
عملیاتی که هنگام خاموش شدن میزبان انجام می‌شود
.INDENT 2.0
.IP \(bu 2
suspend
.sp
تمام مهمان‌های در حال اجرا با استفاده از virsh managedsave تعلیق می‌شوند
.IP \(bu 2
shutdown
.sp
از تمام مهمان‌های در حال اجرا درخواست خاموش شدن می‌شود. لطفاً در استفاده از این تنظیم احتیاط کنید زیرا راهی برای تمایز بین مهمانی که متوقف شده است یا درخواست‌های خاموش شدن را نادیده می‌گیرد و مهمانی که فقط به زمان زیادی برای خاموش شدن نیاز دارد، وجود ندارد. هنگام تنظیم ON_SHUTDOWN=shutdown، باید SHUTDOWN_TIMEOUT را نیز روی مقداری مناسب برای مهمان‌های خود تنظیم کنید.
.UNINDENT
.IP \(bu 2
PARALLEL_SHUTDOWN=0
.sp
تعداد مهمان‌هایی که به‌طور هم‌زمان خاموش می‌شوند، که وقتی \(dqON_SHUTDOWN\(dq روی \(dqshutdown\(dq تنظیم شده باشد اعمال می‌شود. اگر روی 0 تنظیم شود، مهمان‌ها یکی پس از دیگری خاموش خواهند شد. تعداد مهمان‌ها در حال خاموش شدن در هر لحظه از مقدار تعیین‌شده در این متغیر بیشتر نخواهد بود.
.IP \(bu 2
SHUTDOWN_TIMEOUT=300
.sp
تعداد ثانیه‌هایی که مایل به انتظار برای خاموش شدن یک مهمان هستیم. اگر خاموش‌سازی موازی فعال باشد، این مهلت زمانی به عنوان مهلت خاموش کردن تمام مهمان‌ها در یک URI منفرد تعریف‌شده در متغیر URIS اعمال می‌شود. اگر این مقدار 0 باشد، هیچ مهلت زمانی وجود ندارد (با احتیاط استفاده شود، زیرا مهمان‌ها ممکن است به درخواست خاموش شدن پاسخ ندهند). مقدار پیش‌فرض 300 ثانیه (5 دقیقه) است.
.IP \(bu 2
BYPASS_CACHE=0
.sp
اگر غیر صفر باشد، تلاش می‌کند تا هنگام ذخیره و بازیابی مهمان‌ها، حافظه نهان (cache) سیستم فایل را دور بزند، هرچند ممکن است این کار برای برخی سیستم‌های فایل عملکرد کندتری ایجاد کند.
.IP \(bu 2
SYNC_TIME=0
.sp
اگر غیر صفر باشد، تلاش می‌کند زمان مهمان را هنگام از سرگیری دامنه همگام‌سازی کند. توجه داشته باشید که این امر نیازمند اجرای عامل مهمان (guest agent) با پشتیبانی از همگام‌سازی زمان در داخل مهمان است. به‌طور پیش‌فرض، این قابلیت خاموش است.
.IP \(bu 2
PERSISTENT_ONLY=default
.sp
تعیین می‌کند که عمل ON_SHUTDOWN روی چه نوع ماشین مجازی مهمانی اعمال شود
.INDENT 2.0
.IP \(bu 2
default
.sp
این رفتار پیش‌فرض موجود را پیاده‌سازی می‌کند.
اگر عمل ON_SHUTDOWN برابر با shutdown باشد، از ماشین‌های مجازی مهمان گذرا (transient) و ماندگار (persistent) درخواست می‌شود که خاموش شوند.
اگر عمل ON_SHUTDOWN برابر با suspend باشد، فقط از ماشین‌های مجازی مهمان ماندگار درخواست می‌شود که تعلیق شوند.
.IP \(bu 2
true
.sp
عمل ON_SHUTDOWN فقط بر روی ماشین‌های مجازی مهمان ماندگار اجرا می‌شود. ماشین‌های مجازی مهمان گذرا تحت تأثیر قرار نمی‌گیرند.
.IP \(bu 2
false
.sp
عمل ON_SHUTDOWN روی ماشین‌های مجازی مهمان ماندگار و گذرا اجرا می‌شود.
.UNINDENT
.UNINDENT
.SH "اشکالات (BUGS)"
.sp
لطفاً هرگونه اشکالی که پیدا می‌کنید را گزارش دهید. این کار باید از طریق یکی از موارد زیر انجام شود:
.INDENT 0.0
.IP 1. 3
فهرست پستی
.sp
\%<https://\:libvirt\:.org/\:contact\:.html>
.IP 2. 3
ردیاب اشکال
.sp
\%<https://\:libvirt\:.org/\:bugs\:.html>
.UNINDENT
.sp
همچنین می‌توانید اشکالات را به توزیع‌کننده / ارائه‌دهنده نرم‌افزار خود گزارش دهید.
.SH "نویسندگان (AUTHORS)"
.sp
لطفاً به فایل AUTHORS توزیع‌شده همراه با libvirt مراجعه کنید.
.SH "مجوز (LICENSE)"
.sp
\fBlibvirt\-guests\fP تحت شرایط مجوز GNU LGPL v2.1+ توزیع شده است. این یک نرم‌افزار آزاد است؛ برای شرایط نسخه‌برداری به سورس مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.sp
libvirtd(8), \%<https://\:libvirt\:.org>