Доки, маны, напоминалки

virt-install man по русски

Posted on Январь 10, 2011

virt-install(1).

Приведен вольный перевод man страницы virt-install. Virt-install это консольная утилита входящая в состав пакета Virtinst и предназначена для создания виртуальных машин.

Virt-install – инструмент командной строки для создания виртуальных машин посредством libvirt (библиотека реализующая управление гипервизором). Утилита может работать как в текстовом так и в графическиом режимах, используя консоль, SDL или VNC. Гостевое окружение может быть сконфигурировано с одним и более виртуальным диском и сетевым интерфейсом находящихся непосредственно на хост-системе. Образы для установки (иначе говоря дистрибутивы) могут находиться как локально, так и удаленно – на NFS-, HTTP- или FTP-серверах. Во втором случае virt-install сам скачает необходимые для минимальной установки файлы и затем для завершения установки, позволит гостевой системе самой скачать необходимые данные. Virt-install получив необходимые аргументы, полностью создает гостевое окружение, что позволяет легко автоматизировать установку виртуальных машин. Идущий в комплекте virt-clone позволяет клонировать существующие окружения, не прибегая к повторному процессу установки или же если установка не может быть автоматизирована. Опции. некоторые опции могут быть опущены, если же virt-install запущен в интерактивном режиме, при необходимости он запросит ввести данные.
Отступлю от официального текста man, добавлю ясности, при помощи связки libvirt+virtinst можно независимо от типа гипервизора (Xen, Qemu/KVM) с помощью одной утилиты создавать виртуальные окружения.

Общий синтаксис команды имеет следущий вид:

virt-clone [ OPTION ]…

Описание параметров.

-h, ––help – Показать справку и выйти.

-n NAME , ––name=NAME – Имя для создаваемой машины. Должно быть уникальным.

-r MEMORY , ––ram=MEMORY – Память (в мегабайтах) выделяемая для машины.

-u UUID , ––uuid=UUID – Уникальный идентификатор гостя. если не указан то генерируется автоматически.

––vcpus=VCPUS – Количество процессоров в создаваемой машине. Гипервизор должен поддерживать SMP в гостевых окружениях.

––check-cpu – Проверить что устанавливаемое количество виртуальных процессоров, не превышает количество физических.

––cpuset=CPUSET – Указать какие из физических процессоров может использовать гость. Нумерация начинаются с нуля, перечисление идет  через запятую.

-f DISKFILE , ––file=DISKFILE – Путь до файла (раздела или LVM-тома) который будет использоваться в качестве диска. Если путь не существует, необходимо указать его размер через опцию “––file-size” для последующего создания. Этот параметр можно повторять если требуется создать несколько дисков.

-s DISKSIZE , ––file-size=DISKSIZE - Размер файла который будет создан для виртуального диска, в том случае если путь указанный в “–file” не существует. Размер указывается в гигабайтах.

––nonsparse – Запросить создание полновыделенного файла под нужды виртуального диска. Это займет некоторое время. Рекомендуется включать эту опцию чтобы предотвратить падение производительности и ошибки ввода-вывода, в моменты когда хост-система расширяет файл-образ в то время когда работает гостевая система.

––nodisks – Указать создание машины без дисковой подсистемы, обычно это используется в случае запуска LiveCD или в случае когда система будет установлена на сетевом хранилище (iSCSI или NFS).

-m MAC , ––mac=MAC – Установка фиксированного mac-адреса для гостевой системы. Если параметр не определен то будет сгенерирован случайный адрес. Для xen-систем необходимо чтобы адрес начинался на ’00:16:3e’; для QEMU и KVM – ’54:52:00′.

-b BRIDGE , ––bridge=BRIDGE – Указать bridge-устройство, для присоединения к нему виртуальной сетевой карты. В будущем этот параметр будет исключен в пользу параметра “–network”.

-w NETWORK , ––network=NETWORK - Подключить гостя к сети. Может быть выбрано одно из трех значений:

bridge:BRIDGE - Подключиться к bridge-устройству. С таким соединением гостевая машина имеет полноценное соединение с внешней сетью. Может создавать исходящие соединения и принимать входящие;

network:NAME – Подключиться к внутренней виртуальной сети. Гость будет находиться в изолированной сети, а запросы во внешнюю сеть будут транслированы с помощью NAT;

user – Подключиться к сети используя SLIRP. Этот способ используется когда необходимо запустить гостя под непривилегированным пользователем. При таком способе используется очень ограниченная форма NAT.

Если опция “––network” опущена, будет создана одна сетевая карта с методом подключения ‘bridge’, если создать bridge-соединение не удастся, будет попытка создать network-подключение. Для создание нескольких сетевых адаптеров, этот параметр можно повторить.

––vnc – Установить виртуальную консоль и экспортировать её как vnc-сервер. Если параметр “––vncport” не определен, то будет назначен первый свободный порт после 5900. Узнать инормацию о запущенном vnc-дисплее можно посредством “virsh vncdisplay”.

––sdl – Установить виртуальную консоль и экспортировать ее как SDL окно. Если SDL окно будет закрыто, гость может завершить работу.

––nographics - Отключить все интерактивные сеансы для гостевой виртуальной консоли. Текстовая консоль будет всегда доступна на первом последовательном порту.

––noautoconsole – Не подключать к виртуальной консоли гостя, при включении. По умолчанию при запуске vnc клиент отображает графическую консоль, или же необходимо запустить “virsh console” чтобы отобразить текстовую консоль.

-k KEYMAP , ––keymap=KEYMAP – Запуск виртуальной консоли с раскладкой отличной от английской.

––accelerate – При установке QEMU гостя, включить использование специальных ускоряющих функций ядра для KVM и QEMU. Если гость поддерживает ускорение, то желательно использовать эту опцию. Если поддерживаются оба из ускорителей, то предпочтительней использовать KVM-ускоритель.

––connect=CONNECT – Подключиться к гипервизору. Используется следующий порядок подключения:

xen – если система работает под xen-ядром;

qemu:///system – если гипервизор запущен под root;

qemu:///session – если гипервизор запущен под отличным от root пользователем.

––livecd – Параметр указывается если в качестве образа установки используется liveCD и необходимо загрузиться с CD-ROM. Можно использовать совместно с “–nodisks”.

-v, ––hvm – Создать машину с полной аппаратной виртуализацией. Если хост-система поддерживает пара- и полную виртуализацию, параметр определяет использование полной виртуализации. Этот параметр может быть недоступен если подключение производится к xen-гипервизору без поддержки аппаратной виртуализации.

-c CDROM , ––cdrom=CDROM – Параметр указывает на файл который будет использоваться в качестве устройства CD-ROM в госте с поддержкой полной виртуализации. Это может быть как iso-образ, так и путь до CD-ROM-устройства. Также это может быть URL для того чтобы получить доступ к минимальному загрузочному образу ISO. URL имеет аналогичный формат аргумента что и при определении параметра “––location”. Если этот параметр опущен, должен быть определен параметр “––location” или “––pxe”.

––pxe – Определяет использовать PXE протокол для загрузки образов ядра и initrd в процессе запуска и установки виртуальной машины. Если этот параметр опущен, должен быть определен параметр “––cdrom” или “––location”.

––os-type=OS_TYPE – Оптимизирует гостевое окружение под конкретный тип ОС. Оптимизации включают в себя, настройки ACPI и APIC, необходимые драйвера для мыши и различные настройки ускоряющие гостевую ОС. Доступны следующие типы:

linux – Linux 2.x;
windows – Microsoft Windows 9x или более поздние версии;
unix – Традиционный UNIX BSD или Sys-производные;
other – любое другое

––os-variant=OS_VARIANT – Определяет дополнительный набор оптимизаторов гостевого окружения, для конкретного варианта ОС. Необъязательный параметр.

rhel2.1 – Red Hat Enterprise Linux 2.1 (linux)
rhel3 – Red Hat Enterprise Linux 3 (linux)
rhel4 – Red Hat Enterprise Linux 4 (linux)
rhel5 – Red Hat Enterprise Linux 5 (linux)
centos5 – Cent OS 5 (linux)
fedora5 – Fedora Core 5 (linux)
fedora6 – Fedora Core 6 (linux)
fedora7 – Fedora 7 (linux)
sles10 – Suse Linux Enterprise Server 10.x (linux)
debianEtch – Debian 4.0 (Etch) (linux)
debianLenny – Debian Lenny (linux)
generic26 – Generic Linux 2.6.x kernel (linux)
generic24 – Generic Linux 2.4.x kernel (linux)
winxp – Microsoft Windows XP (windows)
win2k – Microsoft Windows 2000 (windows)
win2k3 – Microsoft Windows 2003 (windows)
vista – Microsoft Windows Vista (windows)
solaris9 – Sun Solaris 9 (unix)
solaris10 – Sun Solaris 10 (unix)
freebsd6 – Free BSD 6.x (unix)
openbsd4 – Open BSD 4.x (unix)
msdos – Microsoft DOS (other)
netware4 – Novell Netware 4 (other)
netware5 – Novell Netware 5 (other)
netware6 – Novell Netware 6 (other)

––noapic - Отключает APIC-оптимизации в гостевом окружении.

––noacpi - Отключает ACPI-оптимизации в гостевом окружении.

––arch=ARCH – Определяет процессорную архитектуру в гостевом окружении, отличную от родной. Опция доступна только для QEMU-гостей и не включает в себя набор оптимизаторов. Если параметр опущен будет использоваться архитектура аналогичная хост-системной.

-p, ––paravirt – Параметр определяет использование паравиртуализации.

-l LOCATION , ––location=LOCATION – Установочный источник образов ядра и initrd для виртуальной машины. Этот параметр является объзательным для паравиртуальных окружений. Полностью виртуальные окружения могут использовать как “––location” так и “––cdrom” для указания источника установки системы. Передаваемый аргумент может иметь следующие формы:

/some/directory – путь к локальной директории в которой находятся образы;

nfs:host:/path/ или nfs://host/path – путь на NFS сервер;

http://host/path – HTTP-ссылка;

ftp://host/path – FTP-ссылка.

-x EXTRA , ––extra-args=EXTRA - Дополнительные аргументы которые установщик передаст ядру при загрузке с образов ядра и initrd.

-d, ––debug – Вывод отладочных сообщений в процессе установки. Если параметр опущен, отладочная информация будет сохранена в “$HOME/.virtinst/virt-install.log”.

Примеры:

Установить паравиртуальное Xen-окружение, с 500Mb RAM, диском 5Gb, с OC Fedora Core 6 которая будет устанавливаться по сети в текстовом режиме:

# virt-install ––paravirt ––name demo ––ram 500 ––file /var/lib/xen/images/demo.img ––file-size 6 ––nographics \
––location http://download.fedora.redhat.com/pub/fedora/linux/core/6/x86_64/os/

Установить QEMU-окружение на отдельном физическом разделе, с архитектурой ppc64, используя SDL-графику, в качестве дистрибутива будет использоваться ISO образ:

# virt-install ––connect qemu:///system ––name demo ––ram 500 ––file /dev/hdc ––network bridge:eth1 ––arch ppc64 ––sdl ––cdrom /root/boot.iso

Установка KVM-окружения в LVM-томе, с подключением к виртуальной сети; загрузка будет выполнена с физического устройства CDROM , для графики будет использован VNC.

# virt-install ––connect qemu:///system ––name demo ––ram 500 ––file /dev/HostVG/DemoVM ––network network:default ––accelerate ––vnc ––cdrom /dev/cdrom

Запустить LiveCD в полностью виртуальном Xen-окружении без использования дисковой подсистемы:

# virt-install ––hvm ––name demo ––ram 500 ––nodisk ––livecd ––vnc ––cdrom /root/fedora7live.iso

Авторы оригинального man – Daniel P. Berrange, Hugh Brock, Jeremy Katz и многие другие…

http://daevy.uzps.mh.ru/?p=533

Комментарии (0) Пинги (0)

Пока нет комментариев.


Leave a comment

 

Trackbacks are disabled.