.\" 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-install" "1" "" "" "Virtualization Support" .SH "نام (NAME)" virt-install \- راه‌اندازی و ایجاد ماشین‌های مجازی جدید .SH "خلاصه دستور (SYNOPSIS)" .sp \fBvirt\-install\fP [OPTION]... .SH "توضیحات (DESCRIPTION)" .sp \fBvirt\-install\fP یک ابزار خط فرمانی برای ساخت ماشین‌های مهمان جدید KVM، Xen یا کانتینرهای لینوکس با استفاده از کتابخانه مدیریت هایپروایزر \fBlibvirt\fP است. برای شروع سریع، بخش مثال‌ها (EXAMPLES) را در انتهای این سند مشاهده کنید. .sp ابزار \fBvirt\-install\fP از نصب گرافیکی با استفاده از (به عنوان مثال) VNC یا SPICE و همچنین نصب در حالت متنی از طریق کنسول سریال پشتیبانی می‌کند. ماشین مهمان را می‌توان به گونه‌ای پیکربندی کرد که از یک یا چند دیسک مجازی، رابط شبکه، دستگاه صوتی، و دستگاه‌های فیزیکی USB یا PCI و موارد دیگر استفاده کند. .sp رسانه نصب می‌تواند یک دیسک محلی ISO یا CDROM، یا یک درخت نصب توزیع (install tree) میزبانی‌شده از راه دور بر بستر HTTP، FTP یا در یک دایرکتوری محلی باشد. در حالت درخت نصب، \fBvirt\-install\fP فایل‌های حداقلی لازم برای آغاز فرایند نصب را دریافت کرده و به مهمان اجازه می‌دهد باقی توزیع سیستم‌عامل را در صورت نیاز دریافت کند. راه‌اندازی از طریق بوت شبکه (PXE) و وارد کردن (import) یک ایمیج دیسک موجود (و در نتیجه رد کردن مرحله نصب) نیز پشتیبانی می‌شوند. .sp با مشخص کردن آرگومان‌های مناسب در خط فرمان، \fBvirt\-install\fP قادر است کاملاً بدون نظارت (unattended) اجرا شود، به طوری که ماشین مهمان نیز فرایند راه‌اندازی خودکار (\(aqkickstarting\(aq) را انجام دهد. این قابلیت امکان خودکارسازی آسان نصب ماشین‌های مهمان را فراهم می‌کند. این کار می‌تواند به صورت دستی یا بسیار ساده‌تر با گزینه \-\-unattended انجام شود. .sp بسیاری از آرگومان‌ها دارای زیرگزینه‌هایی هستند که به صورت opt1=foo,opt2=bar و غیره مشخص می‌شوند. برای دیدن فهرست کاملی از زیرگزینه‌های مرتبط با هر آرگومان، \-\-option=? را امتحان کنید؛ برای مثال: virt\-install \-\-disk=? .sp بیشتر گزینه‌ها اجباری نیستند. اگر یک مقدار مناسب برای \-\-osinfo مشخص یا شناسایی شود، تمام مقادیر پیش‌فرض تعیین شده و در خروجی ترمینال گزارش می‌شوند. در غیر این صورت، حداقل گزینه‌های مورد نیاز عبارتند از \-\-memory، فضای ذخیره‌سازی مهمان (\-\-disk یا \-\-filesystem)، و انتخاب یک روش نصب. .SH "اتصال به LIBVIRT (CONNECTING TO LIBVIRT)" .SS \fB\-\-connect\fP .sp \fBنحو (Syntax):\fP \fB\-\-connect\fP URI .sp اتصال به یک هایپروایزر غیرپیش‌فرض. اگر این گزینه مشخص نشود، libvirt تلاش خواهد کرد مناسب‌ترین مورد پیش‌فرض را انتخاب کند. .sp برخی از گزینه‌های معتبر در اینجا عبارتند از: .INDENT 0.0 .TP .B qemu:///system برای ایجاد مهمان‌های KVM و QEMU جهت اجرا توسط نمونه libvirtd در سطح سیستم. این حالت پیش‌فرضی است که virt\-manager استفاده می‌کند و خواسته اغلب کاربران KVM است. .TP .B qemu:///session برای ایجاد مهمان‌های KVM و QEMU برای libvirtd که تحت کاربر عادی اجرا می‌شود. .TP .B xen:/// برای اتصال به Xen. .TP .B lxc:/// برای ایجاد کانتینرهای لینوکس. .UNINDENT.SH "گزینه‌های عمومی (GENERAL OPTIONS)" .sp پارامترهای پیکربندی عمومی که برای همه انواع نصب‌های مهمان اعمال می‌شوند. .SS \fB\-n\fP, \fB\-\-name\fP .sp \fBنحو:\fP \fB\-n\fP, \fB\-\-name\fP NAME .sp نام نمونه ماشین مجازی مهمان جدید. این نام باید در میان تمام مهمان‌های شناخته‌شده برای هایپروایزر در این اتصال، از جمله مواردی که در حال حاضر فعال نیستند، یکتا باشد. برای تعریف مجدد یک مهمان موجود، قبل از اجرای \fBvirt\-install\fP از ابزار \fBvirsh(1)\fP برای خاموش کردن آن (\(aqvirsh shutdown\(aq) و حذف آن (\(aqvirsh undefine\(aq) استفاده کنید\&. .SS \fB\-\-memory\fP .sp \fBنحو:\fP \fB\-\-memory\fP OPTIONS .sp حافظه‌ای که باید به مهمان تخصیص داده شود، بر حسب مبی‌بایت (MiB). این گزینه جایگزین گزینه منسوخ‌شده \-r/\-\-ram است. زیرگزینه‌هایی مانند \(aqmemory\(aq، \(aqcurrentMemory\(aq، \(aqmaxMemory\(aq و \(aqmaxMemory.slots\(aq در دسترس هستند که همگی به مقادیر هم‌نام خود در XML نگاشت می‌شوند. .sp برای سازگاری با گذشته، مقدار \(aqmemory\(aq به عنصر و maxmemory به عنصر نگاشت می‌شود. .sp برای پیکربندی ماژول‌های حافظه‌ای که می‌توانند در حین کار جدا شوند (hotunplug)، توضیحات \fB\-\-memdev\fP را ببینید. .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های موجود، از \-\-memory=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-memorybacking\fP .sp \fBنحو:\fP \fB\-\-memorybacking\fP OPTIONS .sp این گزینه بر نحوه پشتیبانی شدن صفحات حافظه مجازی توسط صفحات میزبان تأثیر می‌گذارد. .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های موجود، از \-\-memorybacking=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-arch\fP .sp \fBنحو:\fP \fB\-\-arch\fP ARCH .sp درخواست یک معماری پردازنده غیربومی (non\-native) برای ماشین مجازی مهمان. در صورت تعیین نشدن، از معماری پردازنده میزبان در مهمان استفاده خواهد شد. .SS \fB\-\-machine\fP .sp \fBنحو:\fP \fB\-\-machine\fP MACHINE .sp نوع ماشینی که باید شبیه‌سازی شود. معمولاً برای Xen یا KVM نیازی به تعیین این گزینه نیست، اما برای انتخاب نوع ماشین در معماری‌های نامتعارف‌تر مفید است. .SS \fB\-\-metadata\fP .sp \fBنحو:\fP \fB\-\-metadata\fP OPT=VAL,[...] .sp تعیین مقادیر فراداده برای مهمان. گزینه‌های ممکن شامل name، uuid، title و description هستند. این گزینه جایگزین گزینه‌های منسوخ‌شده \-u/\-\-uuid و \-\-description است. .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های موجود، از \-\-metadata=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-events\fP .sp \fBنحو:\fP \fB\-\-events\fP OPT=VAL,[...] .sp تعیین مقادیر رویدادها برای مهمان. گزینه‌های ممکن شامل on_poweroff، on_reboot و on_crash هستند. .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های موجود، از \-\-events=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-resource\fP .sp \fBنحو:\fP \fB\-\-resource\fP OPT=VAL,[...] .sp تعیین افراز منابع (resource partitioning) برای مهمان. .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های موجود، از \-\-resource=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-sysinfo\fP .sp \fBنحو:\fP \fB\-\-sysinfo\fP OPT=VAL,[...] .sp پیکربندی مقادیر sysinfo/SMBIOS که در دسترس سیستم‌عامل ماشین مجازی قرار می‌گیرند. مثال‌ها: .INDENT 0.0 .TP .B \fB\-\-sysinfo host\fP نوع ویژه‌ای که اطلاعات SMBIOS میزبان را در ماشین مجازی در دسترس قرار می‌دهد. .TP .B \fB\-\-sysinfo emulate\fP نوع ویژه‌ای که در آن هایپروایزر اطلاعات SMBIOS را برای ماشین مجازی تولید می‌کند. .TP .B \fB\-\-sysinfo bios.vendor=custom\fP یا \fB\-\-sysinfo smbios,bios.vendor=custom\fP نوع پیش‌فرض \fBsmbios\fP است و به کاربران اجازه می‌دهد اطلاعات SMBIOS را به‌صورت دستی مشخص کنند. .UNINDENT .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های موجود، از \-\-sysinfo=? استفاده کنید. .sp جزئیات کامل در \% و \% برای عنصر XML با نام \fBsmbios\fP..SS \fB\-\-xml\fP .sp \fBساختار:\fP \fB\-\-xml\fP ARGS .sp اعمال ویرایش‌های مستقیم بر روی XML تولیدشده با استفاده از نحو XPath. برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX virt\-install \-\-xml ./@foo=bar \-\-xml ./newelement/subelement=1 .EE .UNINDENT .UNINDENT .sp این کار XML تولیدشده را طوری تغییر می‌دهد که شامل موارد زیر باشد: .INDENT 0.0 .INDENT 3.5 .sp .EX ... 1 .EE .UNINDENT .UNINDENT .sp گزینه \-\-xml دارای ۴ زیرگزینه است: .INDENT 0.0 .TP .B \-\-xml xpath.set=XPATH[=VALUE] رفتار پیش‌فرض در صورتی که هیچ زیرگزینهٔ صریحی تنظیم نشده باشد. از ساختار XPATH=VALUE استفاده می‌کند مگر اینکه با \fBxpath.value\fP جفت شود. برای چگونگی تفسیر مقدار به بخش زیر مراجعه کنید. .TP .B \-\-xml xpath.value=VALUE \fBxpath.set\fP فقط به عنوان رشته XPath تفسیر می‌شود و از \fBxpath.value\fP به عنوان مقدار تنظیمی استفاده خواهد شد. این گزینه می‌تواند به دور زدن مشکلاتی که ممکن است در صورت وجود علامت مساوی \(aq=\(aq در رشته رخ دهد کمک کند. .sp اگر مقدار خالی باشد، به عنوان لغو مقداردهی آن گره خاص در نظر گرفته می‌شود. .TP .B \-\-xml xpath.create=XPATH گره را به عنوان یک عنصر خالی ایجاد می‌کند. برای عناصر بولی مانند لازم است. .TP .B \-\-xml xpath.delete=XPATH کل گره مشخص‌شده توسط xpath و تمام فرزندان آن را حذف می‌کند. .UNINDENT .SS \fBزیرآرگومان‌های xpath\fP .sp مشابه گزینه \fB\-\-xml\fP، اکثر گزینه‌های سطح بالا دارای زیرگزینه‌های \fBxpath.*\fP هستند. برای مثال، \fB\-\-disk xpath1.set=./@foo=bar,xpath2.create=./newelement\fP تغییراتی در XML به این شکل ایجاد می‌کند: .INDENT 0.0 .INDENT 3.5 .sp .EX .EE .UNINDENT .UNINDENT .sp این قابلیت برای تنظیم گزینه‌های XML به ازای هر دستگاه مفید است، در شرایطی که virt\-install هنوز از آن گزینه‌ها پشتیبانی نمی‌کند. .SS \fB\-\-qemu\-commandline\fP .sp \fBساختار:\fP \fB\-\-qemu\-commandline\fP ARGS .sp ارسال مستقیم گزینه‌ها به شبیه‌ساز qemu. فقط برای درایور qemu در libvirt کار می‌کند. این گزینه می‌تواند یک رشته از آرگومان‌ها را دریافت کند، برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-qemu\-commandline=\(dq\-display gtk,gl=on\(dq .EE .UNINDENT .UNINDENT .sp متغیرهای محیطی با استفاده از \(aqenv\(aq مشخص می‌شوند، برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-qemu\-commandline=env=DISPLAY=:0.1 .EE .UNINDENT .UNINDENT .sp جزئیات کامل درباره این قابلیت libvirt: \%.SS \fB\-\-vcpus\fP .sp \fBساختار:\fP \fB\-\-vcpus\fP OPTIONS .sp تعداد پردازنده‌های مجازی برای پیکربندی در سیستم‌عامل مهمان. اگر \(aqmaxvcpus\(aq مشخص شده باشد، مهمان قادر خواهد بود در حین اجرا تا سقف MAX پردازنده مجازی را به‌صورت اتصال گرم (hotplug) اضافه کند، اما با VCPUS راه‌اندازی خواهد شد. .sp مکان‌نگاری پردازنده (CPU topology) را می‌توان علاوه بر این با sockets، dies، cores و threads مشخص کرد. اگر مقادیر ذکر نشوند، موارد باقی‌مانده به‌طور خودکار با اولویت دادن به cores نسبت به sockets و سپس threads پر خواهند شد. اولویت با هسته‌ها (cores) است زیرا این امر با ویژگی‌های تراشه‌های سخت‌افزاری مدرن در دنیای واقعی مطابقت دارد و بنابراین با آنچه سیستم‌عامل مهمان انتظار مواجهه با آن را دارد سازگارتر است. .sp گزینه \(aqcpuset\(aq مشخص می‌کند که مهمان می‌تواند از کدام پردازنده‌های فیزیکی استفاده کند. \fBCPUSET\fP فهرستی از اعداد است که با کاما از هم جدا شده‌اند، و همچنین می‌توان آن را در قالب بازه‌ها یا مشخص کردن پردازنده‌هایی جهت مستثنی کردن تعیین نمود. مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX 0,2,3,5 : استفاده از پردازنده‌های 0، 2، 3 و 5 1\-5,^3,8 : استفاده از پردازنده‌های 1، 2، 4، 5 و 8 .EE .UNINDENT .UNINDENT .sp اگر مقدار \(aqauto\(aq ارسال شود، virt\-install تلاش می‌کند در صورت دردسترس بودن، با استفاده از داده‌های NUMA به‌طور خودکار یک سنجاق کردن بهینه پردازنده (cpu pinning) را تعیین کند. .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های دردسترس از \-\-vcpus=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-numatune\fP .sp \fBساختار:\fP \fB\-\-numatune\fP OPTIONS .sp تنظیم خط‌مشی NUMA برای فرایند دامنه (domain process). نمونه‌های فراخوانی .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-numatune 1,2,3,4\-7 \-\-numatune 1\-3,5,memory.mode=preferred .EE .UNINDENT .UNINDENT .sp گره‌های numa را برای تخصیص حافظه از آن‌ها مشخص می‌کند. این گزینه دارای ساختاری مشابه با گزینه \fB\-\-vcpus cpuset=\fP است. حالت (mode) می‌تواند یکی از مقادیر \(aqinterleave\(aq، \(aqpreferred\(aq یا \(aqstrict\(aq (پیش‌فرض) باشد. برای کسب اطلاعات درباره هر حالت، \(aqman 8 numactl\(aq را ببینید. .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های دردسترس از \-\-numatune=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-memtune\fP .sp \fBساختار:\fP \fB\-\-memtune\fP OPTIONS .sp تنظیم خط‌مشی حافظه برای فرایند دامنه (domain process). نمونه‌های فراخوانی .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-memtune 1000 \-\-memtune hard_limit=100,soft_limit=60,swap_hard_limit=150,min_guarantee=80 .EE .UNINDENT .UNINDENT .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های دردسترس از \-\-memtune=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-blkiotune\fP .sp \fBساختار:\fP \fB\-\-blkiotune\fP OPTIONS .sp تنظیم خط‌مشی blkio برای فرایند دامنه (domain process). نمونه‌های فراخوانی .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-blkiotune 100 \-\-blkiotune weight=100,device.path=/dev/sdc,device.weight=200 .EE .UNINDENT .UNINDENT .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های دردسترس از \-\-blkiotune=? استفاده کنید. جزئیات کامل در \%.SS \fB\-\-cpu\fP .sp \fBنحو:\fP \fB\-\-cpu\fP MODEL[,+feature][,\-feature][,match=MATCH][,vendor=VENDOR],... .sp پیکربندی مدل CPU و ویژگی‌های پردازنده‌ای که به مهمان ارائه می‌شوند. تنها مقدار الزامی MODEL است که یک مدل معتبر CPU شناخته‌شده برای libvirt می‌باشد. .sp مقادیر خط‌مشی ویژگی در libvirt عبارتند از force، require، optional، disable، یا forbid، یا با شکل خلاصه \(aq+feature\(aq و \(aq\-feature\(aq که به ترتیب معادل \(aqforce=feature\(aq و \(aqdisable=feature\(aq هستند. .sp اگر مدل دقیق CPU مشخص شود، virt\-install به‌طور خودکار ویژگی‌های CPU موجود روی میزبان را کپی می‌کند تا آسیب‌پذیری‌های امنیتی اخیر کانال جانبی اجرای حدسی (speculative execution) پردازنده و Microarchitectural Store Buffer Data را کاهش دهد. با این حال، این امر تأثیراتی بر کارایی خواهد داشت و مهاجرت به میزبان‌های فاقد وصله‌های امنیتی را با مشکل مواجه می‌کند. برای کنترل این رفتار، پارامتر \fBsecure\fP وجود دارد. مقادیر ممکن \fBon\fP و \fBoff\fP هستند که \fBon\fP پیش‌فرض است. اکیداً توصیه می‌شود این گزینه را فعال نگه دارید و اطمینان حاصل کنید که روی تمام میزبان‌های مجازی‌سازی، microcode، کرنل و نرم‌افزار مجازی‌سازی کاملاً به‌روز نصب شده باشد. .sp چند مثال: .INDENT 0.0 .TP .B \fB\-\-cpu core2duo,+x2apic,disable=vmx\fP ارائه مدل CPU core2duo، فعال‌سازی اجباری x2apic، اما عدم ارائه vmx .TP .B \fB\-\-cpu host\-model\fP ارائه پیکربندی CPUهای میزبان به مهمان. این کار مهمان را قادر می‌سازد تا از بسیاری از ویژگی‌های پردازنده‌های میزبان بهره‌مند شود (کارایی بهتر)، اما در صورت مهاجرت مهمان به میزبانی بدون CPU یکسان ممکن است مشکلاتی ایجاد کند. .TP .B \fB\-\-cpu numa.cell0.memory=1234,numa.cell0.cpus=0\-3,numa.cell1.memory=5678,numa.cell1.cpus=4\-7\fP نمونه‌ای از تعیین دو سلول NUMA. این کار ساختار XML زیر را تولید خواهد کرد: .INDENT 7.0 .INDENT 3.5 .sp .EX .EE .UNINDENT .UNINDENT .TP .B \fB\-\-cpu host\-passthrough,cache.mode=passthrough\fP نمونه‌ای از انتقال مستقیم (pass-through) اطلاعات حافظه پنهان (cache) پردازنده میزبان. .TP .B \fB\-\-cpu maximum\fP ارائه پرویژگی‌ترین CPU ممکن. هنگام اجرای مهمان با معماری متفاوت (foreign architecture)، برای نمونه مهمان riscv64 روی میزبان x86_64 مفید است. هنگام استفاده از KVM برای اجرای مهمانی با معماری یکسان توصیه نمی‌شود. .UNINDENT .sp برای دیدن فهرستی از تمام زیرگزینه‌های در دسترس، از \-\-cpu=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-cputune\fP .sp \fBنحو:\fP \fB\-\-cputune\fP OPTIONS .sp تنظیم دقیق پارامترهای CPU برای مهمان. .sp پیکربندی این‌که VCPU دامنه به کدام‌یک از پردازنده‌های فیزیکی میزبان سنجاق (pin) شود. نمونه فراخوانی .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-cputune vcpupin0.vcpu=0,vcpupin0.cpuset=0\-3,vcpupin1.vcpu=1,vcpupin1.cpuset=4\-7 .EE .UNINDENT .UNINDENT .sp برای مشاهده فهرستی از تمامی زیرگزینه‌های موجود، از \-\-cputune=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-security\fP, \fB\-\-seclabel\fP .sp \fBنحو:\fP \fB\-\-security\fP, \fB\-\-seclabel\fP type=TYPE[,label=LABEL][,relabel=yes|no],... .sp پیکربندی تنظیمات seclabel دامنه. مقدار type می‌تواند \(aqstatic\(aq یا \(aqdynamic\(aq باشد. پیکربندی \(aqstatic\(aq نیازمند یک LABEL امنیتی است. مشخص کردن LABEL بدون TYPE بیانگر پیکربندی ایستا (static) است. .sp برای دیدن فهرستی از تمام زیرگزینه‌های موجود، از \-\-security=? استفاده کنید. جزئیات کامل در \%.SS \fB\-\-keywrap\fP .sp \fBساختار:\fP \fB\-\-keywrap\fP OPTIONS .sp تعیین XML عنصر دامنه، که برای عملیات مدیریت کلید رمزنگاری S390 استفاده می‌شود. .sp از \-\-keywrap=? برای مشاهده فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-iothreads\fP .sp \fBساختار:\fP \fB\-\-iothreads\fP OPTIONS .sp تعیین XML عنصر و/یا دامنه. برای نمونه، جهت پیکربندی \fB4\fP، از \fB\-\-iothreads 4\fP استفاده کنید. .sp از \-\-iothreads=? برای مشاهده فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-features\fP .sp \fBساختار:\fP \fB\-\-features\fP FEAT=on|off,... .sp فعال (on) یا غیرفعال (off) کردن عناصر در XML بخش مهمان. نمونه‌ها شامل ویژگی‌های acpi، apic، eoi، privnet و hyperv هستند. چند مثال: .INDENT 0.0 .TP .B \fB\-\-features apic.eoi=on\fP فعال‌سازی APIC PV EOI .TP .B \fB\-\-features hyperv.vapic.state=on,hyperv.spinlocks.state=off\fP فعال‌سازی VAPIC برای hyperv، اما غیرفعال‌سازی spinlocks .TP .B \fB\-\-features kvm.hidden.state=on\fP اجازه دادن به پنهان‌سازی امضای ناظر KVM از سیستم مهمان .TP .B \fB\-\-features pvspinlock=on\fP آگاه‌سازی مهمان از اینکه میزبان از قفل‌های اسپین فرامجازی (paravirtual spinlocks) پشتیبانی می‌کند؛ برای مثال با نمایان‌سازی سازوکار pvticketlocks. .TP .B \fB\-\-features gic.version=2\fP این مورد فقط برای معماری‌های ARM کاربرد دارد. مقادیر مجاز \(dqhost\(dq یا شماره نسخه هستند. .TP .B \fB\-\-features smm.state=on\fP این حالت مدیریت سیستم (System Management Mode یا SMM) ناظر را فعال می‌کند. ممکن است برخی سفت‌افزارهای UEFI به وجود این ویژگی نیاز داشته باشند. (QEMU فقط با نوع ماشین q35 از SMM پشتیبانی می‌کند.) .UNINDENT .sp از \-\-features=? برای مشاهده فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-clock\fP .sp \fBساختار:\fP \fB\-\-clock\fP offset=OFFSET,TIMER_OPT=VAL,... .sp پیکربندی XML بخش مهمان. برخی از گزینه‌های پشتیبانی‌شده: .INDENT 0.0 .TP .B \fB\-\-clock offset=OFFSET\fP تنظیم آفست ساعت، مانند \(aqutc\(aq یا \(aqlocaltime\(aq .TP .B \fB\-\-clock TIMER_present=no\fP غیرفعال‌سازی یک تایمر بولی (boolean). در اینجا TIMER می‌تواند hpet، kvmclock و غیره باشد. .TP .B \fB\-\-clock TIMER_tickpolicy=VAL\fP تنظیم مقدار tickpolicy برای یک تایمر. TIMER در اینجا می‌تواند rtc، pit و غیره باشد. مقدار VAL می‌تواند catchup، delay و غیره باشد. برای تمام مقادیر به مستندات libvirt مراجعه کنید. .UNINDENT .sp از \-\-clock=? برای مشاهده فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-pm\fP .sp \fBساختار:\fP \fB\-\-pm\fP OPTIONS .sp پیکربندی ویژگی‌های مدیریت توان (power management) مهمان. مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-pm suspend_to_memi.enabled=on,suspend_to_disk.enabled=off .EE .UNINDENT .UNINDENT .sp از \-\-pm=? برای مشاهده فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \%.SS \fB\-\-launchSecurity\fP .sp \fBساختار:\fP \fB\-\-launchSecurity\fP TYPE[,OPTS] .sp فعال‌سازی امنیت راه‌اندازی برای ماشین مهمان، مانند AMD SEV. مثال‌های فراخوانی: .INDENT 0.0 .INDENT 3.5 .sp .EX # این دستور از خط‌مشی پیش‌فرض 0x03 استفاده خواهد کرد # هیچ dhCert ارائه نشده است، بنابراین داده‌ای با سفت‌افزار SEV تبادل نمی‌شود \-\-launchSecurity sev # خط‌مشی صریح 0x01 \- اشکال‌زدایی را غیرفعال کرده و اشتراک کلید مهمان را مجاز می‌کند \-\-launchSecurity sev,policy=0x01 # ارائه blob نشست دریافت‌شده از سفت‌افزار SEV # ارائه dhCert برای باز کردن یک کانال ارتباطی امن با سفت‌افزار SEV \-\-launchSecurity sev,session=BASE64SESSIONSTRING,dhCert=BASE64DHCERTSTRING .EE .UNINDENT .UNINDENT .sp فناوری SEV پیامدهای بیشتری در استفاده از دستگاه‌های virtio دارد، بنابراین برای مشاهده فراخوانی کامل virt\-install با \-\-launchSecurity، به بخش «مثال‌ها (EXAMPLES)» مراجعه کنید. .sp برای مشاهده فهرستی از همه زیرگزینه‌های در دسترس، از \-\-launchSecurity=? استفاده کنید. جزئیات کامل در \% .SH "گزینه‌های نصب (INSTALLATION OPTIONS)" .SS \fB\-c\fP, \fB\-\-cdrom\fP .sp \fBساختار:\fP \fB\-\-cdrom\fP PATH .sp فایل ISO یا دستگاه CDROM برای استفاده به‌عنوان رسانه نصب ماشین مجازی. پس از نصب، دستگاه CDROM مجازی متصل به ماشین مجازی باقی خواهد ماند، اما رسانه ISO یا مسیر میزبان خارج (eject) می‌شود. .SS \fB\-l\fP, \fB\-\-location\fP .sp \fBساختار:\fP \fB\-l\fP, \fB\-\-location\fP OPTIONS .sp منبع نصب درخت توزیع. ابزار virt\-install می‌تواند برخی از درخت‌های توزیع را شناسایی کرده و یک جفت kernel/initrd قابل راه‌اندازی را برای آغاز نصب واکشی کند. .sp گزینه \-\-location مواردی مانند \-\-extra\-args را برای آرگومان‌های هسته و همچنین استفاده از \-\-initrd\-inject امکان‌پذیر می‌کند. اگر می‌خواهید از این گزینه‌ها همراه با رسانه CDROM استفاده کنید، می‌توانید فایل ISO را نیز به \-\-location ارسال کنید؛ این روش برای برخی از رسانه‌های CDROM (و نه همه آن‌ها) کار می‌کند. .sp مقدار \fBLOCATION\fP می‌تواند یکی از شکل‌های زیر را داشته باشد: .INDENT 0.0 .TP .B \% مکان یک سرور HTTP حاوی ایمیج توزیع قابل نصب. .TP .B \% مکان یک سرور FTP حاوی ایمیج توزیع قابل نصب. .TP .B ISO استخراج مستقیم فایل‌ها از مسیر ISO. .TP .B DIRECTORY مسیر یک دایرکتوری محلی حاوی ایمیج توزیع قابل نصب. توجه داشته باشید که این دایرکتوری پس از راه‌اندازی اولیه توسط مهمان قابل دسترسی نخواهد بود، بنابراین نصاب سیستم‌عامل برای دسترسی به ادامه رسانه نصب به روش دیگری نیاز خواهد داشت. .UNINDENT .sp چند نمونه URL مختص توزیع‌ها: .INDENT 0.0 .TP .B Fedora/Red Hat Based \% .TP .B Debian \% .TP .B Ubuntu \% .TP .B Suse \% .UNINDENT .sp علاوه بر این، \-\-location می‌تواند زیرگزینه‌های \(aqkernel\(aq و \(aqinitrd\(aq را بپذیرد. این‌ها مسیرهایی نسبی به URL یا ISO مکان مشخص‌شده هستند که امکان انتخاب فایل‌های خاص را برای kernel/initrd در درخت نصب فراهم می‌کنند. این ویژگی زمانی مفید است که virt\-install/libosinfo نداند هسته را در \-\-location مشخص‌شده کجا پیدا کند. .sp برای مثال، اگر فایل ISO ناشناخته‌ای برای libosinfo به نام my\-unknown.iso دارید که هسته آن در \(aqkernel/fookernel\(aq و initrd آن در \(aqkernel/fooinitrd\(aq قرار دارد، می‌توانید این کار را با دستور زیر انجام دهید: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-location my\-unknown.iso,kernel=kernel/fookernel,initrd=kernel/fooinitrd .EE .UNINDENT .UNINDENT.SS \fB\-\-pxe\fP .sp نصب از طریق PXE. این گزینه صرفاً به ماشین مجازی می‌گوید که برای اولین بوت از طریق شبکه راه‌اندازی شود. .SS \fB\-\-import\fP .sp صرف‌نظر کردن از فرایند نصب سیستم‌عامل، و ساخت یک مهمان بر پایه یک ایمیج دیسک موجود. دستگاهی که برای بوت استفاده می‌شود، اولین دستگاه مشخص‌شده از طریق \fB\-\-disk\fP یا \fB\-\-filesystem\fP است\&. .SS \fB\-x\fP, \fB\-\-extra\-args\fP .sp \fBسینتکس:\fP \fB\-x\fP, \fB\-\-extra\-args\fP KERNELARGS .sp آرگومان‌های اضافی خط فرمان کرنل برای ارسال به نصاب هنگام انجام نصب مهمان از \fB\-\-location\fP\&. یک کاربرد رایج، مشخص کردن یک فایل kickstart انکوندا برای نصب‌های خودکار است، مانند: \-\-extra\-args \(dqks=https://myserver/my.ks\(dq .SS \fB\-\-initrd\-inject\fP .sp \fBسینتکس:\fP \fB\-\-initrd\-inject\fP PATH .sp افزودن PATH به ریشه initrd دریافت‌شده با \fB\-\-location\fP\&. این گزینه می‌تواند برای اجرای یک نصب خودکار بدون نیاز به میزبانی فایل kickstart روی شبکه استفاده شود: \fB\-\-initrd\-inject=/path/to/my.ks \-\-extra\-args \(dqks=file:/my.ks\(dq\fP .SS \fB\-\-install\fP .sp این یک نقطه ورود گسترده‌تر برای انواع مختلف عملیات‌های نصب است. این دستور چندین زیرآرگومان دارد، مشابه \-\-disk و گزینه‌های نظیر آن. این گزینه منحصراً برای عملیات‌های نصب ماشین مجازی بوده و اساساً اولین بوت را پیکربندی می‌کند. .sp ساده‌ترین روش استفاده، مثلاً برای نصب fedora29 بدین صورت است: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-install fedora29 .EE .UNINDENT .UNINDENT .sp و virt\-install نشانی URL مربوط به \-\-location را از libosinfo دریافت کرده و مقادیر پیش‌فرض را از آنجا مقداردهی می‌کند. .sp زیرگزینه‌های موجود: .INDENT 0.0 .TP .B \fBos=\fP این همان گزینه نصب سیستم‌عامل است که در بالا توضیح داده شد. روش صریح برای مشخص کردن آن \fB\-\-install os=fedora29\fP است. در صورتی که گزینه‌ای مشخص نشود، os= مقدار پیش‌فرض خواهد بود. .TP .B \fBkernel=\fP, \fBinitrd=\fP مشخص کردن یک جفت kernel و initrd برای استفاده به عنوان رسانه نصب. این فایل‌ها قبل از بوت کردن ماشین مجازی در یک مکان موقت کپی می‌شوند، بنابراین می‌توان آن‌ها را با \-\-initrd\-inject ترکیب کرد و رسانه مبدأ شما دست‌نخورده باقی می‌ماند. در صورت نیاز، رسانه به یک اتصال راه دور بارگذاری خواهد شد. .sp نمونه استفاده با مسیرهای فایل‌سیستم محلی: \fB\-\-install kernel=/path/to/kernel,initrd=/path/to/initrd\fP .sp نمونه استفاده با مسیرهای شبکه. ابتدا kernel/initrd به‌صورت محلی دانلود شده و سپس به عنوان مسیرهای فایل‌سیستم محلی به ماشین مجازی ارسال می‌شوند: \fB\-\-install kernel=https://127.0.0.1/tree/kernel,initrd=https://127.0.0.1/tree/initrd\fP .sp توجه داشته باشید، این موارد صرفاً برای بوت در زمان نصب هستند. اگر می‌خواهید کرنل مورد استفاده برای بوت دائمی ماشین مجازی را تنظیم کنید، از گزینه \fB\-\-boot\fP استفاده کنید. .TP .B \fBkernel_args=\fP, \fBkernel_args_overwrite=yes|no\fP مشخص کردن آرگومان‌های کرنل در زمان نصب (XML مربوط به در libvirt). این موارد را می‌توان با گزینه‌هایی نظیر kernel/initrd یا رسانه \fB\-\-location\fP ترکیب کرد. به‌طور پیش‌فرض، kernel_args دقیقاً مانند \-\-extra\-args عمل می‌کند و به آرگومان‌هایی که virt\-install به‌طور پیش‌فرض برای بیشتر نصب‌های \-\-location تنظیم می‌کند، الحاق (append) خواهد شد. اگر می‌خواهید مقدار پیش‌فرض virt\-install را لغو و بازنویسی کنید، علاوه بر این kernel_args_overwrite=yes را مشخص نمایید. .TP .B \fBbootdev=\fP دستگاه بوت برای مرحله نصب (hd، cdrom، floppy، network) را مشخص می‌کند. این گزینه با XML مربوط به در libvirt نگاشت می‌شود. .sp اگر می‌خواهید از یک cdrom یا شبکه نصب کنید، احتمالاً ساده‌تر است و سازگاری بهتری با نسخه‌های پیشین دارد که صرفاً از \fB\-\-cdrom\fP یا \fB\-\-pxe\fP استفاده کنید، اما این گزینه در صورت نیاز کنترل دقیق‌تری را روی فرایند نصب فراهم می‌کند. .TP .B \fBno_install=yes|no\fP به virt\-install اعلام می‌کند که در عمل هیچ نصبی در حال انجام نیست و شما فقط می‌خواهید ماشین مجازی را ایجاد کنید. گزینه \fB\-\-import\fP صرفاً یک نام مستعار برای این مورد است، همانند مشخص کردن \fB\-\-boot\fP بدون هیچ گزینه نصب دیگری. گزینه منسوخ‌شده \fB\-\-live\fP نیز معادل \(aq\-\-cdrom $ISO \-\-install no_install=yes\(aq است. .UNINDENT.SS \fB\-\-reinstall DOMAIN\fP .sp نصب مجدد یک VM موجود. DOMAIN می‌تواند نام، UUID یا شماره ID یک VM باشد. virt\-install پرونده XML دامنه را از libvirt دریافت کرده، تغییرات پیکربندی نصبِ مشخص‌شده را اعمال می‌کند، VM را برای فرایند نصب بوت کرده و سپس تقریباً به همان XML اولیه بازمی‌گرداند. .sp تنها گزینه‌های مرتبط با نصب پردازش می‌شوند؛ تمام گزینه‌های دیگرِ پیکربندی VM مانند \-\-name، \-\-disk و غیره به‌طور کامل نادیده گرفته می‌شوند. .sp اگر \-\-reinstall به همراه \-\-cdrom استفاده شود، در صورت در دسترس بودن یک CDROM متصل به VM، از همان استفاده خواهد شد؛ در غیر این صورت یک دستگاه CDROM دائمی اضافه می‌شود. .SS \fB\-\-unattended\fP .sp \fBنحو:\fP \fB\-\-unattended\fP [OPTIONS] .sp انجام یک نصب بدون نظارت (unattended) با استفاده از پشتیبانی اسکریپت نصب در libosinfo. این قابلیت در اصل پایگاه‌داده‌ای از اسکریپت‌های نصب خودکار برای توزیع‌های گوناگون است: Red Hat kickstarts، اسکریپت‌نویسی نصاب Debian، نصب‌های بدون نظارت Windows، و احتمالاً موارد دیگر. ساده‌ترین روش فراخوانی، ترکیب آن با \-\-install است، مانند: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-install fedora29 \-\-unattended .EE .UNINDENT .UNINDENT .sp یک نصب Windows بدین صورت خواهد بود: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-cdrom /path/to/my/windows.iso \-\-unattended .EE .UNINDENT .UNINDENT .sp زیرگزینه‌ها عبارت‌اند از: .INDENT 0.0 .TP .B \fBprofile=\fP انتخاب اینکه از کدام نمایه (profile) بدون نظارت libosinfo استفاده شود. بیشتر توزیع‌ها دارای نمایه‌های \(aqdesktop\(aq و \(aqjeos\(aq هستند. در صورت عدم تعیین، virt\-install به‌طور پیش‌فرض از \(aqdesktop\(aq استفاده خواهد کرد. .TP .B \fBadmin\-password\-file=\fP فایلی که برای تنظیم گذرواژه admin/root سیستم‌عامل VM استفاده می‌شود. این گزینه می‌تواند به‌صورت \(dqadmin\-password\-file=/path/to/password\-file\(dq یا به‌صورت \(dqadmin\-password\-file=/dev/fd/n\(dq استفاده شود که n توصیف‌گر فایل (file descriptor) پرونده گذرواژه است. توجه داشته باشید که فقط خط اول فایل، شامل هرگونه نویسه فاصله (whitespace) و بدون احتساب خط جدید (new\-line) در نظر گرفته خواهد شد. .TP .B \fBuser\-login=\fP نام کاربری برای ورود به VM. در صورت عدم تعیین، virt\-install به‌طور پیش‌فرض از نام کاربری فعلی میزبان شما استفاده می‌کند. توجه داشته باشید که هنگام اجرای virt\-install به‌عنوان \(dqroot\(dq، تعیین این گزینه الزامی است. .TP .B \fBuser\-password\-file=\fP فایلی که برای تنظیم گذرواژه کاربر VM استفاده می‌شود. این گزینه می‌تواند به‌صورت \(dquser\-password\-file=/path/to/password\-file\(dq یا به‌صورت \(dquser\-password\-file=/dev/fd/n\(dq استفاده شود که n توصیف‌گر فایل پرونده گذرواژه است. نام کاربری، یا همان user\-login مشخص‌شده است یا نام کاربری فعلی میزبان شما. توجه داشته باشید که فقط خط اول فایل، شامل هرگونه نویسه فاصله و بدون احتساب خط جدید در نظر گرفته خواهد شد. .TP .B \fBproduct\-key=\fP تنظیم یک کلید محصول (product key) ویندوز .UNINDENT .SS \fB\-\-cloud\-init\fP .sp ارسال متادیتای cloud\-init به VM. یک فایل ISO از نوع NoCloud مربوط به cloud\-init تولید شده و به‌عنوان یک دستگاه CDROM به VM متصل می‌شود. این دستگاه تنها برای بوت اول متصل می‌گردد. این گزینه به‌ویژه برای ایمیج‌های ابری توزیع‌ها که به‌طور پیش‌فرض حساب‌های کاربری ورود آن‌ها قفل است مفید است؛ \-\-cloud\-init راهکاری برای مقداردهی اولیه این حساب‌های کاربری مانند تنظیم گذرواژه root فراهم می‌کند. .sp ساده‌ترین حالت فراخوانی صرفاً استفاده ساده از \fB\-\-cloud\-init\fP بدون هیچ زیرگزینه‌ای است؛ این حالت معادل \fB\-\-cloud\-init root\-password\-generate=on,disable=on\fP\& می‌باشد. برای آگاهی از نحوه کار، توضیحات آن زیرگزینه‌ها را ببینید. .sp از \-\-cloud\-init=? برای دیدن فهرست تمام زیرگزینه‌های در دسترس استفاده کنید. .sp زیرگزینه‌ها عبارت‌اند از: .INDENT 0.0 .TP .B \fBroot\-password\-generate=on\fP تولید یک گذرواژه root جدید برای VM. در صورت استفاده، virt\-install گذرواژه تولیدشده را در کنسول چاپ کرده و ۱۰ ثانیه مکث می‌کند تا به کاربر فرصت مشاهده و رونوشت برداشتن از آن را بدهد. .TP .B \fBdisable=on\fP غیرفعال‌سازی cloud\-init در VM برای بوت‌های بعدی. بدون این گزینه، ممکن است cloud\-init در هر بار بوت، احراز هویت را بازنشانی کند. .TP .B \fBroot\-password\-file=\fP فایلی که برای تنظیم گذرواژه root در VM استفاده می‌شود. این گزینه می‌تواند به‌صورت \(dqroot\-password\-file=/path/to/password\-file\(dq یا به‌صورت \(dqroot\-password\-file=/dev/fd/n\(dq استفاده شود که n توصیف‌گر فایل پرونده گذرواژه است. توجه داشته باشید که فقط خط اول فایل، شامل هرگونه نویسه فاصله و بدون احتساب خط جدید در نظر گرفته خواهد شد. .TP .B \fBmeta\-data=\fP مشخص کردن یک فایل meta\-data مربوط به cloud\-init برای افزودن مستقیم به iso. سایر گزینه‌های پیکربندی meta\-data در خط فرمان \-\-cloud\-init نادیده گرفته می‌شوند. می‌تواند مسیر یک فایل محلی یا URL باشد. .TP .B \fBuser\-data=\fP مشخص کردن یک فایل user\-data مربوط به cloud\-init برای افزودن مستقیم به iso. سایر گزینه‌های پیکربندی user\-data در خط فرمان \-\-cloud\-init نادیده گرفته می‌شوند. می‌تواند مسیر یک فایل محلی یا URL باشد. .TP .B \fBroot\-ssh\-key=\fP مشخص کردن یک کلید عمومی برای تزریق به مهمان، جهت فراهم کردن دسترسی ssh به حساب کاربری root. مثال: root\-ssh\-key=/home/user/.ssh/id_rsa.pub .TP .B \fBclouduser\-ssh\-key\fP مشخص کردن یک کلید عمومی برای تزریق به مهمان، جهت فراهم کردن دسترسی ssh به حساب کاربری پیش‌فرض cloud\-init. نام این حساب در هر ایمیج ابری توزیع‌ها متفاوت است. برخی از موارد متداول در اینجا مستند شده‌اند: \% .TP .B \fBnetwork\-config=\fP مشخص کردن یک فایل network\-config مربوط به cloud\-init برای افزودن مستقیم به iso. می‌تواند مسیر یک فایل محلی یا URL باشد. .UNINDENT.SS \fB\-\-boot\fP .sp \fBنحو:\fP \fB\-\-boot\fP BOOTOPTS .sp به‌صورت اختیاری پیکربندی راه‌اندازی ماشین مجازی پس از نصب را مشخص می‌کند. این گزینه امکان تعیین ترتیب دستگاه‌های راه‌اندازی، راه‌اندازی دائمی از kernel/initrd همراه با آرگومان‌های اختیاری هسته، و فعال‌سازی منوی راه‌اندازی BIOS را فراهم می‌کند (نیازمند libvirt نسخهٔ 0.8.3 یا بالاتر است). .sp گزینهٔ \-\-boot می‌تواند علاوه بر سایر گزینه‌های نصب (مانند \-\-location، \-\-cdrom و غیره) یا به‌تنهایی مشخص شود. در حالت اخیر، رفتار آن مشابه گزینهٔ نصب \-\-import است: هیچ مرحلهٔ «نصبی» وجود ندارد، مهمان فقط همان‌طور که مشخص شده ایجاد و راه‌اندازی می‌شود. .sp چند مثال: .INDENT 0.0 .TP .B \fB\-\-boot cdrom,fd,hd,network\fP اولویت دستگاه‌های راه‌اندازی را به ترتیب نخست cdrom، نخستین فلاپی، نخستین دیسک سخت و راه‌اندازی شبکهٔ PXE تعیین می‌کند. نکته: مهمان‌های s390x تنها از یک دستگاه راه‌اندازی پشتیبانی می‌کنند، بنابراین همه‌چیز به جز نوع دستگاه اول نادیده گرفته خواهد شد. .TP .B \fB\-\-boot kernel=KERNEL,initrd=INITRD,kernel_args=\(dqconsole=/dev/ttyS0\(dq\fP کاری می‌کند که مهمان به‌طور دائم از یک جفت kernel/initrd محلی، همراه با گزینه‌های هستهٔ مشخص‌شده راه‌اندازی شود. .TP .B \fB\-\-boot kernel=KERNEL,initrd=INITRD,dtb=DTB\fP کاری می‌کند که مهمان به‌طور دائم از یک جفت kernel/initrd محلی همراه با یک باینری درخت دستگاه (DTB) خارجی راه‌اندازی شود. DTB می‌تواند برای برخی پیکربندی‌های غیر x86 مانند ARM یا PPC لازم باشد. .TP .B \fB\-\-boot loader=BIOSPATH\fP استفاده از BIOSPATH به‌عنوان BIOS ماشین مجازی. .TP .B \fB\-\-boot bootmenu.enable=on,bios.useserial=on\fP فعال‌سازی منوی راه‌اندازی bios، و فعال‌سازی ارسال خروجی متنی bios از طریق کنسول سریال. .TP .B \fB\-\-boot init=INITPATH\fP مسیر به باینری‌ای که مهمان کانتینری آن را به‌عنوان init اجرا خواهد کرد. اگر یک \fB\-\-filesystem\fP ریشه مشخص شده باشد، virt\-install به‌طور پیش‌فرض از /sbin/init استفاده خواهد کرد، در غیر این صورت مقدار پیش‌فرض /bin/sh خواهد بود. .TP .B \fB\-\-boot uefi\fP, \fB\-\-boot uefi=on\fP ماشین مجازی را برای راه‌اندازی از UEFI پیکربندی می‌کند. برای این‌که virt\-install پارامترهای صحیح UEFI را تشخیص دهد، libvirt باید باینری‌های شناخته‌شدهٔ UEFI را از طریق XML مربوط به domcapabilities اعلان کند، بنابراین این قابلیت احتمالاً تنها در صورت استفاده از بسته‌های توزیع به‌درستی پیکربندی‌شده کار خواهد کرد. این روش، راه‌اندازی توصیه‌شدهٔ UEFI است. .TP .B \fB\-\-boot uefi=off\fP در صورتی که ماشین مجازی معمولاً به‌طور پیش‌فرض از UEFI استفاده می‌کند، از آن استفاده نشود. .TP .B \fB\-\-boot uefi,firmware.feature0.name=secure\-boot,firmware.feature0.enabled=yes,firmware.feature1.name=enrolled\-keys,firmware.feature1.enabled=yes\fP ماشین مجازی را برای راه‌اندازی از UEFI با فعال بودن پشتیبانی از Secure Boot پیکربندی می‌کند. تنها سیستم‌عامل‌های امضاشده قادر به راه‌اندازی با این پیکربندی خواهند بود. .TP .B \fB\-\-boot uefi,firmware.feature0.name=secure\-boot,firmware.feature0.enabled=no\fP ماشین مجازی را برای راه‌اندازی از UEFI با غیرفعال بودن پشتیبانی از Secure Boot پیکربندی می‌کند. این پیکربندی امکان اجرای هر دو نوع سیستم‌عامل‌های امضاشده و امضانشده را فراهم می‌سازد. .sp اطلاعات بیشتر دربارهٔ قابلیت‌های سفت‌افزاری \fBsecure\-boot\fP و \fBenrolled\-keys\fP و نحوهٔ استفاده از آن‌ها برای اثرگذاری بر انتخاب سفت‌افزار در نشانی زیر در دسترس است: \% .TP .B \fB\-\-boot loader=/.../OVMF_CODE.fd,loader.readonly=yes,loader.type=pflash,nvram.template=/.../OVMF_VARS.fd,loader_secure=no\fP مشخص می‌کند که ماشین مجازی از باینری سفارشی OVMF به‌عنوان سفت‌افزار راه‌اندازی، نگاشته‌شده به‌صورت تراشهٔ فلش مجازی، استفاده کند. علاوه بر این، از libvirt درخواست می‌کند تا varstore اختصاصی UEFI ماشین مجازی را از الگوی varstore سفارشی \(dq/.../OVMF_VARS.fd\(dq ایجاد کند. این راه‌اندازی توصیه نمی‌شود، و تنها باید زمانی استفاده شود که \-\-boot uefi از باینری‌های UEFI شما اطلاعی نداشته باشد. .UNINDENT .sp برای مشاهدهٔ فهرستی از تمام زیرگزینه‌های موجود از \-\-boot=? استفاده کنید. جزئیات کامل در: \% .SS \fB\-\-idmap\fP .sp \fBنحو:\fP \fB\-\-idmap\fP OPTIONS .sp اگر در پیکربندی مهمان یک نگاشت UID یا GID تعریف شده باشد، فضای نام \(aquser\(aq برای اعمال آن‌ها فعال خواهد شد. یک نگاشت مناسب پیکربندی‌شده برای UID/GID، پیش‌نیازی برای ایمن‌سازی کانتینرها در صورت نبود محدودسازی sVirt است. .sp می‌توان \-\-idmap را برای فعال‌سازی فضای نام کاربر برای کانتینرهای LXC مشخص کرد. مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-idmap uid.start=0,uid.target=1000,uid.count=10,gid.start=0,gid.target=1000,gid.count=10 .EE .UNINDENT .UNINDENT .sp برای دیدن فهرستی از تمام زیرگزینه‌های موجود از \-\-idmap=? استفاده کنید. جزئیات کامل در \%.SH "گزینه‌های سیستم‌عامل مهمان (GUEST OS OPTIONS)" .SS \fB\-\-osinfo\fP, \fB\-\-os\-variant\fP .sp \fBنحو:\fP \fB\-\-osinfo\fP [OSNAME|OPT1=VAL1,...] .sp پیکربندی مهمان را برای یک سیستم‌عامل خاص بهینه‌سازی می‌کند. در بیشتر موارد، یک سیستم‌عامل باید مشخص شده یا از طریق رسانهٔ نصب تشخیص داده شود تا ویژگی‌های حیاتی برای کارایی مانند virtio فعال شوند. .sp ساده‌ترین شیوهٔ استفاده \fB\-\-osinfo OSNAME\fP یا \fB\-\-os\-variant OSNAME\fP است، برای نمونه \fB\-\-osinfo fedora32\fP\&. زیرگزینه‌های پشتیبانی‌شده عبارتند از: .INDENT 0.0 .TP .B \fBname=\fP, \fBshort\-id=\fP نام یا شناسهٔ کوتاه (short\-id) سیستم‌عامل از libosinfo. مثال‌ها: \fBfedora32\fP، \fBwin10\fP .TP .B \fBid=\fP شناسهٔ کامل libosinfo به سبک URL. برای نمونه، \fBname=win10\fP همانند \fBid=http://microsoft.com/win/10\fP است. .TP .B \fBdetect=on|off\fP اینکه آیا virt\-install باید برای تشخیص سیستم‌عامل از رسانهٔ نصب مشخص‌شده تلاش کند یا خیر. در حال حاضر تشخیص فقط برای نصب‌های از طریق URL و CDROM انجام می‌شود و ۱۰۰٪ قابل‌اطمینان نیست. .TP .B \fBrequire=on|off\fP اگر \fBon\fP باشد، در صورتی که هیچ مقداری برای سیستم‌عامل تنظیم یا تشخیص داده نشود، virt\-install با خطا متوقف می‌شود. .UNINDENT .sp چند مثال کاربردی: .INDENT 0.0 .TP .B \fB\-\-osinfo detect=on,require=on\fP این به virt\-install می‌گوید که برای تشخیص از رسانهٔ نصب تلاش کند، اما اگر موفق نشد صراحتاً با شکست متوقف شود. این کار تضمین می‌کند که فراخوانی‌های virt\-install شما به یک پیکربندی با کارایی ضعیف عقب‌نشینی نکنند. .TP .B \fB\-\-osinfo detect=on,name=OSNAME\fP تلاش برای تشخیص سیستم‌عامل از رسانهٔ نصب، اما در صورت عدم موفقیت، استفاده از OSNAME به عنوان جایگزین پشتیبان (fallback). .UNINDENT .sp اگر هر مقدار دستی برای \fB\-\-osinfo\fP مشخص شود، حالت پیش‌فرض این است که تمام تنظیمات دیگر خاموش یا تعیین‌نشده باشند. .sp به‌طور پیش‌فرض، virt\-install همیشه \fB\-\-osinfo detect=on\fP را برای رسانه‌های نصب مناسب امتحان می‌کند. اگر هیچ سیستم‌عاملی تشخیص داده نشود، در اغلب موارد متداول با خطا متوقف خواهد شد. این خطای مهلک در سال ۲۰۲۲ افزوده شد. می‌توانید با استفاده از مثال جایگزین بالا یا با غیرفعال کردن گزینهٔ \fBrequire\fP این مشکل را دور بزنید. اگر فقط می‌خواهید هرچه سریع‌تر به رفتار قدیمی غیرمهلک بازگردید، متغیر محیطی VIRTINSTALL_OSINFO_DISABLE_REQUIRE=1 را تنظیم کنید. .sp برای دریافت فهرست گونه‌های پذیرفته‌شدهٔ سیستم‌عامل، از دستور \fBvirt\-install \-\-osinfo list\fP استفاده کنید. برای خروجی‌های بیشتر \fBosinfo\-query os\fP را ببینید. .sp نکته: \fB\-\-osinfo\fP و \fB\-\-os\-variant\fP نام‌های مستعار یکدیگر هستند. \fB\-\-osinfo\fP شیوهٔ نام‌گذاری ترجیحی به سبک جدید است. .SH "گزینه‌های فضای ذخیره‌سازی (STORAGE OPTIONS)" .SS \fB\-\-disk\fP .sp \fBنحو:\fP \fB\-\-disk\fP OPTIONS .sp رسانه‌ای را برای استفاده به عنوان فضای ذخیره‌سازی مهمان، همراه با گزینه‌های گوناگون مشخص می‌کند. قالب کلی یک رشتهٔ دیسک به این صورت است: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-disk opt1=val1,opt2=val2,... .EE .UNINDENT .UNINDENT .sp ساده‌ترین فراخوانی برای ایجاد یک تصویر دیسک جدید ۱۰ گیگابایتی و دستگاه دیسک مرتبط: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-disk size=10 .EE .UNINDENT .UNINDENT .sp دستور virt\-install یک نام مسیر ایجاد می‌کند و آن را در مکان پیش‌فرض تصاویر هایپروایزر قرار می‌دهد. برای مشخص کردن رسانه، دستور می‌تواند به این صورت باشد: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-disk /some/storage/path[,opt1=val1]... .EE .UNINDENT .UNINDENT .sp یا صراحتاً یکی از آرگومان‌های زیر را مشخص کند: .INDENT 0.0 .TP .B \fBpath\fP مسیری به یک رسانهٔ ذخیره‌سازی برای استفاده، خواه موجود باشد یا نه. رسانهٔ موجود می‌تواند یک فایل یا دستگاه بلوکی باشد. .sp مشخص کردن یک مسیر ناموجود به معنی تلاش برای ایجاد فضای ذخیره‌سازی جدید است و نیاز به تعیین مقدار \(aqsize\(aq خواهد داشت. حتی برای میزبان‌های دوردست، virt\-install تلاش می‌کند از APIهای ذخیره‌سازی libvirt برای ایجاد خودکار مسیر داده‌شده استفاده کند. .sp اگر هایپروایزر پشتیبانی کند، \fBpath\fP می‌تواند یک URL شبکه نیز باشد، مانند \% . برای مسیرهای شبکه، هایپروایزر مستقیماً به فضای ذخیره‌سازی دسترسی پیدا می‌کند و هیچ چیزی به صورت محلی بارگیری نمی‌شود. .TP .B \fBpool\fP نام یک pool ذخیره‌سازی موجود در libvirt برای ایجاد فضای ذخیره‌سازی جدید روی آن. نیازمند مشخص کردن مقدار \(aqsize\(aq است. .TP .B \fBvol\fP یک حجم (volume) ذخیره‌سازی موجود در libvirt برای استفاده. این مورد به صورت \(aqpoolname/volname\(aq مشخص می‌شود. .UNINDENT .sp گزینه‌هایی که هنگام ایجاد فضای ذخیره‌سازی اعمال می‌شوند: .INDENT 0.0 .TP .B \fBsize\fP اندازه (به GiB) برای استفاده در صورت ایجاد فضای ذخیره‌سازی جدید .TP .B \fBsparse\fP اینکه آیا از تخصیص کامل فضای ذخیره‌سازی جدید صرف‌نظر شود یا خیر. مقدار آن \(aqyes\(aq یا \(aqno\(aq است. پیش‌فرض \(aqyes\(aq است (تخصیص کامل انجام ندهد)، مگر اینکه توسط نوع فضای ذخیره‌سازی زیربنایی پشتیبانی نشود. .sp زمان اولیه‌ای که صرف تخصیص کامل دیسک مجازی مهمان می‌شود (sparse=no)، معمولاً با زمان سریع‌تر نصب در داخل مهمان جبران خواهد شد. بنابراین استفاده از این گزینه برای تضمین کارایی بالا به طور مداوم و جلوگیری از خطاهای ورودی/خروجی (I/O) در مهمان در صورت پر شدن سامانه پرونده میزبان توصیه می‌شود. .TP .B \fBformat\fP قالب تصویر دیسک. برای حجم‌های فایلی، این مقدار می‌تواند \(aqraw\(aq، \(aqqcow2\(aq، \(aqvmdk\(aq و غیره باشد. انواع قالب‌های ممکن را در \% ببینید. این مقدار اغلب به مقدار \fBdriver_type\fP نیز نگاشت می‌شود. .sp اگر هنگام ایجاد تصاویر فایلی مشخص نشود، پیش‌فرض آن \(aqqcow2\(aq خواهد بود. .sp در صورت ایجاد فضای ذخیره‌سازی، این قالبِ تصویر جدید خواهد بود. اگر از یک تصویر موجود استفاده شود، این گزینه بر تشخیص خودکار قالب توسط libvirt اولویت می‌یابد. .TP .B \fBbacking_store\fP مسیر دیسکی که به عنوان backing store برای تصویر تازه ایجادشده استفاده می‌شود. .TP .B \fBbacking_format\fP قالب تصویر دیسک مربوط به \fBbacking_store\fP .UNINDENT .sp چند مثال از زیرگزینه‌های پیکربندی دستگاه: .INDENT 0.0 .TP .B \fBdevice\fP نوع دستگاه دیسک. مقادیر نمونه عبارتند از \(aqcdrom\(aq، \(aqdisk\(aq، \(aqlun\(aq یا \(aqfloppy\(aq. پیش‌فرض \(aqdisk\(aq است. .TP .B \fBboot.order\fP نصب مهمان با چند دیسک برای بوت شدن صحیح پس از نصب به این پارامتر نیاز خواهد داشت. پارامتر boot.order مقادیر 1,2,3,... را می‌پذیرد. دستگاه‌های با مقدار کمتر اولویت بالاتری دارند. این گزینه برای سایر انواع دستگاه‌های با قابلیت بوت نیز اعمال می‌شود. .TP .B \fBtarget.bus\fP یا \fBbus\fP نوع گذرگاه (bus) دیسک. مقادیر نمونه عبارتند از \(aqide\(aq، \(aqsata\(aq، \(aqscsi\(aq، \(aqusb\(aq، \(aqvirtio\(aq یا \(aqxen\(aq. پیش‌فرض به هایپروایزر بستگی دارد، زیرا همهٔ هایپروایزرها از همهٔ انواع گذرگاه پشتیبانی نمی‌کنند. .TP .B \fBreadonly\fP تنظیم درایو به عنوان فقط‌خواندنی (مقادیر \(aqon\(aq یا \(aqoff\(aq را می‌پذیرد) .TP .B \fBshareable\fP تنظیم درایو به عنوان اشتراک‌گذاری‌پذیر (مقادیر \(aqon\(aq یا \(aqoff\(aq را می‌پذیرد) .TP .B \fBcache\fP حالت حافظهٔ موقت (cache) که باید استفاده شود. pagecache میزبان حافظهٔ موقت را تأمین می‌کند. مقدار cache می‌تواند \(aqnone\(aq، \(aqwritethrough\(aq، \(aqdirectsync\(aq، \(aqunsafe\(aq یا \(aqwriteback\(aq باشد. حالت \(aqwritethrough\(aq کَش‌کردن خواندن را فراهم می‌کند. \(aqwriteback\(aq کَش‌کردن خواندن و نوشتن را فراهم می‌سازد. \(aqdirectsync\(aq حافظهٔ pagecache میزبان را دور می‌زند. \(aqunsafe\(aq ممکن است همهٔ محتوا را کَش کرده و درخواست‌های flush مهمان را نادیده بگیرد..TP .B \fBdriver.discard\fP مشخص می‌کند که آیا درخواست‌های discard (شناخته‌شده با عنوان \(dqtrim\(dq یا \(dqunmap\(dq) نادیده گرفته شوند یا به سیستم‌فایل ارسال گردند. مقدار می‌تواند \(dqunmap\(dq (اجازه به ارسال درخواست discard) یا \(dqignore\(dq (نادیده گرفتن درخواست discard) باشد. از نسخهٔ 1.0.6 به بعد (تنها برای QEMU و KVM). .TP .B \fBdriver.name\fP نام درایوری که هایپروایزر باید هنگام دسترسی به فضای ذخیره‌سازی مشخص‌شده استفاده کند. معمولاً نیازی به تنظیم توسط کاربر ندارد. .TP .B \fBdriver.type\fP قالب/نوع درایوری که هایپروایزر باید هنگام دسترسی به فضای ذخیره‌سازی مشخص‌شده استفاده کند. معمولاً نیازی به تنظیم توسط کاربر ندارد. .TP .B \fBdriver.io\fP بک‌اند ورودی/خروجی (IO) دیسک. می‌تواند یکی از مقادیر \(dqthreads\(dq، \(dqnative\(dq یا \(dqio_uring\(dq باشد. .TP .B \fBdriver.error_policy\fP نحوهٔ واکنش سیستم‌عامل مهمان هنگام مواجهه با خطای نوشتن. می‌تواند یکی از مقادیر \(dqstop\(dq، \(dqignore\(dq یا \(dqenospace\(dq باشد. .TP .B \fBserial\fP شماره سریال دستگاه دیسک شبیه‌سازی‌شده. این مقدار در سیستم‌های مهمان لینوکسی برای تنظیم پیوندهای نمادین /dev/disk/by\-id استفاده می‌شود. یک نمونه شماره سریال می‌تواند این باشد: WD\-WMAP9A966149 .TP .B \fBsource.startupPolicy\fP تعیین می‌کند که در صورت عدم دسترسی به فایل منبع، چه رفتاری با دیسک صورت گیرد. .TP .B \fBsnapshot\fP رفتار پیش‌فرض دیسک را در حین ایجاد اسنپ‌شات‌های دیسک تعیین می‌کند. .UNINDENT .sp برای مشاهدهٔ برخی کاربردها، بخش مثال‌ها را ببینید. این گزینه جایگزین گزینه‌های منسوخ‌شدهٔ \-f/\-\-file، \-s/\-\-file\-size، \-\-nonsparse و \-\-nodisks است. .sp برای دیدن فهرستی از تمامی زیرگزینه‌های در دسترس، از \-\-disk=? استفاده کنید. جزئیات کامل در: \% .SS \fB\-\-filesystem\fP .sp دایرکتوری مشخصی از سیستم میزبان را برای اشتراک‌گذاری در سیستم مهمان معین می‌کند. ساده‌ترین حالت فراخوانی عبارت است از: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-filesystem /source/on/host,/target/point/in/guest .EE .UNINDENT .UNINDENT .sp این حالت برای نسخه‌های اخیر QEMU و سیستم‌عامل‌های مهمان لینوکسی یا کانتینرهای LXC کار خواهد کرد. در QEMU، نقطهٔ هدف صرفاً یک راهنمای اتصال (mount hint) در sysfs است و به‌صورت خودکار متصل (mount) نخواهد شد. .sp چند نمونه از زیرگزینه‌ها: .INDENT 0.0 .TP .B \fBtype\fP نوع دایرکتوری منبع. مقادیر معتبر عبارتند از \(aqmount\(aq (پیش‌فرض) یا \(aqtemplate\(aq برای الگوهای OpenVZ. .TP .B \fBaccessmode\fP یا \fBmode\fP حالت دسترسی به دایرکتوری منبع از سیستم‌عامل مهمان. تنها همراه با QEMU و type=mount استفاده می‌شود. حالت‌های معتبر عبارتند از \(aqmapped\(aq (پیش‌فرض)، \(aqpassthrough\(aq یا \(aqsquash\(aq. برای اطلاعات بیشتر، مستندات libvirt domain XML را ببینید. .TP .B \fBsource\fP دایرکتوری روی میزبان جهت اشتراک‌گذاری. .TP .B \fBtarget\fP محل اتصال (mount) برای استفاده در مهمان. .UNINDENT .sp برای مشاهدهٔ فهرستی از تمامی زیرگزینه‌های در دسترس از \-\-filesystem=? استفاده کنید. جزئیات کامل در \% .SH "گزینه‌های شبکه (NETWORKING OPTIONS)" .SS \fB\-w\fP, \fB\-\-network\fP .sp \fBساختار:\fP \fB\-w\fP, \fB\-\-network\fP OPTIONS .sp اتصال سیستم مهمان به شبکهٔ میزبان. نمونه‌هایی برای مشخص کردن نوع شبکه: .INDENT 0.0 .TP .B \fBbridge=BRIDGE\fP اتصال به یک دستگاه پل (bridge) در میزبان با نام \fBBRIDGE\fP\&. اگر میزبان پیکربندی شبکهٔ ایستا دارد و مهمان به اتصال کامل ورودی و خروجی به/از شبکهٔ محلی (LAN) نیاز دارد، از این گزینه استفاده کنید. همچنین اگر قرار است مهاجرت زنده (live migration) برای این مهمان به کار رود، از این گزینه استفاده کنید. .TP .B \fBnetwork=NAME\fP اتصال به یک شبکهٔ مجازی در میزبان به نام \fBNAME\fP\&. شبکه‌های مجازی را می‌توان با استفاده از ابزار خط فرمان \fBvirsh\fP فهرست، ایجاد یا حذف کرد. در یک نصب پیش‌فرض و تغییرنیافته از \fBlibvirt\fP، معمولاً یک شبکهٔ مجازی با نام \fBdefault\fP وجود دارد. اگر میزبان دارای شبکهٔ پویا است (مانند NetworkManager) یا از شبکهٔ بی‌سیم استفاده می‌کند، از یک شبکهٔ مجازی استفاده نمایید. ترافیک مهمان از طریق هر اتصالی که فعال باشد به شبکهٔ محلی (LAN) اصطلاحاً NAT خواهد شد. .TP .B \fBtype=direct,source=IFACE[,source.mode=MODE]\fP اتصال مستقیم به رابط کاربری میزبان IFACE با استفاده از macvtap. .TP .B \fBuser\fP اتصال به LAN با استفاده از SLIRP. تنها زمانی از این گزینه استفاده کنید که مهمان QEMU را به‌عنوان یک کاربر بدون امتیاز اجرا می‌کنید. این حالت شکل بسیار محدودی از NAT را فراهم می‌کند. .TP .B \fBnone\fP به virt\-install اعلام می‌کند که هیچ رابط شبکهٔ پیش‌فرضی اضافه نکند. .UNINDENT .sp اگر \fB\-\-network\fP نادیده گرفته شود، یک کارت شبکه (NIC) واحد در مهمان ایجاد خواهد شد. اگر دستگاه bridge در میزبان همراه با یک رابط فیزیکی متصل وجود داشته باشد، از آن برای برقراری ارتباط استفاده می‌شود. در غیر این صورت، از شبکهٔ مجازی موسوم به \fBdefault\fP استفاده خواهد شد. این گزینه را می‌توان چندین بار برای پیکربندی بیش از یک کارت شبکه مشخص کرد. .sp چند نمونه از زیرگزینه‌ها: .INDENT 0.0 .TP .B \fBmodel.type\fP یا \fBmodel\fP مدل دستگاه شبکه آن‌طور که توسط سیستم مهمان دیده می‌شود. مقدار می‌تواند هر مدل کارت شبکه‌ای باشد که توسط هایپروایزر پشتیبانی می‌شود، مانند: \(aqe1000\(aq، \(aqrtl8139\(aq، \(aqvirtio\(aq و... .TP .B \fBmac.address\fP یا \fBmac\fP آدرس MAC ثابت برای مهمان؛ در صورتی که این پارامتر نادیده گرفته شود یا مقدار \fBRANDOM\fP تعیین گردد، یک آدرس مناسب به‌صورت تصادفی تولید خواهد شد. در ماشین‌های مجازی Xen الزامی است که ۳ جفت نخست آدرس MAC توالی \(aq00:16:3e\(aq باشد، در حالی که در ماشین‌های مجازی QEMU یا KVM باید \(aq52:54:00\(aq باشد. .TP .B \fBfilterref.filter\fP کنترل فایروال و پالایش شبکه در libvirt. مقدار می‌تواند هر nwfilter تعریف‌شده توسط زیرفرمان‌های \(aqnwfilter\(aq در \fBvirsh\fP باشد. فیلترهای موجود را می‌توان با اجرای دستور \(aqvirsh nwfilter\-list\(aq فهرست کرد، مانند: \(aqclean\-traffic\(aq، \(aqno\-mac\-spoofing\(aq و... .TP .B گزینه‌های \fBvirtualport.*\fP پیکربندی نمایهٔ درگاه مجازی دستگاه (virtual port profile). این گزینه برای پیکربندی‌های 802.Qbg، 802.Qbh، midonet و openvswitch به کار می‌رود. .sp برای مشاهدهٔ فهرستی از تمامی زیرگزینه‌های در دسترس از \-\-network=? استفاده کنید. جزئیات کامل در \% .sp این گزینه جایگزین گزینه‌های منسوخ‌شدهٔ \-m/\-\-mac، \-b/\-\-bridge و \-\-nonetworks است. .TP .B \fBhostdev=HOSTDEV\fP دستگاه nodedev ارجاع‌شده را به‌عنوان منبع برای \fBtype=hostdev\fP استفاده می‌کند، همان‌طور که در اینجا شرح داده شده است: \% .sp برای آگاهی از ساختار \fBHOSTDEV\fP، مستندات \fB\-\-hostdev\fP را ببینید. .TP .B \fBportForward=[ADDRESS:]HOSTPORT[:GUESTPORT][/PROTO]\fP گزینه‌ای ساده‌تر برای مشخص کردن فوروارد پورت (port forwarding) در شبکه‌های \fB\-\-network passt\fP. ساختار آن تقریباً با ساختار \fBpodman run \-p\fP یکسان است. HOSTPORT می‌تواند به‌صورت یک محدوده مانند \fB7000\-8000\fP نمایش داده شود، اما GUESTPORT فقط می‌تواند یک پورت منفرد باشد. اگر GUESTPORT ارائه نشود، پورت‌های میزبان و مهمان یکسان فرض می‌شوند. .sp مثال‌ها: .INDENT 7.0 .INDENT 3.5 .sp .EX \-\-network passt,portForward=8080:80 \e \-\-network passt,portForward0=7000\-8000/udp,portForward1=127.0.0.1:2222:22 \e .EE .UNINDENT .UNINDENT .UNINDENT.SH "گزینه‌های گرافیک (GRAPHICS OPTIONS)" .sp اگر هیچ گزینهٔ گرافیکی مشخص نشده باشد، در صورتی که متغیر محیطی DISPLAY تنظیم شده باشد، \fBvirt\-install\fP تلاش می‌کند گرافیک مناسب را انتخاب کند، در غیر این صورت از \(aq\-\-graphics none\(aq استفاده می‌شود. .SS \fB\-\-graphics\fP .sp \fBنحو:\fP \fB\-\-graphics\fP TYPE,opt1=arg1,opt2=arg2,... .sp پیکربندی نمایش گرافیکی را مشخص می‌کند. این گزینه هیچ سخت‌افزار مجازی‌ای را پیکربندی نمی‌کند، بلکه تنها نحوهٔ دسترسی به نمایشگر گرافیکی مهمان را معین می‌سازد. به طور معمول کاربر نیازی به مشخص کردن این گزینه ندارد؛ virt\-install تلاش می‌کند تا یک پیش‌فرض کارآمد را انتخاب کرده و یک اتصال مناسب برقرار کند. .sp قالب کلی یک رشتهٔ گرافیکی به صورت زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-graphics TYPE,opt1=arg1,opt2=arg2,... .EE .UNINDENT .UNINDENT .sp برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-graphics vnc,password=foobar .EE .UNINDENT .UNINDENT .sp برخی از مقادیر پشتیبانی‌شده برای TYPE: .INDENT 0.0 .TP .B \fBvnc\fP یک کنسول مجازی در مهمان راه‌اندازی کرده و آن را به عنوان یک کارساز VNC در میزبان صادر می‌کند. مگر اینکه پارامتر \fBport\fP نیز ارائه شده باشد، کارساز VNC روی نخستین شمارهٔ درگاه آزاد از 5900 به بالا اجرا خواهد شد. نمایشگر واقعی VNC تخصیص‌یافته را می‌توان با استفاده از دستور \fBvncdisplay\fP در \fBvirsh\fP به دست آورد (یا می‌توان از virt\-viewer(1) استفاده کرد که این جزئیات را برای استفاده مدیریت می‌کند). .TP .B \fBspice\fP کنسول مهمان را با استفاده از پروتکل Spice صادر می‌کند. پروتکل Spice قابلیت‌های پیشرفته‌ای مانند جریان دادهٔ صوتی و دستگاه‌های USB و همچنین عملکرد گرافیکی بهبودیافته را فراهم می‌کند. .sp استفاده از نوع گرافیکی spice به گونه‌ای عمل می‌کند که گویی این آرگومان‌ها داده شده‌اند: .INDENT 7.0 .INDENT 3.5 .sp .EX \-\-video qxl \-\-channel spicevmc .EE .UNINDENT .UNINDENT .TP .B \fBnone\fP هیچ کنسول گرافیکی برای مهمان تخصیص داده نخواهد شد. مهمان‌ها به احتمال زیاد نیاز خواهند داشت که یک کنسول متنی روی نخستین درگاه سریال پیکربندی داشته باشند (این کار می‌تواند از طریق گزینهٔ \-\-extra\-args انجام شود). از دستور \(aqvirsh console NAME\(aq می‌توان برای اتصال به دستگاه سریال استفاده کرد. .UNINDENT .sp برخی از زیرگزینه‌های پشتیبانی‌شده: .INDENT 0.0 .TP .B \fBport\fP درخواست یک شماره درگاه دائمی و با تخصیص ایستا برای کنسول مهمان. این زیرگزینه توسط \(aqvnc\(aq و \(aqspice\(aq استفاده می‌شود. .TP .B \fBtlsPort\fP مشخص کردن tlsPort مربوط به spice. .TP .B \fBwebsocket\fP درخواست یک درگاه WebSocket مربوط به VNC برای کنسول مهمان. .sp اگر \-1 مشخص شود، درگاه WebSocket به صورت خودکار تخصیص می‌یابد. .sp این زیرگزینه توسط \(aqvnc\(aq و \(aqspice\(aq استفاده می‌شود. .TP .B \fBlisten\fP نشانی برای گوش فرا دادن به اتصالات VNC/Spice. مقدار پیش‌فرض معمولاً 127.0.0.1 (تنها localhost) است، اما برخی از ناظران مجازی‌سازی اجازه می‌دهند این مورد به صورت سراسری تغییر کند (برای نمونه، مقدار پیش‌فرض راه‌انداز qemu در /etc/libvirt/qemu.conf قابل تغییر است). برای مجاز کردن دسترسی از ماشین‌های دیگر، از 0.0.0.0 استفاده کنید. .sp از \(aqnone\(aq استفاده کنید تا مشخص شود کارساز نمایش نباید روی هیچ درگاهی گوش فرا دهد. کارساز نمایش تنها به صورت محلی از طریق سوکت یونیکس libvirt در دسترس خواهد بود (برای نمونه، virt\-viewer با \-\-attach). .sp از \(aqsocket\(aq استفاده کنید تا ماشین مجازی روی یک مسیر سوکت یونیکس ایجادشده توسط libvirt در سیستم‌فایل میزبان گوش فرا دهد. .sp این زیرگزینه توسط \(aqvnc\(aq و \(aqspice\(aq استفاده می‌شود. .TP .B \fBpassword\fP درخواست گذرواژه برای کنسول، که در زمان اتصال الزامی است. مراقب باشید، این اطلاعات ممکن است در فایل‌های گزارش virt\-install ثبت شوند، بنابراین از یک گذرواژهٔ مهم استفاده نکنید. این زیرگزینه توسط \(aqvnc\(aq و \(aqspice\(aq استفاده می‌شود. .TP .B \fBgl.enable\fP مشخص می‌کند که آیا از رندرینگ شتاب‌یافتهٔ OpenGL استفاده شود یا خیر. مقدار آن \(aqyes\(aq یا \(aqno\(aq است. این زیرگزینه توسط \(aqspice\(aq استفاده می‌شود. .TP .B \fBgl.rendernode\fP مسیر گره رندر DRM مورد استفاده. این زیرگزینه زمانی به کار می‌رود که \(aqgl\(aq فعال باشد. .UNINDENT .sp برای دیدن فهرستی از تمامی زیرگزینه‌های در دسترس، از \-\-graphics=? استفاده کنید. جزئیات کامل در \% .sp این گزینه گزینه‌های زیر را منسوخ می‌کند: \-\-vnc, \-\-vncport, \-\-vnclisten, \-k/\-\-keymap, \-\-sdl, \-\-nographics.SS \fB\-\-autoconsole\fP .sp \fBنحو:\fP \fB\-\-autoconsole\fP OPTIONS .sp پیکربندی کنسول تعاملی‌ای که virt\-install برای ماشین مجازی اجرا می‌کند. این گزینه اجباری نیست؛ رفتار پیش‌فرض تطبیقی بوده و به نحوه پیکربندی ماشین مجازی بستگی دارد. اما می‌توانید از این گزینه برای تغییر دادن انتخاب پیش‌فرض استفاده کنید. .INDENT 0.0 .TP .B \fB\-\-autoconsole graphical\fP استفاده از virt\-viewer(1) گرافیکی به‌عنوان کنسول تعاملی .TP .B \fB\-\-autoconsole text\fP استفاده از حالت متنی \fBvirsh console\fP به‌عنوان کنسول تعاملی. .TP .B \fB\-\-autoconsole none\fP این گزینه معادل \fB\-\-noautoconsole\fP است .TP .B \fB\-\-noautoconsole\fP عدم تلاش خودکار برای اتصال به کنسول مهمان. معادل \fB\-\-autoconsole none\fP است .UNINDENT .sp توجه داشته باشید در صورت مشخص کردن این گزینه، virt\-install به‌سرعت خارج می‌شود. اگر دستور شما خواستار نصب چندمرحله‌ای باشد، مانند \-\-cdrom یا \-\-location، پس از تکمیل فاز نصب، ماشین مجازی خاموش خواهد شد، صرف‌نظر از اینکه بازراه‌اندازی در ماشین مجازی درخواست شده باشد یا خیر. اگر می‌خواهید ماشین مجازی بازراه‌اندازی شود، virt\-install باید در حال اجرا باقی بماند. می‌توانید از \(aq\-\-wait\(aq برای زنده نگه داشتن virt\-install حتی با مشخص کردن \-\-noautoconsole استفاده کنید. .SH "گزینه‌های مجازی‌سازی (VIRTUALIZATION OPTIONS)" .sp گزینه‌هایی برای لغو و جایگزینی انتخاب‌های پیش‌فرض نوع مجازی‌سازی. .SS \fB\-v\fP, \fB\-\-hvm\fP .sp درخواست استفاده از مجازی‌سازی کامل (full virtualization)، در صورتی که هر دو نوع شبه‌مجازی‌سازی (para) و مجازی‌سازی کامل روی میزبان موجود باشند. این پارامتر ممکن است هنگام اتصال به یک هایپروایزر Xen بر روی ماشینی که فاقد پشتیبانی از مجازی‌سازی سخت‌افزاری است در دسترس نباشد. در صورت اتصال به یک هایپروایزر مبتنی بر QEMU، این پارامتر به‌طور ضمنی اعمال می‌شود. .SS \fB\-p\fP, \fB\-\-paravirt\fP .sp این مهمان باید یک مهمان شبه‌مجازی‌شده (paravirtualized) باشد. اگر میزبان از هر دو نوع شبه‌مجازی‌سازی و مجازی‌سازی کامل پشتیبانی کند و نه این پارامتر و نه \fB\-\-hvm\fP مشخص نشده باشند، این حالت فرض خواهد شد. .SS \fB\-\-container\fP .sp این مهمان باید مهمانی از نوع کانتینر باشد. این گزینه تنها در صورتی لازم است که هایپروایزر از انواع دیگر مهمان نیز پشتیبانی کند (به عنوان مثال، این گزینه رفتار پیش‌فرض برای LXC و OpenVZ است، اما برای جامعیت ارائه شده است). .SS \fB\-\-virt\-type\fP .sp هایپروایزری که نصب بر روی آن انجام می‌شود. گزینه‌های نمونه عبارتند از kvm، qemu، یا xen. گزینه‌های موجود از طریق \(aqvirsh capabilities\(aq در تگ‌های فهرست شده‌اند. .sp این گزینه جایگزین و منسوخ‌کننده گزینه \-\-accelerate است که اکنون رفتار پیش‌فرض محسوب می‌شود. برای نصب یک مهمان QEMU خام (ساده)، از \(aq\-\-virt\-type qemu\(aq استفاده کنید. .SH "گزینه‌های دستگاه (DEVICE OPTIONS)" .sp تمام دستگاه‌ها دارای مجموعه‌ای از گزینه‌های \fBaddress.*\fP برای پیکربندی مشخصات آدرس دستگاه بر روی کنترل‌کننده والد یا گذرگاه (bus) خود هستند. برای جزئیات به \fBhttps://libvirt.org/formatdomain.html#device\-addresses\fP مراجعه کنید. .SS \fB\-\-controller\fP .sp \fBنحو:\fP \fB\-\-controller\fP OPTIONS .sp اتصال یک دستگاه کنترل‌کننده به مهمان. .sp چند نمونه از نحوه فراخوانی: .INDENT 0.0 .TP .B \fB\-\-controller usb2\fP افزودن پیکربندی کامل یک کنترل‌کننده USB2 .TP .B \fB\-\-controller usb3\fP افزودن یک کنترل‌کننده USB3 .TP .B \fB\-\-controller type=usb,model=none\fP غیرفعال کردن کامل USB .TP .B \fB\-\-controller type=scsi,model=virtio\-scsi\fP افزودن یک کنترل‌کننده VirtIO SCSI .TP .B \fB\-\-controller num_pcie_root_ports=NUM\fP کنترل تعداد دستگاه‌های کنترل‌کننده پیش‌فرض \fBpcie\-root\-port\fP که به‌طور پیش‌فرض به ماشین مجازی جدید افزوده می‌شوند، در صورتی که ماشین مجازی به‌طور پیش‌فرض از PCIe استفاده کند. .UNINDENT .sp از \-\-controller=? برای مشاهده فهرستی از تمام زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \%.SS \fB\-\-input\fP .sp \fBساختار:\fP \fB\-\-input\fP OPTIONS .sp یک دستگاه ورودی را به سیستم‌مهمان متصل می‌کند. نمونه انواع دستگاه‌های ورودی mouse، tablet یا keyboard هستند. .sp از \-\-input=? برای دیدن فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-hostdev\fP, \fB\-\-host\-device\fP .sp \fBساختار:\fP \fB\-\-hostdev\fP, \fB\-\-host\-device\fP OPTIONS .sp یک دستگاه فیزیکی میزبان را به سیستم‌مهمان متصل می‌کند. چند نمونه مقدار برای HOSTDEV: .INDENT 0.0 .TP .B \fB\-\-hostdev pci_0000_00_1b_0\fP نام دستگاه گره از طریق libvirt، همان‌طور که توسط \(aqvirsh nodedev\-list\(aq نمایش داده می‌شود .TP .B \fB\-\-hostdev 001.003\fP دستگاه USB بر اساس گذرگاه (bus) و دستگاه (device) (از طریق lsusb). .TP .B \fB\-\-hostdev 0x1234:0x5678\fP دستگاه USB بر اساس سازنده (vendor) و شناسه محصول (product) (از طریق lsusb). .TP .B \fB\-\-hostdev 1f.01.02\fP دستگاه PCI (از طریق lspci). .TP .B \fB\-\-hostdev wlan0,type=net\fP دستگاه شبکه (در کانتینر LXC). .TP .B \fB\-\-hostdev /dev/net/tun,type=misc\fP دستگاه نویسه‌ای (در کانتینر LXC). .TP .B \fB\-\-hostdev /dev/sdf,type=storage\fP دستگاه بلوکی (در کانتینر LXC). .UNINDENT .sp از \-\-hostdev=? برای دیدن فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-sound\fP .sp \fBساختار:\fP \fB\-\-sound\fP MODEL .sp یک دستگاه صوتی مجازی را به سیستم‌مهمان متصل می‌کند. MODEL مدل کارت صدای شبیه‌سازی‌شده را مشخص می‌کند. مقادیر ممکن ich6، ich9، ac97، es1370، sb16، pcspk یا default هستند. مقدار \(aqdefault\(aq تلاش می‌کند بهترین مدلی را که سیستم‌عامل مشخص‌شده پشتیبانی می‌کند انتخاب نماید. .sp این گزینه جایگزین گزینه قدیمی \-\-soundhw شده و آن را منسوخ می‌کند. از \-\-sound=? برای دیدن فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-audio\fP .sp پیکربندی خروجی صوتی میزبان برای سخت‌افزار \fI\-\-sound\fP در سیستم‌مهمان. .sp از \-\-audio=? برای دیدن فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \% .SS \fB\-\-watchdog\fP .sp \fBساختار:\fP \fB\-\-watchdog\fP MODEL[,action=ACTION] .sp یک دستگاه سخت‌افزاری watchdog (تایمر نگهبان) مجازی را به سیستم‌مهمان متصل می‌کند. این قابلیت به یک دیمن و راه‌انداز دستگاه درون سیستم‌مهمان نیاز دارد. زمانی که به نظر برسد ماشین مجازی متوقف یا قفل شده است، watchdog سیگنالی ارسال می‌کند. ACTION مشخص می‌کند که libvirt هنگام فعال شدن watchdog چه واکنشی نشان دهد. مقادیر عبارتند از: .INDENT 0.0 .TP .B \fBreset\fP راه‌اندازی مجدد اجباری سیستم‌مهمان (پیش‌فرض) .TP .B \fBpoweroff\fP خاموش کردن اجباری سیستم‌مهمان .TP .B \fBpause\fP مکث در اجرای سیستم‌مهمان .TP .B \fBnone\fP هیچ کاری انجام نده .TP .B \fBshutdown\fP خاموش کردن عادی سیستم‌مهمان (توصیه نمی‌شود، زیرا یک سیستم‌مهمانِ قفل‌شده احتمالاً به درخواست خاموش شدن عادی پاسخ نخواهد داد) .UNINDENT .sp پارامتر MODEL مدل دستگاه شبیه‌سازی‌شده است: i6300esb (پیش‌فرض) یا ib700. چند نمونه: .INDENT 0.0 .TP .B \fB\-\-watchdog default\fP استفاده از تنظیمات توصیه‌شده .TP .B \fB\-\-watchdog i6300esb,action=poweroff\fP استفاده از i6300esb با اقدام \(aqpoweroff\(aq .UNINDENT .sp از \-\-watchdog=? برای دیدن فهرست همه زیرگزینه‌های موجود استفاده کنید. جزئیات کامل در \%.SS \fB\-\-serial\fP .sp \fBنحو:\fP \fB\-\-serial\fP OPTIONS .sp یک دستگاه سریال را با گزینه‌های گوناگون جهت اتصال به ماشین مهمان مشخص می‌کند. قالب کلی یک رشته سریال به صورت زیر است: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-serial type,opt1=val1,opt2=val2,... .EE .UNINDENT .UNINDENT .sp دستگاه‌های \-\-serial و \-\-parallel همگی دارای گزینه‌های یکسانی هستند، مگر اینکه خلاف آن قید شده باشد. برخی از انواع بازهدایت دستگاه نویسه‌ای (character device) عبارتند از: .INDENT 0.0 .TP .B \fB\-\-serial pty\fP ترمینال مجازی (Pseudo TTY). شناسه pty اختصاص‌یافته در توضیحات XML مهمانِ در حال اجرا فهرست خواهد شد. .TP .B \fB\-\-serial dev,path=HOSTPATH\fP دستگاه میزبان. برای دستگاه‌های سریال، این مقدار می‌تواند /dev/ttyS0 باشد. برای دستگاه‌های موازی، می‌تواند /dev/parport0 باشد. .TP .B \fB\-\-serial file,path=FILENAME\fP نوشتن خروجی در FILENAME. .TP .B \fB\-\-serial tcp,host=HOST:PORT,source.mode=MODE,protocol.type=PROTOCOL\fP کنسول شبکه TCP. مقدار MODE می‌تواند \(aqbind\(aq (انتظار برای اتصالات روی HOST:PORT) یا \(aqconnect\(aq (ارسال خروجی به HOST:PORT) باشد، حالت پیش‌فرض \(aqbind\(aq است. مقدار پیش‌فرض HOST برابر با \(aq127.0.0.1\(aq است، اما تعیین PORT الزامی است. مقدار PROTOCOL می‌تواند \(aqraw\(aq یا \(aqtelnet\(aq باشد (پیش‌فرض \(aqraw\(aq). در صورت استفاده از \(aqtelnet\(aq، درگاه مانند یک کارگزار یا کلاینت telnet رفتار می‌کند. چند مثال: .sp انتظار برای اتصال روی هر نشانی، درگاه 4567: .sp \-\-serial tcp,host=0.0.0.0:4567 .sp اتصال به localhost، درگاه 1234: .sp \-\-serial tcp,host=:1234,source.mode=connect .sp انتظار برای اتصال telnet روی localhost، درگاه 2222. کاربر می‌تواند سپس با اجرای دستور \(aqtelnet localhost 2222\(aq به صورت تعاملی به این کنسول متصل شود: .sp \-\-serial tcp,host=:2222,source.mode=bind,source.protocol=telnet .TP .B \fB\-\-serial udp,host=CONNECT_HOST:PORT,bind_host=BIND_HOST:BIND_PORT\fP کنسول شبکه UDP. مقدار HOST:PORT مقصدی است که خروجی به آن فرستاده می‌شود (پیش‌فرض HOST برابر با \(aq127.0.0.1\(aq است، PORT الزامی است). مقدار BIND_HOST:BIND_PORT نشانی محلی اختیاری برای مقید شدن (bind) است (پیش‌فرض BIND_HOST برابر با 127.0.0.1 است، اما تنها زمانی تنظیم می‌شود که BIND_PORT مشخص شده باشد). چند مثال: .sp ارسال خروجی به درگاه پیش‌فرض syslog (ممکن است نیاز به ویرایش متناسب فایل /etc/rsyslog.conf باشد): .sp \-\-serial udp,host=:514 .sp ارسال خروجی به میزبان راه دور 192.168.10.20، درگاه 4444 (این خروجی را می‌توان در میزبان راه دور با استفاده از دستور \(aqnc \-u \-l 4444\(aq خواند): .sp \-\-serial udp,host=192.168.10.20:4444 .TP .B \fB\-\-serial unix,path=UNIXPATH,mode=MODE\fP سوکت یونیکس، unix(7) را ببینید. گزینه MODE رفتار و پیش‌فرض‌های مشابهی با \-\-serial tcp,mode=MODE دارد. .UNINDENT .sp از \-\-serial=? برای مشاهده فهرستی از تمام زیرگزینه‌های در دسترس استفاده کنید. جزئیات کامل در: \% .SS \fB\-\-parallel\fP .sp \fBنحو:\fP \fB\-\-parallel\fP OPTIONS .sp یک دستگاه موازی (parallel) را مشخص می‌کند. قالب و گزینه‌ها تا حد زیادی با \fBserial\fP یکسان هستند. .sp از \-\-parallel=? برای مشاهده فهرستی از تمام زیرگزینه‌های در دسترس استفاده کنید. جزئیات کامل در: \%.SS \fB\-\-channel\fP .sp دستگاه کانال ارتباطی را برای اتصال ماشین میهمان و میزبان مشخص می‌کند. این گزینه از گزینه‌های مشابه \-\-serial و \-\-parallel برای مشخص کردن انتهای میزبان/منبع (host/source) کانال استفاده می‌کند. گزینه‌های اضافی \(aqtarget\(aq برای مشخص کردن نحوه دیده‌شدن کانال توسط ماشین میهمان به کار می‌روند. .sp برخی از انواع تغییر مسیر دستگاه نویسه‌ای عبارتند از: .INDENT 0.0 .TP .B \fB\-\-channel SOURCE,target.type=guestfwd,target.address=HOST:PORT\fP کانال ارتباطی با استفاده از پشته شبکه حالت کاربر QEMU. میهمان می‌تواند با استفاده از ترکیب مشخص‌شده HOST:PORT به کانال متصل شود. .TP .B \fB\-\-channel SOURCE,target.type=virtio[,target.name=NAME]\fP کانال ارتباطی با استفاده از سریال virtio (نیازمند نسخه 2.6.34 یا بالاتر در میزبان و میهمان). هر نمونه از یک خط virtio \-\-channel در میهمان به صورت /dev/vport0p1، /dev/vport0p2 و غیره در دسترس قرار می‌گیرد. NAME فراداده‌ای اختیاری است و می‌تواند هر رشته‌ای باشد، مانند org.linux\-kvm.virtioport1. در صورت تعیین، در میهمان در مسیر /sys/class/virtio\-ports/vport0p1/NAME در دسترس خواهد بود. .TP .B \fB\-\-channel spicevmc,target.type=virtio[,target.name=NAME]\fP کانال ارتباطی برای عامل spice در QEMU، با استفاده از سریال virtio (نیازمند نسخه 2.6.34 یا بالاتر در میزبان و میهمان). NAME فراداده‌ای اختیاری است و می‌تواند هر رشته‌ای باشد، مانند مقدار پیش‌فرض com.redhat.spice.0 که نحوه دیده‌شدن کانال توسط میهمان را مشخص می‌کند. .TP .B \fB\-\-channel qemu\-vdagent,target.type=virtio[,target.name=NAME]\fP کانال ارتباطی برای عامل vd در QEMU، با استفاده از سریال virtio (نیازمند نسخه 2.6.34 یا بالاتر در میزبان و میهمان). این قابلیت کپی/پیست را با میهمانان VNC امکان‌پذیر می‌کند. توجه داشته باشید که یکپارچه‌سازی تخته‌گیره (clipboard) میهمان از طریق spice\-vdagent پیاده‌سازی شده است که حتی زمانی که میهمان از گرافیک spice استفاده نمی‌کند نیز باید در حال اجرا باشد. NAME فراداده‌ای اختیاری است که نحوه دیده‌شدن کانال توسط میهمان را مشخص می‌کند، و باید روی مقدار پیش‌فرض com.redhat.spice.0 باقی بماند مگر اینکه بدانید چه می‌کنید. .UNINDENT .sp برای دیدن فهرستی از تمام زیرگزینه‌های موجود از \-\-channel=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-console\fP .sp یک کنسول متنی را بین میهمان و میزبان متصل می‌کند. ترکیب‌های خاصی از میهمان و ناظر ماشین مجازی (hypervisor) می‌توانند به طور خودکار یک getty را در میهمان تنظیم کنند، به طوری که ورود متنی بدون نیاز به پیکربندی اولیه فراهم شود (target_type=xen برای میهمانان شبه‌مجازی‌سازی xen، و احتمالاً target_type=virtio در آینده). .sp مثال: .INDENT 0.0 .TP .B \fB\-\-console pty,target.type=virtio\fP اتصال یک کنسول virtio به میهمان که به یک PTY روی میزبان تغییر مسیر داده می‌شود. برای میهمانان پشتیبانی‌شده، این مورد /dev/hvc0 را در میهمان در دسترس قرار می‌دهد. برای اطلاعات بیشتر \% را ببینید. کنسول virtio نیازمند libvirt نسخه 0.8.3 یا بالاتر است. .UNINDENT .sp برای دیدن فهرستی از تمام زیرگزینه‌های موجود از \-\-console=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-video\fP .sp \fBنحو:\fP \fB\-\-video\fP OPTIONS .sp مشخص می‌کند کدام مدل دستگاه ویدیو به میهمان متصل خواهد شد. مقادیر معتبر برای VIDEO وابسته به هایپروایزر است، اما برخی گزینه‌ها برای kvmهای اخیر عبارتند از cirrus، vga، qxl، virtio، یا vmvga (vmware). برای دیدن فهرستی از تمام زیرگزینه‌های موجود از \-\-video=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-smartcard\fP .sp \fBنحو:\fP \fB\-\-smartcard\fP MODE[,OPTIONS] .sp پیکربندی یک دستگاه کارت هوشمند (smartcard) مجازی. .sp نمونه مقادیر MODE عبارتند از \fBhost\fP، \fBhost\-certificates\fP، یا \fBpassthrough\fP\&. زیرگزینه‌های نمونه عبارتند از: .INDENT 0.0 .TP .B \fBtype\fP نوع دستگاه نویسه‌ای برای اتصال روی میزبان. این گزینه فقط برای حالت \fBpassthrough\fP کاربرد دارد. .UNINDENT .sp یک نمونه فراخوانی: .INDENT 0.0 .TP .B \fB\-\-smartcard passthrough,type=spicevmc\fP استفاده از کانال smartcard یک دستگاه گرافیکی SPICE برای انتقال اطلاعات کارت هوشمند به میهمان .UNINDENT .sp برای دیدن فهرستی از تمام زیرگزینه‌های موجود از \-\-smartcard=? استفاده کنید. جزئیات کامل در \%.SS \fB\-\-redirdev\fP .sp \fBنحو:\fP \fB\-\-redirdev\fP BUS[,OPTIONS] .sp افزودن یک دستگاه تغییرمسیریافته (redirected). نمونه‌هایی از گزینه‌های فرعی: .INDENT 0.0 .TP .B \fBtype\fP نوع تغییرمسیر؛ مقادیر پشتیبانی‌شده در حال حاضر شامل \fBtcp\fP یا \fBspicevmc\fP هستند. .TP .B \fBserver\fP جزئیات اتصال سرور TCP، در قالب \(aqserver:port\(aq. .UNINDENT .sp نمونه‌های فراخوانی: .INDENT 0.0 .TP .B \fB\-\-redirdev usb,type=tcp,server=localhost:4000\fP افزودن یک دستگاه USB تغییرمسیریافته که توسط سرور TCP روی \(aqlocalhost\(aq در درگاه ۴۰۰۰ ارائه می‌شود. .TP .B \fB\-\-redirdev usb,type=spicevmc\fP افزودن یک دستگاه USB تغییرمسیریافته از طریق کانال اختصاصی Spice. .UNINDENT .sp برای مشاهده فهرستی از همه گزینه‌های فرعی موجود، از \-\-redirdev=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-memballoon\fP .sp \fBنحو:\fP \fB\-\-memballoon\fP MODEL[,OPTIONS] .sp اتصال یک دستگاه بالون حافظه (memballoon) مجازی به سیستم‌عامل مهمان. اگر نیاز است دستگاه memballoon به‌طور صریح غیرفعال شود، از MODEL=\(aqnone\(aq استفاده می‌شود. .sp آرگومان MODEL نوع دستگاه memballoon ارائه‌شده است. این مقدار می‌تواند \(aqvirtio\(aq، \(aqxen\(aq یا \(aqnone\(aq باشد. چند مثال: .INDENT 0.0 .TP .B \fB\-\-memballoon virtio\fP ایجاد صریح یک دستگاه memballoon از نوع \(aqvirtio\(aq .TP .B \fB\-\-memballoon none\fP غیرفعال کردن دستگاه memballoon .UNINDENT .sp برای مشاهده فهرستی از همه گزینه‌های فرعی موجود، از \-\-memballoon=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-tpm\fP .sp \fBنحو:\fP \fB\-\-tpm\fP TYPE[,OPTIONS] .sp پیکربندی یک دستگاه TPM مجازی. مثال‌ها: .INDENT 0.0 .TP .B \fB\-\-tpm /dev/tpm\fP گزینه‌ای آسان برای ارسال مستقیم (passthrough) دستگاه TPM میزبان. .TP .B \fB\-\-tpm emulator\fP درخواست یک دستگاه TPM شبیه‌سازی‌شده (emulated). .TP .B \fB\-\-tpm default\fP درخواست از virt\-install برای اعمال یک مقدار پیش‌فرض نوین و توصیه‌شده. .TP .B \fB\-\-tpm none\fP درخواست از virt\-install برای غیرفعال کردن دستگاه TPM. .UNINDENT .sp برای مشاهده فهرستی از همه گزینه‌های فرعی موجود، از \-\-tpm=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-rng\fP .sp \fBنحو:\fP \fB\-\-rng\fP TYPE[,OPTIONS] .sp پیکربندی یک دستگاه مجازی تولید اعداد تصادفی (RNG). .sp نمونه‌هایی از مقادیر TYPE شامل \fBrandom\fP، \fBegd\fP یا \fBbuiltin\fP\& است. .sp نمونه‌های فراخوانی: .INDENT 0.0 .TP .B \fB\-\-rng /dev/urandom\fP استفاده از دستگاه /dev/urandom برای دریافت داده‌های آنتروپی؛ این حالت به‌طور ضمنی از مدل \(dqrandom\(dq استفاده می‌کند. .TP .B \fB\-\-rng builtin\fP استفاده از دستگاه RNG داخلی (builtin) برای دریافت داده‌های آنتروپی. .TP .B \fB\-\-rng egd,backend.source.host=localhost,backend.source.service=8000,backend.type=tcp\fP اتصال به localhost در درگاه TCP شماره ۸۰۰۰ برای دریافت داده‌های آنتروپی. .UNINDENT .sp برای مشاهده فهرستی از همه گزینه‌های فرعی موجود، از \-\-rng=? استفاده کنید. جزئیات کامل در \%.SS \fB\-\-panic\fP .sp \fBشیوه نگارش:\fP \fB\-\-panic\fP MODEL[,OPTS] .sp متصل کردن یک دستگاه اعلان وحشت (panic notifier) به مهمان. برای تنظیمات توصیه‌شده، استفاده کنید از: \fB\-\-panic default\fP .sp برای دیدن فهرستی از تمام زیرگزینه‌های در دسترس، از \-\-panic=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-shmem\fP .sp \fBشیوه نگارش:\fP \fB\-\-shmem\fP NAME[,OPTS] .sp متصل کردن یک دستگاه حافظه مشترک به مهمان. نام نباید شامل \fB/\fP باشد و نباید مختص به دایرکتوری‌های \fB\&.\fP یا \fB\&..\fP باشد. .sp برای دیدن فهرستی از تمام زیرگزینه‌های در دسترس، از \-\-shmem=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-memdev\fP .sp \fBشیوه نگارش:\fP \fB\-\-memdev\fP OPTS .sp افزودن یک ماژول حافظه به مهمان با امکان جداسازی در حالت فعال (hotunplug). برای افزودن یک memdev لازم است hotplugmemory و NUMA را برای مهمان پیکربندی کنید. .sp برای دیدن فهرستی از تمام زیرگزینه‌های در دسترس، از \-\-memdev=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-vsock\fP .sp \fBشیوه نگارش:\fP \fB\-\-vsock\fP OPTS .sp پیکربندی یک رابط vsock میزبان/مهمان. یک پیکربندی معمول چنین است: .INDENT 0.0 .INDENT 3.5 .sp .EX \-\-vsock cid.auto=yes .EE .UNINDENT .UNINDENT .sp برای دیدن فهرستی از تمام زیرگزینه‌های در دسترس، از \-\-vsock=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-iommu\fP .sp \fBشیوه نگارش:\fP \fB\-\-iommu\fP MODEL[,OPTS] .sp افزودن یک دستگاه IOMMU به مهمان. .sp برای دیدن فهرستی از تمام گزینه‌های در دسترس، از \-\-iommu=? استفاده کنید. جزئیات کامل در \% .SS \fB\-\-pstore\fP .sp \fBشیوه نگارش:\fP \fB\-\-pstore\fP OPT=VAL,[...] .sp افزودن یک دستگاه pstore به مهمان جهت ذخیره لاگ‌های oops/panic پیش از فروپاشی (crash). .sp برای دیدن فهرستی از تمام گزینه‌های در دسترس، از \-\-pstore=? استفاده کنید. جزئیات کامل در \% .SH "گزینه‌های گوناگون (MISCELLANEOUS OPTIONS)" .SS \fB\-h\fP, \fB\-\-help\fP .sp نمایش پیام راهنما و خروج .SS \fB\-\-version\fP .sp نمایش شماره نسخه برنامه و خروج .SS \fB\-\-autostart\fP .sp تنظیم پرچم شروع خودکار (autostart) برای یک دامنه. این کار باعث می‌شود دامنه هنگام راه‌اندازی (boot) سیستم میزبان اجرا شود. .SS \fB\-\-transient\fP .sp اگر خواهان یک ماشین مجازی (VM) گذرای libvirt هستید، از \-\-import یا \-\-boot و \-\-transient استفاده کنید. این ماشین‌های مجازی فقط تا زمانی وجود دارند که دامنه خاموش شود یا سرور میزبان بازراه‌اندازی گردد. libvirt پس از هر یک از این رویدادها، پیکربندی XML ماشین مجازی را فراموش می‌کند. توجه داشته باشید که دیسک‌های ماشین مجازی حذف نخواهند شد. ببینید: \% .SS \fB\-\-destroy\-on\-exit\fP .sp هنگامی که از پنجره کنسول ماشین مجازی خارج شوید، ماشین مجازی تخریب (خاموش‌کردن اجباری) می‌شود. اگر این گزینه را با \-\-transient ترکیب کنید، باعث می‌شود دستور virt\-install عملکردی مشابه qemu داشته باشد، جایی که با بسته شدن پنجره کنسول توسط کاربر، ماشین مجازی خاموش می‌شود..SS \fB\-\-print\-xml\fP .sp \fBقالب دستوری:\fP \fB\-\-print\-xml\fP [STEP] .sp چاپ XML تولیدشده برای ماشین مهمان، به جای تعریف کردن آن. به‌طور پیش‌فرض این گزینه ساخت فضای ذخیره‌سازی را انجام خواهد داد (می‌توان با \-\-dry\-run آن را غیرفعال کرد). این گزینه مستلزم \-\-quiet است. .sp اگر فرایند نصب ماشین مجازی چند مرحله‌ای باشد، به‌طور پیش‌فرض تمام XMLهای تولیدشده چاپ خواهند شد. اگر می‌خواهید یک مرحلهٔ خاص چاپ شود، از \-\-print\-xml 2 (برای XML مرحلهٔ دوم) استفاده کنید. .SS \fB\-\-noreboot\fP .sp جلوگیری از راه‌اندازی مجدد خودکار دامنه (domain) پس از اتمام فرایند نصب. .SS \fB\-\-wait\fP .sp \fBقالب دستوری:\fP \fB\-\-wait\fP WAIT .sp پیکربندی نحوهٔ انتظار virt\-install برای تکمیل فرایند نصب. بدون این گزینه، virt\-install منتظر بسته شدن کنسول می‌ماند (که لزوماً نشان‌دهندهٔ خاموش شدن ماشین مهمان نیست)، یا در صورت استفاده از \-\-noautoconsole، صرفاً نصب را آغاز کرده و خارج می‌شود. .sp استفاده از \(aq\-\-wait\(aq به‌تنهایی یا هر مقدار منفی باعث می‌شود virt\-install به‌صورت نامحدود منتظر بماند. هر عدد مثبت نشان‌دهندهٔ تعداد دقیقه‌هایی است که virt\-install منتظر خواهد ماند. در صورت پایان مهلت زمانی، virt\-install صرفاً خارج شده و ماشین مجازی را در وضعیت فعلی خود رها می‌کند. .SS \fB\-\-dry\-run\fP .sp مراحل ساخت ماشین مهمان را به پیش می‌برد، اما هیچ دستگاه ذخیره‌سازی ایجاد نمی‌کند، پیکربندی دستگاه‌های میزبان را تغییر نمی‌دهد و مهمان را واقعاً به libvirt معرفی نمی‌کند. virt\-install ممکن است همچنان رسانهٔ نصب را دریافت کند، چرا که این کار برای تشخیص صحیح سیستم‌عامل جهت نصب الزامی است. .SS \fB\-\-check\fP .sp فعال یا غیرفعال کردن برخی بررسی‌های اعتبارسنجی. به عنوان نمونه می‌توان به هشدار دربارهٔ استفاده از دیسکی که پیش‌تر به ماشین مجازی دیگری اختصاص یافته است (\-\-check path_in_use=on|off)، یا هشدار دربارهٔ احتمال اتمام فضا در حین تخصیص دیسک (\-\-check disk_size=on|off) اشاره کرد. بیشتر بررسی‌ها به‌طور پیش‌فرض انجام می‌شوند. .SS \fB\-q\fP, \fB\-\-quiet\fP .sp فقط پیام‌های خطای مهلک را چاپ می‌کند. .SS \fB\-d\fP, \fB\-\-debug\fP .sp چاپ اطلاعات اشکال‌زدایی در ترمینال هنگام اجرای فرایند نصب. اطلاعات اشکال‌زدایی حتی در صورت حذف این پارامتر نیز در \fB~/.cache/virt\-manager/virt\-install.log\fP ذخیره می‌شوند. .SH "مثال‌ها (EXAMPLES)" .sp ساده‌ترین فراخوانی برای نصب تعاملی یک ماشین مجازی Fedora 29 KVM با مقادیر پیش‌فرض توصیه‌شده. برنامهٔ virt\-viewer(1) برای تعامل گرافیکی با فرایند نصب ماشین مجازی اجرا خواهد شد .INDENT 0.0 .INDENT 3.5 .sp .EX # sudo virt\-install \-\-install fedora29 .EE .UNINDENT .UNINDENT .sp مشابه نمونهٔ قبل، اما با استفاده از قابلیت نصب خودکار در libosinfo، که نصب fedora29 را به‌صورت خودکار و بدون دخالت کاربر انجام می‌دهد: .INDENT 0.0 .INDENT 3.5 .sp .EX # sudo virt\-install \-\-install fedora29 \-\-unattended .EE .UNINDENT .UNINDENT .sp نصب یک ماشین مجازی Windows 10 با استفاده از ۴۰ گیبی‌بایت فضای ذخیره‌سازی در مکان پیش‌فرض و ۴۰۹۶ مبی‌بایت رم، و اطمینان از اتصال به نمونهٔ سیستمی libvirtd: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-install \e \-\-connect qemu:///system \e \-\-name my\-win10\-vm \e \-\-memory 4096 \e \-\-disk size=40 \e \-\-osinfo win10 \e \-\-cdrom /path/to/my/win10.iso .EE .UNINDENT .UNINDENT .sp نصب یک ماشین KVM با CentOS 7 از یک URL، با پیش‌فرض‌های توصیه‌شدهٔ دستگاه‌ها و فضای ذخیره‌سازی پیش‌فرض مورد نیاز، اما با درخواست صریح گرافیک VNC به جای SPICE پیش‌فرض، و ۸ پردازندهٔ مجازی و ۸۱۹۲ مبی‌بایت حافظه: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-install \e \-\-connect qemu:///system \e \-\-memory 8192 \e \-\-vcpus 8 \e \-\-graphics vnc \e \-\-osinfo centos7.0 \e \-\-location http://mirror.centos.org/centos\-7/7/os/x86_64 .EE .UNINDENT .UNINDENT .sp ساخت یک ماشین مجازی بر پایهٔ یک ایمیج دیسک debian9 موجود: .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-install \e \-\-import \e \-\-memory 512 \e \-\-disk /home/user/VMs/my\-debian9.img \e \-\-osinfo debian9 .EE .UNINDENT .UNINDENT .sp راه‌اندازی یک ماشین مجازی سریال QEMU ARM که نیازمند تعیین دستی هسته (کرنل) است. .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-install \e \-\-name armtest \e \-\-memory 1024 \e \-\-arch armv7l \-\-machine vexpress\-a9 \e \-\-disk /home/user/VMs/myarmdisk.img \e \-\-boot kernel=/tmp/my\-arm\-kernel,initrd=/tmp/my\-arm\-initrd,dtb=/tmp/my\-arm\-dtb,kernel_args=\(dqconsole=ttyAMA0 rw root=/dev/mmcblk0p3\(dq \e \-\-graphics none .EE .UNINDENT .UNINDENT .sp راه‌اندازی یک ماشین مجازی با امنیت راه‌اندازی SEV با ۴ گیگابایت RAM، ۴ گیگابایت + ۲۵۶ مبی‌بایت برای hard_limit، همراه با چند دستگاه virtio: .sp نکته: پرچم IOMMU باید با driver.iommu برای دستگاه‌های virtio فعال شود. استفاده از \-\-memtune در حال حاضر به دلیل محدودیت‌های SEV الزامی است؛ برای توضیحات دقیق به مستندات libvirt مراجعه کنید. .INDENT 0.0 .INDENT 3.5 .sp .EX # virt\-install \e \-\-name foo \e \-\-memory 4096 \e \-\-boot uefi \e \-\-machine q35 \e \-\-memtune hard_limit=4563402 \e \-\-disk size=15,target.bus=scsi \e \-\-import \e \-\-controller type=scsi,model=virtio\-scsi,driver.iommu=on \e \-\-controller type=virtio\-serial,driver.iommu=on \e \-\-network network=default,model=virtio,driver.iommu=on \e \-\-rng /dev/random,driver.iommu=on \e \-\-memballoon driver.iommu=on \e \-\-launchSecurity sev .EE .UNINDENT .UNINDENT.SH "گزارش باگ‌ها (BUGS)" .sp لطفاً به \% مراجعه کنید. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .sp حق نشر (C) متعلق به Red Hat, Inc و مشارکت‌کنندگان مختلف است. این یک نرم‌افزار آزاد است. شما می‌توانید رونوشت‌های آن را تحت شرایط GNU General Public License \%\& بازتوزیع کنید. تا حدی که قانون اجازه می‌دهد، هیچ ضمانتی وجود ندارد. .SH "همچنین ببینید (SEE ALSO)" .sp \fBvirsh(1)\fP، \fBvirt\-clone(1)\fP، \fBvirt\-manager(1)\fP، وب‌سایت پروژه \% .\" End of generated man page.