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

Для настройки виртуального оборудования, предоставленного машине из коммандной строки используется приложение prlctl. Данное приложение установлено на каждом сервере гипервизоре и поддерживает администрирование виртуальных машин локального сервера или удаленного.

• Для управления машинами локального сервера команда запускается без параметров prlctl <command> <VM Name> [<options>], где:
  • <command> - оператор;
  • <VM Name> - имя виртуальной машины;
  • <options> - опциональные параметры оператора;
• Для работы на удаленном сервере в качестве параметров к команде добавляется строка авторизации prlctl <command> <VM Name> [<options>] --login [<user>[:<passwd>]@]<server>], где:
  • <user> - имя пользователя;
  • <passwd> - пароль;
  • <server> - адрес сервера;

Для изменения параметров виртуальной машины и виртуального оборудования машины используется команда prlctl set.

Команда prlctl set может быть использована для изменений общих параметров виртуальной машины, таких как:

• процессорное время и число потоков;
• объем и параметры оперативной памяти;
• порядок загрузки BIOS;
• объем видеопамяти.

Перечень доступных опций команды, используемых для изменения общих параметров виртуальной машиын приведен ниже:

prlctl set <VM_name> 	[--cpus <number>] [--cpu-sockets <number>] [--memsize <number>]
			[--videosize <number>] [--memguarantee <percentage>]
			[--mem-hotplug <on|off>] [--description <desc>]
			[--autostart <on|off|auto>] [--autostart-delay <number>]
			[--autostop <stop|suspend>] [--applyconfig <conf>] [--name <new_name>]
			[--vnc-mode <auto|manual|off> {--vnc-passwd <passwd> | --vnc-nopasswd}]
			[--vnc-port <port>] [--vnc-address <address>] [--cpu-hotplug <on|off>]
			[--cpuunits <units>] [--cpulimit {<percent>|<megahertz>}]
			[--ioprio <priority>] [--iolimit <limit>] [--iopslimit <limit>]
			[--cpumask {<N>[,N,N1-N2] | all}] [--nodemask {<N>[,N,N1-N2] | all}]
			[--offline-management <on|off>] [--offline-service <service_name>]
			[--userpasswd <user>:<passwd>] [--rate <rate>]
			[--ratebound <on|off>_] [--apply-iponly <yes|no>] [--efi-boot <on|off>]
			[--tools-autoupdate <on|off>] [--on-crash <pause|restart>[:no-report]]
			[--nested-virt <on|off>]

Для управления параметрами виртуального процессора доступны следующие опции:

prlctl set <VM_name> 	[--cpus <number>]
			[--cpu-sockets <number>] 
			[--cpuunits <units>] 
			[--cpu-hotplug <on|off>]
			[--cpulimit {<percent>|<megahertz>}]
			[--cpumask {<N>[,N,N1-N2] | all}] 
			[--nodemask {<N>[,N,N1-N2] | all}]
			[--nested-virt <on|off>]

• --cpus - количество ядер на сокет виртуального процессора. Данный параметр также может быть задан в поле веб интерфейса: “Количество процессоров”.
• --cpu-sockets - количество сокетов виртуального процессора. По умолчанию в виртуальной машине создается один процессорный сокет.;
• --cpu-hotplug - активация “горячего” добавления процессоров. Данный функционал требует единоразовой активации и позволяет добавлять процессоры в виртуальную машину без остановки или перезагрузки гостевой операционной системы. Поддержка данного функционала должна быть реализована в операционной системе. Официально поддерживаются: Linux моложе RHEL5 и Windows Server моложе 2008. Удаление виртуальных процессоров не поддерживается;
• --cpuunits - приоритет выделения ресурсов процессора данной виртуальной машины по отношению к прочим виртуальным средам одного физического сервера. Диапазон значений от 8 до 500000. По умолчанию приоритет равен 1000; Данный параметр также может быть задан в поле веб интерфейса: “Время ЦП”.
• --cpulimit - ограничение процессорной мощности виртуальной машины, указанное в процентах от суммарной мощности физического сервера или мегагерцах, который виртуальная машина не может превысить. Одно ядро процессора физического сервера принимается за 100%. Например двухпроцессорный сервер с процессором “Intel(R) Xeon(R) CPU E5-2680 v4 14C/28T 2,4 GHz” может обеспечить суммарно 5600% времени ЦП для виртуальных сред или 67200 МГц. Данный параметр также может быть задан в поле веб интерфейса: “Лимит времени ЦП”.
• --cpumask - маска процессоров физического сервера, позволяет указать какие именно ядра гипервизора будут использованы для обработки процессов виртуальной машины. Принимаются численные значения через запятую 0,1,2,3 а также интервал: 1-4. Для снятия ограничения необходимо задать значение --cpumask all
• --nodemask - маска сокетов физического сервера, по аналогии с маской процессорных ядер позволяет ограничить виртуальную машину в рамках выбранных процессорных сокетов гипервизора (NUMA node). Принимаются численные значения через запятую 0,1,2,3 а также интервал: 1-4. Для снятия ограничения необходимо задать значение --nodemask all
• --nested-virt - активация функционала “вложенной” виртуализации, который позволяет запускать виртуальные машины внутри виртуальной машины. Данная опция может быть использована для тестирования средств виртуализации внутри виртуальной среды.

Для управления параметрами оперативной памяти виртуальной машины доступны следующие опции:

prlctl set <VM_name> 	[--memsize <number>]
			[--memguarantee <percentage>]
			[--mem-hotplug <on|off>] 

• --memsize - объем оперативной памяти, доступной виртуальной машине в мегабайтах. Для задания объема в гигабайтах необходимо использовать суффикс: G. Данный параметр также может быть задан в поле веб интерфейса: “Оперативная память”. В связи с особенностью работы функционала “memory balooning” гостевая операционная система получает информацию об объеме оперативной памяти с учетом её возможного расширения за счет функционала “memory balooning”. Реальный указанный объем оперативной памяти гостевой операционной системе не доступен и никак не отслеживается из ВМ. Недоступная память внутри виртуальной машины будет отображаться как занятая.
• --memguarantee - объем оперативной памяти в процентах, зарезервированной для данной виртуальной машины. По умолчанию равен 80% от указанного объема памяти машины. Для возврата к стандартным значениям параметр переменной необходимо задать как auto. Суммарный объем зарезервированной оперативной памяти виртуальных сред не должен превышать доступную память хоста виртуализации.
• --mem-hotplug - активация “горячего” изменения объема оперативной памяти. Данный функционал требует единоразовой активации и позволяет увеличивать и уменьшать объем оперативной памяти виртуальной машины без остановки или перезагрузки гостевой операционной системы. Данный функционал поддерживается на всех виртуальных машинах как минимум с 1 ГБ оперативной памяти;

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

prlctl set <VM_name> 	[--efi-boot <on|off>]
			[--device-bootorder "dev_name1 dev_name2 [...]"]

• --efi-boot - включение режима загрузки EFI. Данный параметр также может быть задан в поле веб интерфейса: “Использовать EFI”.
• --device-bootorder - изменения порядка перебора загрузочных устройств. В качестве параметров данной опции указываются названия устройств загрузки, в виде: hdd0 net0 cdrom0 fdd0 . Данный параметр также может быть задан в поле веб интерфейса: “Порядок загрузки”.

Объем видеопамяти виртуальной машины указывается следующей командой

prlctl set <VM_name> 	[--videosize <number>]

Данный параметр также может быть задан в поле веб интерфейса: “Видеопамять.”. Объем указывается в мегабайтах, допускаемое значение от 2 до 256.

Для управления виртуальными устройствами, подключенными к ВМ необходимо использовать следующие параметры команды 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-set fdd0
			[--image <file>] 
			[--enable|--disable]
			[--connect|--disconnect]

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

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

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

• --device-set hdd<N> - данная опция указывает на виртуальный диск, над которым необходимо провести манипуляции.
• --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-set cdrom<N> 
			[--image <file>]
			[--device <dev_name>]
			[--iface <ide|scsi>]
			[--subtype <virtio-scsi|hyperv>]
			[--position <pos>]
			[--enable|--disable]
			[--connect|--disconnect]

• --device-set cdrom<N> - данная опция указывает на виртуальный привод оптических дисков, над которым необходимо провести манипуляции.
• --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-set net<N>
			{--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>]

• --device-set net<N>
• --type routed - сетевой адаптер виртуальной машины не имеет доступа к внешней сети, вместо этого сервер виртуализации выступает маршрутизатором для такого сетевого адаптера и направляет пакеты через один из собственных сетевых интерфейсов. При выборе данного типа сети адрес виртуального сетевого адаптера назначается только из интерфейса администрирования гипервизора. Задание адреса из виртуальной машины или использование DHCP не поддерживается.

Данный параметр также может быть задан в поле веб интерфейса: “Маршрутизируемый”.

• --network <network_ID> - при выборе данного режима сетевой адаптер будет подключен к одной из виртуальных сетей, указанных в поле “Виртуальная сеть” посредством сетевого моста. Помимо созданных администратором виртуальных сетей на платформе виртуализации также доступны два встроенных варианта подключения.

Данный параметр также может быть задан в поле веб интерфейса: “Подключить к виртуальной сети”. Данные виртуальные сети создаются автоматически и могут быть переопределены или удалены администратором:

• Bridged (enoX) - позволяет подключить виртуальную машину мостом непосредственно к указанному в скобках сетевому интерфейсу.
• Host Only - виртуальная машина будет подключена к изолированной сети сервера виртуализации.
• --mac {<addr>|auto} - во время создания сетевого адаптера ему автоматически присваивается уникальный mac адрес. Данное поле позволяет изменить адрес при необходимости.

Данный параметр также может быть задан в поле веб интерфейса: “MAC адрес”.

• --ipadd <addr>[/<mask>] - - данное поле позволяет задать вручную или выбрать из существующего пула IP адрес виртуальной машины. Для использования функционала автоматического назначения необходимо указать в поле адреса и маски значение <auto>. Поддерживается возможность добавления дополнительных адресов путем нажатия кнопки с пиктограммой “добавить поле”.

Данный параметр также может быть задан в поле веб интерфейса: “IP-адрес / Маска подсети”.

• --ipdel <addr>[/<mask>] - данное поле позволяет задать вручную или выбрать из существующего пула IP адрес виртуальной машины. Для использования функционала автоматического назначения необходимо указать в поле адреса и маски значение <auto>. Поддерживается возможность добавления дополнительных адресов путем нажатия кнопки с пиктограммой “добавить поле”.

Данный параметр также может быть задан в поле веб интерфейса: “IP-адрес / Маска подсети”.

• --dhcp <yes|no> --dhcp6 <yes|no>} - данная опция доступна только если в поле “Тип сети” установлено значение “Подключить к виртуальной сети”. Использование DHCP сервера доступно только когда сетевой адаптер виртуальной машины подключен через мост во внешнюю сеть.

Данный параметр также может быть задан в поле веб интерфейса: “Получить IP-адрес по: DHCPv4 / DHCPv6”.

• --gw <gw> --gw6 <gw> - позволяет указать основной шлюз для сетевого адаптера. Данная опция доступна только если в поле “Тип сети” установлено значение “Подключить к виртуальной сети”. При использовании маршрутизируемой сети внутренний шлюз, работающий на сервере виртуализации будет установлен автоматически. Отдельное поре “IPv6 шлюза по умолчанию” позволяет указать при необходимости адрес IPv6 шлюза.

Данный параметр также может быть задан в поле веб интерфейса: “Шлюз по умолчанию”.

• --nameserver <addr> - позволяет задать IP адрес DNS сервера. Поддерживается возможность добавления дополнительных адресов путем нажатия кнопки с пиктограммой “добавить поле”.

Данный параметр также может быть задан в поле веб интерфейса: “IP-адрес DNS-сервера”.

• --searchdomain <addr> - данное поле задает DNS-суффикс по умолчанию.

Данный параметр также может быть задан в поле веб интерфейса: “Поисковый домен”.

• --configure <yes|no>
• --ipfilter <yes|no> - при активации данной функции все исходящие пакеты данного адаптера будут отфильтрованы по IP адресу, указанному в параметрах настройки виртуального адаптера. При смене IP адреса из операционной системы доступ к сети с использованием нового адреса будет ограничен.

Данный параметр также может быть задан в поле веб интерфейса: “Фильтровать по IP-адресу”.

• --macfilter <yes|no> - при активации данной функции все исходящие пакеты данного адаптера будут отфильтрованы по его mac-адресу. Если mac-адрес будет изменен в виртуальной машине - пакеты с отличающимся адресом не будут покидать виртуальную машину.

Данный параметр также может быть задан в поле веб интерфейса: “Фильтровать по MAC-адресу”.

• --preventpromisc <yes|no> - активация данного режима позволяет снять ограничения на прием сетевых пакетов, не адресованных данному сетевому адаптеру. В режиме Promiscuous сетевой адаптер сможет принимать пакеты не адресованные его адресу, это необходимо например в случае запуска внутри виртуальной машины сервиса DHCP.

Данный параметр также может быть задан в поле веб интерфейса: “Неизбирательный режим”.

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

Данный параметр также может быть задан в поле веб интерфейса: “Включено”.

• --connect|--disconnect - управляет тем вставлен ли сетевой кабель в адаптер или нет. При отключении данной опции адаптер присутствует в виртуальной машине с состоянием сетевого кабеля - “отключено”.

Данный параметр также может быть задан в поле веб интерфейса: “Соединено”.

• --adapter-type <e1000|rtl|virtio> - - данная опция позволяет выбрать в качестве какого устройства будет представлен сетевой адаптер в виртуальной машине,

Данный параметр также может быть задан в поле веб интерфейса: “Тип адаптера”. Поддерживаемые варианты выбора:

• Realtek RTL8139 - адаптер со скоростью порта 100 Мбит, выпущенный в 1997 году - используется только в случае необходимости обеспечения совместимости с устаревшими ОС;
• Intel PRO/1000MT - адаптер со скорость порта 1 Гбит, выпущенный в 2003 году - используется только в случае необходимости обеспечения совместимости с устаревшими ОС;
• VirtIO - паравиртуальный адаптер со скоростью порта 10 Гбит.

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