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

Для настройки виртуального оборудования, предоставленного машине из коммандной строки используется приложение 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>
• --iface <ide|scsi>
• --subtype <virtio-scsi|hyperv>
• --position <pos>
• --enable|--disable
• --connect|--disconnect

prlctl set <VM_name> 	{--device-add net | --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>]

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