.\" 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 "virt-clone" "1" "" "" "Virtualization Support" .SH "نام (NAME)" virt-clone \- همتاسازی و ایجاد کلون از ماشین‌های مجازی مهمان .SH "خلاصه دستور (SYNOPSIS)" .sp \fBvirt\-clone\fP [\fIگزینه\fP]... .SH "توضیحات (DESCRIPTION)" .sp دستور \fBvirt\-clone\fP یک ابزار خط فرمان برای همتاسازی و کلون‌گیری از تصاویر ماشین مجازی موجود با استفاده از کتابخانه مدیریت هایپروایزر \fBlibvirt\fP است. این ابزار تصاویر دیسک هر ماشین مجازی موجود را کپی می‌کند و یک مهمان جدید با پیکربندی سخت‌افزاری مجازی یکسان تعریف می‌نماید. المان‌هایی که نیازمند یکتایی هستند به‌روزرسانی می‌شوند تا از تداخل بین مهمان قدیم و جدید جلوگیری شود. .sp به‌طور پیش‌فرض، اگر اطلاعات لازم برای کلون کردن مهمان ارائه نشود، virt\-clone یک خطا نمایش می‌دهد. گزینه \-\-auto\-clone تمام ورودی‌های مورد نیاز را به جز مهمان مبدا برای کلون کردن تولید می‌کند. .sp لطفاً توجه داشته باشید که virt\-clone هیچ چیزی را در _داخل_ سیستم‌عامل مهمان تغییر نمی‌دهد، بلکه تنها دیسک‌ها را تکثیر کرده و تغییرات سمت میزبان را اعمال می‌کند. بنابراین مواردی مانند تغییر گذرواژه‌ها، تغییر نشانی IP ثابت و غیره خارج از محدوده این ابزار هستند. برای این نوع تغییرات، لطفاً به \fBvirt\-sysprep\fP\& مراجعه کنید. .SH "گزینه‌های عمومی (GENERAL OPTIONS)" .sp بیشتر گزینه‌ها الزامی نیستند. حداقل نیازمندی‌ها شامل \-\-original یا \-\-original\-xml (برای مشخص کردن مهمان جهت کلون‌گیری)، \-\-name و گزینه‌های ذخیره‌سازی مناسب از طریق \-file است. .INDENT 0.0 .TP .B \fB\-\-connect\fP URI اتصال به یک هایپروایزر غیرپیش‌فرض. برای جزئیات به virt\-install(1) مراجعه کنید. .TP .B \fB\-o\fP, \fB\-\-original\fP ORIGINAL_GUEST نام مهمان اصلی که باید کلون شود. این مهمان باید خاموش باشد. .TP .B \fB\-\-original\-xml\fP ORIGINAL_XML فایل xml مهمان libvirt برای استفاده به عنوان مهمان اصلی. نیازی نیست که مهمان روی اتصال libvirt تعریف شده باشد. این گزینه جایگزین پارامتر \fB\-\-original\fP می‌شود. .TP .B \fB\-\-auto\-clone\fP تولید خودکار نام جدید برای مهمان و مسیرهای جدید برای ذخیره‌سازی. .sp نمونه‌ای از خروجی احتمالی تولیدشده: .INDENT 7.0 .INDENT 3.5 .sp .EX Original name : MyVM Generated clone name : MyVM\-clone Original disk path : /home/user/foobar.img Generated disk path : /home/user/foobar\-clone.img .EE .UNINDENT .UNINDENT .sp اگر نام‌های تولیدشده با ماشین‌های مجازی یا فضاهای ذخیره‌سازی موجود تداخل داشته باشند، یک عدد اضافه می‌شود، مانند foobar\-clone\-1.img یا MyVM\-clone\-3. .TP .B \fB\-n\fP, \fB\-\-name\fP NAME نام نمونه ماشین مجازی مهمان جدید. این نام باید در میان تمام مهمان‌های شناخته‌شده برای اتصال هایپروایزر، از جمله مواردی که در حال حاضر فعال نیستند، یکتا باشد. .TP .B \fB\-u\fP, \fB\-\-uuid\fP UUID شناسه UUID برای مهمان؛ اگر مقداری داده نشود یک UUID تصادفی تولید خواهد شد. در صورت تعیین UUID، باید از یک عدد هگزادسیمال ۳۲ رقمی استفاده کنید. شناسه‌های UUID به‌گونه‌ای در نظر گرفته شده‌اند که در کل مرکز داده و در واقع در سراسر جهان یکتا باشند. در صورت تعیین دستی UUID این نکته را به خاطر داشته باشید. .TP .B \fB\-f\fP, \fB\-\-file\fP PATH مسیر فایل، پارتیشن دیسک یا حجم منطقی (Logical Volume) برای استفاده به عنوان فضای پشتیبان دیسک مجازی مهمان جدید. اگر مهمان اصلی دارای چندین دیسک باشد، این پارامتر باید به ازای هر دیسک در ماشین مجازی اصلی چندین بار تکرار شود. .TP .B \fB\-\-nvram\fP NVRAMFILE مسیر اختیاری برای فایل جدید VARS مربوط به nvram. اگر مسیری مشخص نشود و مهمان دارای nvram باشد، مسیر جدید nvram به‌طور خودکار تولید خواهد شد. اگر مهمان nvram نداشته باشد این گزینه نادیده گرفته می‌شود. .TP .B \fB\-\-force\-copy\fP TARGET اجبار به همتاسازی هدف دیسک ارائه‌شده (\(aqhdc\(aq, \(aqsda\(aq و غیره). به‌طور پیش‌فرض، \fBvirt\-clone\fP از برخی دیسک‌ها صرف‌نظر می‌کند، مانند مواردی که به عنوان \(aqreadonly\(aq یا \(aqshareable\(aq علامت‌گذاری شده‌اند. .TP .B \fB\-\-skip\-copy\fP TARGET صرف‌نظر کردن از همتاسازی هدف دیسک ارائه‌شده (\(aqhdc\(aq, \(aqsda\(aq و غیره). به‌طور پیش‌فرض، \fBvirt\-clone\fP برخی تصاویر دیسک، معمولاً دستگاه‌های خواندن/نوشتن را کلون می‌کند. از این گزینه برای صرف‌نظر کردن از کپی کردن یک دستگاه خاص استفاده کنید تا ماشین مجازی جدید از همان مسیر ذخیره‌سازی ماشین مجازی اصلی استفاده نماید. .TP .B \fB\-\-nonsparse\fP تخصیص کامل فضای ذخیره‌سازی جدید در صورتی که مسیر مورد کلون یک فایل پراکنده (sparse) باشد. برای جزئیات بیشتر در مورد فایل‌های پراکنده در برابر غیرپراکنده به virt\-install(1) مراجعه کنید. .TP .B \fB\-\-preserve\-data\fP هیچ فضای ذخیره‌سازی کلون نمی‌شود: تصاویر دیسک مشخص‌شده توسط \-\-file همان‌طور که هستند حفظ می‌شوند و در XML کلون جدید ارجاع داده می‌شوند. این گزینه زمانی مفید است که بخواهید یک الگوی XML ماشین مجازی را کلون کنید، اما محتوای ذخیره‌سازی را دست‌نخورده نگه دارید. .TP .B \fB\-\-reflink\fP انجام کپی سبک (lightweight copy). اگر تصاویر مبدا و مقصد همگی روی یک سیستم‌فایل btrfs باشند، این روش بسیار سریع‌تر است. این قابلیت فقط برای تصاویر دیسک با فرمت خام (raw) کار می‌کند و هر تصویر غیرخام تلاشی برای استفاده از reflink نخواهد داشت. .TP .B \fB\-m\fP, \fB\-\-mac\fP MAC نشانی MAC ثابت برای مهمان؛ در صورت حذف این پارامتر یا تعیین مقدار \fBRANDOM\fP، یک نشانی مناسب به‌صورت تصادفی تولید می‌شود. نشانی‌ها به‌ترتیبِ فهرست‌شدن در XML مهمان اصلی روی شبکه‌ها اعمال می‌شوند. .TP .B \fB\-\-print\-xml\fP چاپ ساختار XML تولیدشده برای کلون و خروج بدون انجام عملیات کلون‌گیری. .TP .B \fB\-\-replace\fP پیش از کلون‌گیری، اجرای یک \fBvirsh destroy\fP و \fBvirsh undefine\fP ساده روی هر ماشین مجازی موجود با \fB\-\-name\fP ارائه‌شده را امتحان می‌کند. اگر این عملیات‌ها شکست بخورند (مانند زمانی که \fBvirsh undefine\fP نیازمند فلگ \fB\-\-nvram\fP باشد)، کلون‌گیری شکست می‌خورد و باید ماشین مجازی موجود را به‌صورت دستی حذف کنید. .TP .B \fB\-h\fP, \fB\-\-help\fP نمایش پیام راهنما و خروج .TP .B \fB\-\-version\fP نمایش شماره نسخه برنامه و خروج .TP .B \fB\-\-check\fP فعال یا غیرفعال کردن برخی بررسی‌های اعتبارسنجی. برای جزئیات بیشتر به virt\-install(1) مراجعه کنید. .TP .B \fB\-q\fP, \fB\-\-quiet\fP نادیده‌گرفتن خروجی‌های غیرخطا. .TP .B \fB\-d\fP, \fB\-\-debug\fP چاپ اطلاعات رفع اشکال (دیباگ) در ترمینال هنگام اجرای فرآیند نصب. اطلاعات اشکال‌زدایی حتی در صورت حذف این پارامتر در \fB~/.cache/virt\-manager/virt\-clone.log\fP ذخیره می‌شود. .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp کلون کردن مهمانی به نام \fBdemo\fP روی اتصال پیش‌فرض، با تولید خودکار نام جدید و مسیر کلون دیسک. .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-clone \e \-\-original demo \e \-\-auto\-clone .EE .UNINDENT .UNINDENT .sp کلون کردن مهمانی به نام \fBdemo\fP که دارای یک دیسک تکی برای کپی است .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-clone \e \-\-original demo \e \-\-name newdemo \e \-\-file /var/lib/xen/images/newdemo.img .EE .UNINDENT .UNINDENT .sp کلون کردن یک مهمان QEMU با چندین دیسک .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-clone \e \-\-connect qemu:///system \e \-\-original demo \e \-\-name newdemo \e \-\-file /var/lib/xen/images/newdemo.img \e \-\-file /var/lib/xen/images/newdata.img .EE .UNINDENT .UNINDENT .sp کلون کردن یک مهمان بر روی یک دستگاه فیزیکی که حداقل به اندازه دیسک‌های مهمان اصلی فضا دارد. اگر دستگاه مقصد بزرگ‌تر باشد، مهمان جدید می‌تواند پس از بوت شدن اندازه سیستم‌فایل را تغییر دهد. .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-clone \e \-\-connect qemu:///system \e \-\-original demo \e \-\-name newdemo \e \-\-file /dev/HostVG/DemoVM \e \-\-mac 52:54:00:34:11:54 .EE .UNINDENT .UNINDENT .SH "اشکالات (BUGS)" .sp لطفاً به \% مراجعه کنید .SH "حق نشر (COPYRIGHT)" .sp حق نشر (C) فوجیتسو لیمیتد، حق نشر (C) شرکت ردهت (Red Hat) و مشارکت‌کنندگان مختلف. این نرم‌افزار آزاد است. شما می‌توانید نسخه‌های آن را تحت شرایط پروانه عمومی همگانی گنو (GPL) \% بازتوزیع نمایید. تا حد مجاز قانون، هیچ ضمانتی وجود ندارد. .SH "همچنین ببینید (SEE ALSO)" .sp \fBvirt\-sysprep(1)\fP, \fBvirsh(1)\fP, \fBvirt\-install(1)\fP, \fBvirt\-manager(1)\fP, وب‌سایت پروژه \% .\" End of generated man page.