Добавление устройств к виртуальной машине через интерфейс командной строки

Для управления виртуальными устройствами, подключенными к ВМ необходимо использовать следующие параметры команды prlctl set:

prlctl set <VM_name> --device-add <dev_type> <options> 				#Добавление
prlctl set <VM_name> --device-set <dev_name> <options> 				#Изменение
prlctl set <VM_name> --device-del <dev_name> <options> --destroy-image-force 	#Удаление
prlctl set <VM_name> --device-connect <dev_name> 				#Подключение
prlctl set <VM_name> --device-disconnect <dev_name> 				#Отключение

Привод гибких магнитных дисков добавляется следующей командой:

prlctl set <VM_name> 	--device-add fdd 
			[--image <file>] 
			[--enable|--disable]
			[--connect|--disconnect]

• --image <file> - позволяет указать полный путь к расположению образу дискеты, которая будет подключена к виртуальной машине. Данный параметр также может быть задан в поле веб интерфейса: “Файл образа”.
• --enable|--disable - управляет наличием данного устройства в гостевой виртуальной машине. При установке режима --disable дисковод не будет доступен в виртуальной машине, но сохранится в интерфейсе конфигурации. Данная опция может быть использована для временного отключения дисковода от системы. Данный параметр также может быть задан в поле веб интерфейса: “Включено”.
• --connect|--disconnect - управляет тем вставлена ли виртуальная дискета в дисковод или нет. При установке режима --disconnect дисковод присутствует в виртуальной машине но без дискеты. Данный параметр также может быть задан в поле веб интерфейса: “Соединено”.

Добавление виртуального жесткого диска к ВМ производится ис пользованием следующей команды:

prlctl set <VM_name> 	--device-add hdd
			[--image <file> [--recreate]] [--size <size>] [--no-fs-resize]
			[--iface <ide|scsi|virtio>] [--subtype <virtio-scsi|hyperv>]
			[--position <pos>] [--enable|--disable]

• --image <file> - позволяет указать полный путь к образу диска, который будет подключен к виртуальной машине. Данный параметр также может быть задан в поле веб интерфейса: “Файл образа”.
• --recreate- при указании данной опции диск будет очищен и все данные на нем будут потеряны. Данная опция соответствует активации следующего параметра в веб интерфейсе: “Воссоздать”.
• --size - данный раздел позволяет изменить размер образа жесткого диска. Данный параметр также может быть задан в поле веб интерфейса: “Размер диска”.
• --no-fs-resize - при указании данной опции изменение размера файловой системы виртуального диска через интеграцию с гостевыми утилитами произведено не будет. Уменьшение объема диска не может быть выполнено при указании данной опции. Данная опция соответствует деактивации следующего параметра в веб интерфейсе: “Изменить размер файловой системы”.
• --iface- позволяет выбрать тип интерфейса с использованием которого будет подключен диск к виртуальной машине. Данный параметр также может быть задан в поле веб интерфейса: “Тип интерфейса”. Доступны следующие атрибуты указания типа:
  • scsi- паравиртуализованный интерфейс Virtio-SCSI - самый высокопроизводительный и функциональный интерфейс (позволяет подключить до 15 жестких или оптических дисков на одну виртуальную машину);
  • ide- традиционный параллельный интерфейс, поддерживаемый в большинстве операционных систем (позволяет подключить до 4 жестких или оптических приводов к виртуальной машине);
  • virtio- паравиртуализованный интерфейс Virtio-blk - более старый и менее функциональный блочный интерфейс (позволяет подключить до 15 жестких дисков на одну виртуальную машину).
• --subtype - задание значения данной опции hyperv позволяет использовать паравиртуальный драйвер, совместимый с операционной системой Microsoft Windows без установки гостевых утилит. Если данная опция не указана по умолчанию используется драйвер VirtIO.
• --position - данный раздел позволяет задать номер устройства на выбранной шине. Данный параметр также может быть задан в поле веб интерфейса: “Расположение”.
• --enable | --disable - данные опции управляют наличием данного устройства в гостевой виртуальной машине. При задании опции --disable диск не будет доступен в виртуальной машине, но сохранится в интерфейсе конфигурации. Данная опция может быть использована для временного отключения диска от системы. Данный параметр также может быть задан в поле веб интерфейса: “Включено”.

Для добавления привода оптических дисков к виртуальной машине необходимо использовать следующую команду:

prlctl set <VM_name> 	--device-add cdrom 
			{--image <file> | --device <dev_name>}
			[--iface <ide|scsi>]
			[--subtype <virtio-scsi|hyperv>]
			[--position <pos>]
			[--enable|--disable]
			[--connect|--disconnect]

• --image <file> - позволяет указать полный путь к образу диска, который будет подключен к виртуальной машине. Данный параметр также может быть задан в поле веб интерфейса: “Файл образа”.
• --device <dev_name> - позволяет подключить физический привод сервера, на котором запущена виртуальная машина непосредственно к ВМ. Для получения информации о доступных приводах на сервере необходимо использовать комманду prlsrvctl info. Данный параметр также может быть задан в поле веб интерфейса: “Физический диск”.
• --iface <ide|scsi>- позволяет выбрать тип интерфейса с использованием которого будет подключен диск к виртуальной машине. Данный параметр также может быть задан в поле веб интерфейса: “Тип интерфейса”. Доступны следующие атрибуты указания типа:
  • scsi- паравиртуализованный интерфейс Virtio-SCSI - самый высокопроизводительный и функциональный интерфейс (позволяет подключить до 15 жестких или оптических дисков на одну виртуальную машину);
  • ide- традиционный параллельный интерфейс, поддерживаемый в большинстве операционных систем (позволяет подключить до 4 жестких или оптических приводов к виртуальной машине);
• --subtype <virtio-scsi|hyperv> - задание значения данной опции hyperv позволяет использовать паравиртуальный драйвер, совместимый с операционной системой Microsoft Windows без установки гостевых утилит. Если данная опция не указана по умолчанию используется драйвер VirtIO SCSI.
• --position - данный раздел позволяет задать номер устройства на выбранной шине. Данный параметр также может быть задан в поле веб интерфейса: “Расположение”.
• --enable|--disable - управляет наличием данного устройства в гостевой виртуальной машине. При установке режима --disable дисковод не будет доступен в виртуальной машине, но сохранится в интерфейсе конфигурации. Данная опция может быть использована для временного отключения дисковода от системы. Данный параметр также может быть задан в поле веб интерфейса: “Включено”.
• --connect|--disconnect - управляет тем вставлен ли диск в дисковод или нет. При установке режима --disconnect дисковод присутствует в виртуальной машине но без диска. Данный параметр также может быть задан в поле веб интерфейса: “Соединено”.

Добавление сетевого адаптера производится с использованием команды:

prlctl set <VM_name> 	--device-add net
			{--type routed | --network <network_ID>} 
			[--mac {<addr>|auto}]
			[{--ipadd <addr>[/<mask>] --ipdel <addr>[/<mask>] | --dhcp <yes|no> --dhcp6 <yes|no>}]
			[--gw <gw>] [--gw6 <gw>]
			[--nameserver <addr>]
			[--searchdomain <addr>]
			[--configure <yes|no>]
			[--ipfilter <yes|no>]
			[--macfilter <yes|no>]
			[--preventpromisc <yes|no>]
			[--enable|--disable]
			[--connect|--disconnect]
			[--adapter-type <e1000|rtl|virtio>]

• Допускается указание одного из двух следующих режимов работы сети виртуальной машины:
  • --type routed - режим при котором сетевой адаптер виртуальной машины не имеет доступа к внешней сети, вместо этого сервер виртуализации выступает маршрутизатором для такого сетевого адаптера и направляет пакеты через один из собственных сетевых интерфейсов. При выборе данного типа сети адрес виртуального сетевого адаптера назначается только из интерфейса администрирования гипервизора. Задание адреса из виртуальной машины или использование DHCP не поддерживается. Данный параметр также может быть задан в поле веб интерфейса: “Маршрутизируемый”.
  • --network <network_ID> - при выборе данного режима сетевой адаптер будет подключен к одной из указанных виртуальных сетей посредством сетевого моста. Данный параметр также может быть задан в поле веб интерфейса: “Подключить к виртуальной сети”.
• --mac {<addr>|auto} - данная опция позволяет изменить адрес виртуального сетевого адаптера. Данный параметр также может быть задан в поле веб интерфейса: “MAC адрес”.
• --ipadd <addr>[/<mask>] - дананя опция позволяет добавить дополнительный IP адрес виртуальной машины и указать маску подсети. Данный параметр также может быть задан в поле веб интерфейса: “IP-адрес / Маска подсети”.
• --ipdel <addr>[/<mask>] - данная опция позволяет удалить назначенный IP адрес из виртуальной машины. Данный параметр также может быть задан в поле веб интерфейса: “IP-адрес / Маска подсети”.
• --dhcp <yes|no> --dhcp6 <yes|no>} - данная опция позволяет активировать использование сервера автоматическного назначения адреса DHCP для протоколов IP v4 и v6. Данный параметр также может быть задан в поле веб интерфейса: “Получить IP-адрес по: DHCPv4 / DHCPv6”.
• --gw <gw> --gw6 <gw> - позволяет указать основной шлюз для сетевого адаптера. Данный параметр также может быть задан в поле веб интерфейса: “Шлюз по умолчанию”.
• --nameserver <addr> - позволяет задать IP адрес DNS сервера. Данный параметр также может быть задан в поле веб интерфейса: “IP-адрес DNS-сервера”.
• --searchdomain <addr> - данное поле задает DNS-суффикс по умолчанию. Данный параметр также может быть задан в поле веб интерфейса: “Поисковый домен”.
• --configure <yes|no> - данная опция управляет применением параметров IP адреса к виртуальным адаптерам внутри ВМ. При задании одного из параметров выше опция автоматически устанавливается в режим --configure yes.
• --ipfilter <yes|no> - при установки значения yes виртуальный адаптер сможет отправлять пакеты только с указанного в свойствах адаптера IP адреса. При смене IP адреса из операционной системы доступ к сети с использованием нового адреса будет ограничен. Данный параметр также может быть задан в поле веб интерфейса: “Фильтровать по IP-адресу”.
• --macfilter <yes|no> при установки значения yes виртуальный адаптер сможет отправлять пакеты только с указанного в свойствах адаптера mac адреса. Если mac-адрес будет изменен в виртуальной машине - пакеты с отличающимся адресом не будут покидать виртуальную машину. Данный параметр также может быть задан в поле веб интерфейса: “Фильтровать по MAC-адресу”.
• --preventpromisc <yes|no> - активация данной опции позволяет ограничить прием широковещательных сетевых пакетов - отключив режим “Promiscuous”. При установке данной опции в режим no сетевой адаптер сможет принимать широковещательные пакеты, это необходимо например в случае запуска внутри виртуальной машины сервиса DHCP. Данный параметр также может быть задан в поле веб интерфейса: “Неизбирательный режим”.
• --enable|--disable - данная опция управляет наличием устройства в гостевой виртуальной машине. При задании опции --disable адаптер не будет доступен в виртуальной машине, но сохранится в интерфейсе конфигурации. Данная опция может быть использована для временного отключения сетевого адаптера от системы. Данный параметр также может быть задан в поле веб интерфейса: “Включено”.
• --connect|--disconnect - управляет тем вставлен ли виртуальный сетевой кабель в адаптер или нет. При задании режима --disconnect адаптер присутствует в виртуальной машине с состоянием сетевого кабеля - “отключено”. Данный параметр также может быть задан в поле веб интерфейса: “Соединено”.
• --adapter-type <e1000|rtl|virtio> - - данная опция позволяет выбрать в качестве какого устройства будет представлен сетевой адаптер в виртуальной машине, Данный параметр также может быть задан в поле веб интерфейса: “Тип адаптера”. Поддерживаемые варианты выбора:
  • rtl - винтажный адаптер Realtek RTL8139 со скоростью порта 100 Мбит, выпущенный в 1997 году - используется только в случае необходимости обеспечения совместимости с устаревшими ОС;
  • e10000 - адаптер Intel PRO/1000MT со скорость порта 1 Гбит, выпущенный в 2003 году - используется только в случае необходимости обеспечения совместимости с устаревшими ОС;
  • virtil - паравиртуальный адаптер VirtIO со скоростью порта 10 Гбит.

Для добавления последовательного порта необходимо воспользоваться следующей командой:

prlctl set <VM_name> 	{--device-add serial | --device-add serial<N>}
			{--device <dev_name> | --output <file> | --socket <name>}
			[--enable|--disable]
			[--connect|--disconnect]

• Допускается задание режима функционирования последовательного порта одной из следующих опций:
  • --device <dev_name>- позволяет подключить физический порт сервера, на котором запущена виртуальная машина непосредственно к ВМ. Данный параметр также может быть задан в поле веб интерфейса: “Физическое устройство”
  • --output <file> - при выборе данного режима весь вывод порта виртуальной машины будут записан в указанный файл. Данный параметр также может быть задан в поле веб интерфейса: “Файл вывода”
  • --socket <name> - данный режим позволяет объединить две виртуальные машины через сокет по последовательному порту. Данный параметр также может быть задан в поле веб интерфейса: “Сокет”
• --enable|--disable - данная опция управляет наличием устройства в гостевой виртуальной машине. При задании режима --disable порт не будет доступен в виртуальной машине, но сохранится в интерфейсе конфигурации. Данная опция может быть использована для временного отключения устройства от системы без удаления записи в конфигурации виртуальной машины.. Данный параметр также может быть задан в поле веб интерфейса: “Включено”
• --connect|--disconnect - данная опция управляет тем подключён виртуальный порт к заданному интерфейсу. При указании режима --disconnect виртуальной порт присутствует в машине но не подключен ни к какому устройству или файлу. Данный параметр также может быть задан в поле веб интерфейса: “Включено”