Глава 17. Настройка устройства виртуальной машины

Разрешение спецификации Intel VT-d

Спецификация Intel VT-d предоставляет аппаратную поддержку для прямого назначения некоторого физического устройства в какую- то виртуальную машину. Эти спецификации необходимы для применения назначения устройств PCI в Red Hat Enterprise Linux.

Спецификация Intel VT-d должна быть включена в имеющемся BIOS. Некоторые производители систем хапрещают по умолчанию эти спецификации. Применяемая терминология для таких спецификаций может иметь различные названия у разных производителей, проконсультируйтесь с документацией своего производителя относительно применяемых названий.

Активировать Intel VT-d в самом ядре

Активируйте Intel VT-d в своём ядре добавив параметры intel_iommu=on и iommu=pt в самый конец строки GRUB_CMDLINX_LINUX внутри имеющихся кавычек в своём файле /etc/sysconfig/grub.

Приводимый ниже пример является модификацией grub с активированным Intel VT-d.

GRUB_CMDLINE_LINUX="rd.lvm.lv=vg_VolGroup00/LogVol01 vconsole.font=latarcyrheb-sun16 rd.lvm.lv=vg_VolGroup_1/root vconsole.keymap=us $([ -x /usr/sbin/rhcrashkernel-param ] && /usr/sbin/rhcrashkernel-param || :) rhgb quiet intel_iommu=on iommu=pt"
 	   

Повторное создание файла настройки

Выполните повторную генерацию файла /etc/grub2.cfg, исполнив:

grub2-mkconfig -o /etc/grub2.cfg
		

Отметим, что если вы применяете хост на основе UEFI, вашим файлом назначения должен быть /etc/grub2-efi.cfg

Готов к применению

Для того чтобы изменения вступили в силу, перезагрузите свою систему. Теперь ваша система имеет возможность назначать устнойства PCI.

Включение спецификации AMD IOMMU

Для назначения устройства PCI в Red Hat Enterprise Linux требуются спецификации AMD IOMMU. Эти спецификации должны быть разрешены в BIOS. Некоторые производители оборудования отключают эти спецификации по усолчанию.

Разрешить поддержку IOMMU ядром

Добавьте в конец строки GRUB_CMDLINX_LINUX amd_iommu=pt внутри кавычек в /etc/sysconfig/grub с тем, чтобы спецификации AMD IOMMU разрешались при загрузке.

Создайте повторно файл настройки

Выполните повторную генерацию файла /etc/grub2.cfg, исполнив:

grub2-mkconfig -o /etc/grub2.cfg
		

Отметим, что если вы применяете хост на основе UEFI, вашим файлом назначения должен быть /etc/grub2-efi.cfg

Готов к применению

Для того чтобы изменения вступили в силу, перезагрузите свою систему. Теперь ваша система имеет возможность назначать устнойства PCI.

Идентификация самого устройства

Вначале опредеите само устройство PCI, предназначающееся для назначения устройства в определённую виртуальную машину. Воспользуйтесь командой lspci для вывода перечня всех доступных устройств PCI. Вы можете улучшить получаемый вывод lspci с помощью grep.

Данный пример использует контроллер Ethernet, выделенный в следующем выводе:

# lspci | grep Ethernet
00:19.0 Ethernet controller: Intel Corporation 82567LM-2 Gigabit Network Connection
01:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
01:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
		

Данный контроллер Ethernet отображается со своим кортким идентификатором 00:19.0. Нам требуется определить полный идентификатор, применяемый virsh чтобы назанчить это устройство PCI в виртуальную машину.

Для этого примените команду virsh nodedev-list чтобы отобразить перечень всех устройств определённого типа (pci), которые подключены к данной машине хоста. Затем пройдитесь по полученному выводу чтобы отыскать ту строку, которая соответстует необходимому короткому идентификатору того устройства, которое вы намереваетесь применять.

Данный пример показывает ту строку, которая соответствует искомому контроллеру Ethernet с нужным нам коротким идентификатором 00:19.0. Отметим, что символы : и . замещаются подчёркиваниями в получаемом полном идентификаторе.

# virsh nodedev-list --cap pci
pci_0000_00_00_0
pci_0000_00_01_0
pci_0000_00_03_0
pci_0000_00_07_0
pci_0000_00_10_0
pci_0000_00_10_1
pci_0000_00_14_0
pci_0000_00_14_1
pci_0000_00_14_2
pci_0000_00_14_3
pci_0000_00_19_0
pci_0000_00_1a_0
pci_0000_00_1a_1
pci_0000_00_1a_2
pci_0000_00_1a_7
pci_0000_00_1b_0
pci_0000_00_1c_0
pci_0000_00_1c_1
pci_0000_00_1c_4
pci_0000_00_1d_0
pci_0000_00_1d_1
pci_0000_00_1d_2
pci_0000_00_1d_7
pci_0000_00_1e_0
pci_0000_00_1f_0
pci_0000_00_1f_2
pci_0000_00_1f_3
pci_0000_01_00_0
pci_0000_01_00_1
pci_0000_02_00_0
pci_0000_02_00_1
pci_0000_06_00_0
pci_0000_07_02_0
pci_0000_07_03_0
		

Запишите требуемый номер устройства PCI, который соответствует тому устройству, что вы желаете применять; он понадобится в последующих шагах.

Просмотр информации об устройстве

Из вывода команды virsh nodedev-dumpxml доступна информация о домене, шине и функции:

# virsh nodedev-dumpxml pci_0000_00_19_0

<device>
  <name>pci_0000_00_19_0</name>
  <parent>computer</parent>
  <driver>
    <name>e1000e</name>
  </driver>
  <capability type='pci'>
    <domain>0</domain>
    <bus>0</bus>
    <slot>25</slot>
    <function>0</function>
    <product id='0x1502'>82579LM Gigabit Network Connection</product>
    <vendor id='0x8086'>Intel Corporation</vendor>
    <iommuGroup number='7'>
      <address domain='0x0000' bus='0x00' slot='0x19' function='0x0'/>
    </iommuGroup>
  </capability>
</device>
		

 

Замечание

Некая нруппа IOMMU определяется на основании имеющихся видимости и изоляции устройств с точки зрения самого IOMMU. Каждая группа IOMMU может содержать одно или более устройств. Когда представлено множество устройств, все конечные точки внутри такой группы IOMMU должны быть заявлены для всех устройств внутри данной группы чтобы назначать их гостю. Это можно осуществить либо посредством также назначением дополнительных конечых точек этому гостю, либо отсоединяя их от своего драйвера хоста с применением virsh nodedev-detach. Содержащиеся внутри отдельной группы устройства не могут быть расщеплены между хостом и гостем. Не являющиеся оконечными точками устройства, такие как порты корня PCIe, порты коммутатора и мосты нет необходимости отсоединять от их драйверов хоста и они не оказывают влияния на назначение конечных точек. Устройства внутри некоторой группы IOMMU могут быть определены с помощью раздела iommuGroup в получаемом выводе virsh nodedev-dumpxml. Каждый участник этой группы представлен в отдельном поле "адрес". Данную информацию можно также обнаружить в sysfs при помощи следующего: $ ls /sys/bus/pci/devices/0000:01:00.0/iommu_group/devices/ Некий образец вывода такой команды может представлять собой: 0000:01:00.0 0000:01:00.1 Чтобы назначить гостю только 0000.01.00.0, данная не используемая конечная точк должна быть отсоединена от своего хоста перед запуском соответствующего гостя: $ virsh nodedev-detach pci_0000_01_00_1

Определение необходимых подробностей настройки

Для получения тех значений, которые требуются вашему файлу настройки, воспользуйтесь получаемым из команды virsh nodedev-dumpxml pci_0000_00_19_0 выводом.

Устройтсво нашего примера имеет следующие значения: bus = 0, slot = 25 и function = 0. Десятичные настройки применяют эти три значения:

bus='0'
slot='25'
function='0'
 	   

Добавление подробностей настройки

Выполните virsh edit, определив необходимое название виртуальной машины и добавьте запись устройства в соответствующем разделе <source> чтобы назначить это устройство PCI в редактируемую гостевую виртуальную машину.

# virsh edit guest1-rhel7-64

<hostdev mode='subsystem' type='pci' managed='yes'>
  <source>
    <address domain='0' bus='0' slot='25' function='0'/>
  </source>
</hostdev>
		

В качестве альтернативы выполните virsh attach-device, определив название нужной виртуальной машины и соответствующий файл XML гостя:

virsh attach-device guest1-rhel7-64 file.xml
		

Запустите эту виртуальную машину

# virsh start guest1-rhel7-64
		

Откройте установки оборудования

Откройте свою гостевую машину и кликните кнопку Add Hardware для добавления нового устройства в эту виртуальную машину.

 

Рисунок 17-3

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

Выберите устройство PCI

Выберите PCI Host Device из списка Hardware, расположенного слева.

Выберите неиспользуемое устройство PCI. Отметим, что выбор устройств PCI, находящихся в настоящее время в использовании другим гостем вызывает ошибки. В данном примере используется запасной аудио контроллер. Кликните Finish для завершения установки.

 

Рисунок 17-4

Мастер добавления нового виртуального оборудования

Добавить новое устройство

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

 

Рисунок 17-5

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

Определите устройство

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

# lspci | grep Ethernet
00:19.0 Ethernet controller: Intel Corporation 82567LM-2 Gigabit Network Connection
01:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
01:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
 	   

Команда virsh nodedev-list перечислит все устройства, подключённые к применяемой системе и укахет некую строку для каждого устройства PCI. Для ограничения устройствами PCI введите следующую команду:

# virsh nodedev-list --cap pci
pci_0000_00_00_0
pci_0000_00_01_0
pci_0000_00_03_0
pci_0000_00_07_0
pci_0000_00_10_0
pci_0000_00_10_1
pci_0000_00_14_0
pci_0000_00_14_1
pci_0000_00_14_2
pci_0000_00_14_3
pci_0000_00_19_0
pci_0000_00_1a_0
pci_0000_00_1a_1
pci_0000_00_1a_2
pci_0000_00_1a_7
pci_0000_00_1b_0
pci_0000_00_1c_0
pci_0000_00_1c_1
pci_0000_00_1c_4
pci_0000_00_1d_0
pci_0000_00_1d_1
pci_0000_00_1d_2
pci_0000_00_1d_7
pci_0000_00_1e_0
pci_0000_00_1f_0
pci_0000_00_1f_2
pci_0000_00_1f_3
pci_0000_01_00_0
pci_0000_01_00_1
pci_0000_02_00_0
pci_0000_02_00_1
pci_0000_06_00_0
pci_0000_07_02_0
pci_0000_07_03_0
 	   

Запишите необходимый номер устройства PCI; этот номер понадобится на последующих этапах.

Информация о получаемых значениях домена, шины и функции доступна в выводе команды virsh nodedev-nodedevdumpxml:

# virsh nodedev-dumpxml pci_0000_01_00_0

<device>
  <name>pci_0000_01_00_0</name>
  <parent>pci_0000_00_01_0</parent>
  <driver>
    <name>igb</name>
  </driver>
  <capability type='pci'>
    <domain>0</domain>
    <bus>1</bus>
    <slot>0</slot>
    <function>0</function>
    <product id='0x10c9'>82576 Gigabit Network Connection</product>
    <vendor id='0x8086'>Intel Corporation</vendor>
    <iommuGroup number='7'>
      <address domain='0x0000' bus='0x00' slot='0x19' function='0x0'/>
    </iommuGroup>
  </capability>
</device>
 	   

Замечание

Если имеется множество оконечные точки в той рассматриваемой группе IOMMU и не все они назначены соответствующим гостям, вам понадобится вручную отсоединить прочие конечные точки от их хоста выполнив следующую команду, прежде чем запускать данного гостя: $ virsh nodedev-detach $ virsh nodedev-detach pci_0000_00_19_1pci_0000_00_19_1 Для получения дополнительной информации о группах IOMMU и том, как отсоединять устройства конечной точки с помощью virsh, воспользуйтесь Замечанием в разделе 17.1.1. Назначение устройства PCI при помощи virsh.

Добавление требуемого устройства

Воспользуйтесь поученным из команды virsh nodedev идентификатором в качестве значения для параметра --host-device.

virt-install \
--name=guest1-rhel7-64 \
--disk path=/var/lib/libvirt/images/guest1-rhel7-64.img,size=8 \
--vcpus=2 --ram=2048 \
--location=http://example1.com/installation_tree/RHEL7.0-Server-x86_64/os \
--nonetworks \
--os-type=linux \
--os-variant=rhel7
--host-device=pci_0000_01_00_0
 	   

Завершите установку

Завершите установку данного гостя. Необходимое устройство PCI должно подключиться к этому гостю.

Bold

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

# virsh detach-device name_of_guest file.xml
		

Повторное подключение этого устройства к его хосту (опциональное)

Если ваше устройство находится в управляемом режиме, пропустите этот шаг. Ваше устройство будет возвращено своему хосту автоматически.

Если ваше устройство не применяет режим управляемго, примените следующую команду для повторного подключения этого устройства PCI к его машине хоста:

# virsh nodedev-reattach device
		

Ваше устройство теперь доступно для его использования хостом.

Откройте экран подробностей виртуального оборудования

в virt-manager кликните дважды по той виртуальной машине, которая содержит данное устройство. Выберите кнопку Show virtual hardware details для отображения перечня виртуального оборудования.

 

Рисунок 17-7

Кнопка подробностей виртуального оборудования

Выберите и удалите требуемое устройство

Выберите то устройство PCI, которое подлежит отсоединению от данного перечня виртуальных устройств в левой панели.

 

Рисунок 17-8

Выбор устройства PCI, подлежащего отключению

Кликните по кнопке Remove для подтверждения. Данное устройство теперь доступно для применения хостом.

Включите спецификации Intel VT-d или AMD IOMMU в самом BIOS и в ядре

В системе Intel включите в BIOS Intel VT-d, если это ещё не сделано. Отсылаем вас к Процедуре 17.1. Подготовка системы Intel для назначения устройства PCI для помощи в операции включения Intel VT-d в своём BIOS и ядре.

Если Intel VT-d уже работают, пропустите этот шаг.

В системе AMD включите спецификации AMD IOMMU в вашем BIOS если они ещё не разрешены. Отсылаем вас к Процедуре 17.2. Подготовка системы AMD для назначения устройства PCI для консультации в процедуре включения IOMMU в вашем BIOS.

Проверьте поддержку

Убедитесь что конкретное устройство PCI определяется с возможностями SR-IOV. Приводимый пример перечисляет сетевые интерфейсы карты Intel 82576, которая поддерживает SR-IOV. Воспользуйтесь командой lspci для определения того, детектировано ли данное устройство.

# lspci
03:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
03:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
		

Отметим, что данный вывод был видоизменён удалением прочих устройств.

Активировать Виртуальные функции

Выполите следующую команду:

# echo ${num_vfs} > /sys/class/net/enp14s0f0/device/sriov_numvfs
		

Сделать эти Виртуальные функции постоянными

Чтобы сделать выбранную Виртуальную функцию не зависящей от перезагрузок, воспользуйтесь редактором по своему выбору чтобы создать некое правило udev аналогичное приводимому ниже, в котором вы определяете конкретный номер нужных вам VF (в этом примере 2), вплоть до того предела, который поддерживается данной картой сетевого интерфейса. В приводимом далее примере замените enp14s0f0 своим названием PF сетевого устройства и регулируется установленным ENV{ID_NET_DRIVER} значением для установления соответствия тому драйверу, который применяется:

# vim /etc/udev/rules.d/enp14s0f0.rules

ACTION=="add", SUBSYSTEM=="net", ENV{ID_NET_DRIVER}=="ixgbe", ATTR{device/sriov_numvfs}="2"
		

Это будет гарантировать, что данное свойство включается во время загрузки.

При помощи команды Проверьте полученные новые Виртуальные функции

lspci выведите перечень только что добавленных Виртуальных функций, подключённых к сетевому устройству Intel 82576 (как альтернатива, воспользуйтесь grep для поиска Virtual Function чтобы определить какие из устройств поддерживают Виртуальные функции.)

# lspci | grep 82576
0b:00.0 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
0b:00.1 Ethernet controller: Intel Corporation 82576 Gigabit Network Connection (rev 01)
0b:10.0 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:10.1 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:10.2 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:10.3 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:10.4 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:10.5 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:10.6 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:10.7 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:11.0 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:11.1 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:11.2 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:11.3 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:11.4 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
0b:11.5 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
		

Саи идентификатор для данного устройства PCI определяется в параметре -n вашей команды lspci. Все Физические функции обозначаются как 0b:00.0 и 0b:00.1. Все виртуальные функции имеют в своём определении Virtual Function.

Убедитесь в наличии устройств с помощью virsh

Служба libvirt должна распознать ваше устройство прежде чем добавить некое устройство в виртуальную машину. libvirt применяет аналогичную выводу lspci нотацию. Все симвлы пунктуации : и . в выводе lspci заменяются на нижнее подчёркивание (_).

Воспользуйтесь командой virsh nodedev-list и командой grep для фильтрации искомого сетевого устройства Intel 82576 в перечне всех доступных устройств хоста. Значением фильтра для поиска сетевых устройств Intel 82576 в данном примере является 0b. Оно может быть другим для вашей системы и может иметь результатом дополнительные устройства.

# virsh nodedev-list | grep 0b
pci_0000_0b_00_0
pci_0000_0b_00_1
pci_0000_0b_10_0
pci_0000_0b_10_1
pci_0000_0b_10_2
pci_0000_0b_10_3
pci_0000_0b_10_4
pci_0000_0b_10_5
pci_0000_0b_10_6
pci_0000_0b_11_7
pci_0000_0b_11_1
pci_0000_0b_11_2
pci_0000_0b_11_3
pci_0000_0b_11_4
pci_0000_0b_11_5
		

В приводимом перечне должны присутствовать адреса PCI для искомых Виртуальной функции и Физической функции.

Получите детализацию устройства посредством virsh

Значение pci_0000_0b_00_0 является одной Физической функцией, а pci_0000_0b_10_0 является самым первым, относящимся к Виртуальной функции для этой Физической функции. Примените команду virsh nodedev-dumpxml для получения подробностей об устройстве для обоих аппаратных средств.

# virsh nodedev-dumpxml pci_0000_03_00_0
<device>
  <name>pci_0000_03_00_0</name>
  <path>/sys/devices/pci0000:00/0000:00:01.0/0000:03:00.0</path>
  <parent>pci_0000_00_01_0</parent>
  <driver>
    <name>igb</name>
  </driver>
  <capability type='pci'>
    <domain>0</domain>
    <bus>3</bus>
    <slot>0</slot>
    <function>0</function>
    <product id='0x10c9'>82576 Gigabit Network Connection</product>
    <vendor id='0x8086'>Intel Corporation</vendor>
    <capability type='virt_functions'>
      <address domain='0x0000' bus='0x03' slot='0x10' function='0x0'/>
      <address domain='0x0000' bus='0x03' slot='0x10' function='0x2'/>
      <address domain='0x0000' bus='0x03' slot='0x10' function='0x4'/>
      <address domain='0x0000' bus='0x03' slot='0x10' function='0x6'/>
      <address domain='0x0000' bus='0x03' slot='0x11' function='0x0'/>
      <address domain='0x0000' bus='0x03' slot='0x11' function='0x2'/>
      <address domain='0x0000' bus='0x03' slot='0x11' function='0x4'/>
    </capability>
    <iommuGroup number='14'>
      <address domain='0x0000' bus='0x03' slot='0x00' function='0x0'/>
      <address domain='0x0000' bus='0x03' slot='0x00' function='0x1'/>
    </iommuGroup>
  </capability>
</device>

# virsh nodedev-dumpxml pci_0000_03_11_5
<device>
  <name>pci_0000_03_11_5</name>
  <path>/sys/devices/pci0000:00/0000:00:01.0/0000:03:11.5</path>
  <parent>pci_0000_00_01_0</parent>
  <driver>
    <name>igbvf</name>
  </driver>
  <capability type='pci'>
    <domain>0</domain>
    <bus>3</bus>
    <slot>17</slot>
    <function>5</function>
    <product id='0x10ca'>82576 Virtual Function</product>
    <vendor id='0x8086'>Intel Corporation</vendor>
    <capability type='phys_function'>
      <address domain='0x0000' bus='0x03' slot='0x00' function='0x1'/>
    </capability>
    <iommuGroup number='35'>
      <address domain='0x0000' bus='0x03' slot='0x11' function='0x5'/>
    </iommuGroup>
  </capability>
</device>
		

Данный пример добавляет необходимую Виртуальную функцию pci_0000_03_10_2 в определяемую виртуальную машину на шаге 8. Обратим внимание на параметры bus, slot и function: они необходимы для добавления данного устройства.

Скопируйте эти параметры во временный файл XML, скажем, такой как /tmp/new-interface.xml.

<interface type='hostdev' managed='yes'>
  <source>
    <address type='pci' domain='0x0000' bus='0x03' slot='0x10' function='0x2'/>
  </source>
</interface>
		

Замечание

Когда запускается данная виртуальная машина, она должна видеть некое сетевое устройство с определяемым типом, который предоставляется его физическим адаптером, причём с настроенным MAC адресом. Это MAC адрес будет оставаться неизменным при перезагрузках хоста и гостя. Следующий пример <interface> отображает необходимый синтаксис для опциональных элементов <mac address>, <virtualport> и <vlan>. На практике применяйте либо значение элемента <vlan>, либо значение элемента <virtualport>, а не оба одновременно, как это отображено в приводимом примере: ... <devices> ... <interface type='hostdev' managed='yes'> <source> <address type='pci' domain='0' bus='11' slot='16' function='0'/> </source> <mac address='52:54:00:6d:90:02'> <vlan> <tag id='42'/> </vlan> <virtualport type='802.1Qbh'> <parameters profileid='finance'/> </virtualport> </interface> ... </devices> Если вы не определили MAC адрес, он будет выработан автоматически. Значение элемента <virtualport> применяется только при соединении с неким аппаратным коммутатором 802.11Qbh. Значение элемента <vlan> будет прозрачно помещено в устройство гостя в соответствующий VLAN с тегом 42.

Добавление этой Виртуальной функции в вашу виртуальную машину

Добавьте полученную Виртуальную функцию в свою виртуальную машину применив показанную ниже команду с тем временным файлом, который создан на предыдущем шаге. Это приведёт к немедленному подключению нового устройства и сохранит его для последующих перезапусков гостя.

virsh attach-device MyGuest /tmp/new-interface.xml --live --config
		

Определение опции --live в virsh attach-device подключает необходимое новое устройство к такому исполняемому гостю. Применение опции --config обеспечит что такое новое устройство остаётся доступным после последующих перезапусков гостя.

	Замечание
	Jgwbz --live применяется только когда этот гость исполняется. virsh вернёт некую ошибку если данная опция --live применятеся при не исполняемом госте.

Выборка информации

Чтобы применить <interface type='hostdev'>, вам требуется иметь некую сетевую карту с возможностями SR-IOV, оборудование физической машины хоста, которое поддерживает расширения либо Intel VT-d, либо AMD IOMMU, а также вы должны знать тот адрес PCI вашей VF, которую вы желаете назначать.

Остановите свою гостевую виртуальную машину

При помощи команды virsh shutdown AppA.html#11">остановите свою гостеую виртуальную машину (в нашем случае именуемую как guestVM).

# virsh shutdown guestVM
		

Для внесения изменений откройте соответствующий файл XML

Выполните команду virsh save-image-edit чтобы открыть необходимый для редактирования файл (для получения дополнительной информации обратитесь к разделу 21.7.5 Изменение настрек вашей гостевой виртуальной машины) с опцией --running. В данном примере названием вашего файла настроки является guestVM.xml.

# virsh save-image-edit guestVM.xml --running
		

Этот файл guestVM.xml откроется в вашем редакторе по умолчанию.

Изменение вашего файла XML

Обновите свой файл настройки guestVM.xml чтобы получить некую запись <devices> со следующим содержимым:

<devices>
  ...
  <interface type='hostdev' managed='yes'>
    <source>
      <address type='pci' domain='0x0' bus='0x00' slot='0x07' function='0x0'/> <!--эти значения также могут быть десятичными-->
    </source>
    <mac address='52:54:00:6d:90:02'/>
<!--установки mac адреса-->
    <virtualport type='802.1Qbh'>
<!--установки виртуального порта для коммутатора 802.1Qbh-->
      <parameters profileid='finance'/>
    </virtualport>
    <vlan>
<!--установки тега vlan-->
      <tag id='42'/>
    </vlan>
  </interface>
  ...
</devices>
		Образец домена XML для интерфеса типа hostdev

Заметим, что если вы не предоставите какой- то MAC адрес, он будет выработан автоматически, в точности как если бы это было с любым другим типом устройства интерфейса, значение элемента <virtualport> используется только если вы подключениы к некому аппаратному коммутатору 802.11Qgh. Коммутаторы 802.11Qbg (также именуемые как "VEPA") в настоящее время не поддерживаются.

Перезапустите свою гостевую виртуальную машину

Выполните команду virsh start для перезапуска своей гостевой виртуальной машины, которую вы остановили на шаге 2. Для получения дополнительной информации обратитесь к разделу Запуск, приостановка и возобновление виртуальной машины.

# virsh start guestVM
		

Когда ваша гостевая виртуальная машина запустится, она обнаружит предоставленное её сетевое устройство со стороны адаптера своей физической машины хоста, причём с настроенным MAC адресом. Этот MAC адрес будет оставаться неизменным при перезагрузках гостевой виртуальной машины и физической машины хоста.

Остановите свою гостевую виртуальную машину

При помощи команды virsh shutdown остановите свою гостеую виртуальную машину здесь мы именуем её как guestVM).

# virsh shutdown guestVM
		

Создайте файл настройки

Воспользуйтесь предпочитаемым вами редактором, создайте некий файл XML (например, с названием passthrough.xml в своёмс каталоге /tmp. Убедитесь в том, что вы заменили pf dev='eth3' названием сетевого устройства своей собственной Физической функции (PF, Physical Function) устройства SR-IOV.

Ниже приводтся пример сетевого определения, который сделает доступным некий пул всех VF для определённого адаптера SR-IOV с его PF "eth3" в физической машине хоста:

<network>
<name>passthrough</name> <!-- Это название создаваемого вами файла -->
  <forward mode='hostdev' managed='yes'>
    <pf dev='myNetDevName'/> <!-- Здесь используйте своё имя сетевого устройства для вашей PF оборудования SR-IOV -->
  </forward>
</network>
		

Загрузите полученный новый файл XML

Введите следующую команду, заменив в ней /tmp/passthrough.xml своим названием и местоположением вашего файла XML, который вы создали на предыдущем шаге:

# virsh net-define /tmp/passthrough.xml
		

Перезапустите этого гостя

Выполните следующую команду, заменив passthrough.xml названием вашего файла XML, созданного на предыдущих шагах:

# virsh net-autostart passthrough # virsh net-start passthrough
		

Перезапустите эту гостевую виртуальную машину

Выполните команду virsh start для перезапуска своей гостевой виртуальной машины, которую вы остановили на первом шаге (в данном примере в качестве доменного имени такой гостевой виртуальной машины применяется guestVM). Для получения дополнительной информации обратитесь к разделу Запуск, приостановка и возобновление виртуальной машины.

# virsh start guestVM
		

Инициализация проброса для устройств

Хотя показано только одно устройство, libvirt автоматически выведет список всех связанных с этим PF VF при первом запуске гостевой виртуальной машины с определением интерфейса в своем домене XML как показано ниже:

<interface type='network'>
  <source network='passthrough'>
</interface>
		

Проверка

Вы можете выполнить проверку исполнив команду virsh net-dumpxml passthrough после запуска вашего гостя, который использует эту сеть; вы получите вывод, аналогичный следующему:

<network connections='1'>
  <name>passthrough</name>
  <uuid>a6b49429-d353-d7ad-3185-4451cc786437</uuid>
  <forward mode='hostdev' managed='yes'>
    <pf dev='eth3'/>
    <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x1'/>
    <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x3'/>
    <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x5'/>
    <address type='pci' domain='0x0000' bus='0x02' slot='0x10' function='0x7'/>
    <address type='pci' domain='0x0000' bus='0x02' slot='0x11' function='0x1'/>
    <address type='pci' domain='0x0000' bus='0x02' slot='0x11' function='0x3'/>
    <address type='pci' domain='0x0000' bus='0x02' slot='0x11' function='0x5'/>
  </forward>
</network>
		

Подготовьте гостевую виртуальную машину.

Добавьте следующую вставку кода в файл домена XML своей гостевой виртуальной машины:

<redirdev bus='usb' type='spicevmc'>
  <alias name='redir0'/>
  <address type='usb' bus='0' port='3'/>
</redirdev>
<redirfilter>
  <usbdev class='0x08' vendor='0x1234' product='0xBEEF' version='2.0' allow='yes'/>
  <usbdev class='-1' vendor='-1' product='-1' version='-1' allow='no'/>
</redirfilter>
 	   

Запустите свою гостевую виртуальную машину и убедитесь в изменении установок выполнив следующее:

#ps -ef | grep $guest_name

-device usb-redir,chardev=charredir0,id=redir0,/ filter=0x08:0x1234:0xBEEF:0x0200:1|-1:-1:-1:-1:0,bus=usb.0,port=3
		

Подключите некое устройство USB в физическую машину хоста и воспользуйтесь virt-manager для его подключения в соответствующую гостевую виртуальную машину.

Кликните по USB device selection в полученном меню, что выведет следующее сообщение "Some USB devices are blocked by host policy" (некоторые USB устройства блокируются политикой хоста). Кликните OK для подтверждения и продолжения.

Этот фильтр приступит к работе.

Чтобы убедиться что данный фильтр прехватывает как надо проверку названий производителя USB и самого продукта, затем внестите такие изменения в XML домена своей физической машины хоста чтобы разрешить перенаправление USB.

<redirfilter>
  <usbdev class='0x08' vendor='0x0951' product='0x1625' version='2.0' allow='yes'/>
  <usbdev allow='no'/>
</redirfilter>
 	   

Перезапустите эту гостевую виртуальную машину, затем воспользуйтесь virt-viewer для подключения к этой гостевой виртуальной машине. Данное устройство USB теперь переправляет обмен в эту гостевую виртуальную машину.

Остановите гостевую виртуальную машину.

Выберите нужную гостевую виртуальную машину и из её меню Edit остановитесь на Virtual Machine Details чтобы открыть окно Details для специфицируемой гостевой виртуальной машины.

Кликните по кнопке Add Hardware.

В окне Add New Virtual Hardware выберите RNG для открытия окна Random Number Generator.

 

Рисунок 17-20

Окно генератора случайного номера

Введите нужные параметры и кликните RNG по завершению. Все параметры объясняются в разделе Элементы virtio-rng.

Остановите гостевую виртуальную машину.

Воспользовавшись командой virsh edit domain-name откройте необходимый файл XML для нужной вам гостевой виртуальной машины.

Измените соответствующий элемент <devices> с тем, чтобы он содержал следующее:

...
<devices>
  <rng model='virtio'>
    <rate period='2000' bytes='1234'/>
    <backend model='random'>/dev/random</backend>
    <!-- ИЛИ -->
    <backend model='egd' type='udp'>
      <source mode='bind' service='1234'/>
      <source mode='connect' host='1.2.3.4' service='1234'/>
    </backend>
  </rng>
</devices>
...
 	   

Включите поддержку IOMMU в ядре физической машины хоста

Для систем Intel VT-d это делается путём добавления параметров intel_iommu=on и iommu=pt в её командную строку ядра. Для систем AMD-Vi это опция amd_iommu=pt. Для включения данной опции измените или добавьте необходимую строку GRUB_CMDLINX_LINUX в файле настройки /etc/sysconfig/grub следующим образом:

GRUB_CMDLINE_LINUX="rd.lvm.lv=vg_VolGroup00/LogVol01 vconsole.font=latarcyrheb-sun16 rd.lvm.lv=vg_VolGroup_1/root vconsole.keymap=us $([ -x /usr/sbin/rhcrashkernel-param ] && /usr/sbin/rhcrashkernel-param || :) rhgb quiet intel_iommu=on iommu=pt"
 	   

	Замечание
	Для получения дополнительной информации по IOMMU обратитесь к Дополнению D. Работа с группами IOMMU .

Сгенерируйте новую настройку начального загрузчика

Регенерируйте настройку своего начального загрузчика с помощью grub2-mkconfig чтобы включить установленные опции, исполнив следующую команду:

# grub2-mkconfig -o /etc/grub2.cfg
		

Заметим, что если вы применяете хост на основе UEFI, целью должен быть /etc/grub2-efi.cfg.

Перезагрузите физическую машину ввашего хоста

Чтобы все изменённые опции вступили в действие, перезагрузите физическую машину своего хоста с помощью следующей команды:

# reboot
		

Определение одреса на шине PCI

Чтобы определить установленный адрес шины PCI и идентификатор определённого устройства, исполните следующую команду lspci. В данном примере применяется VGA контроллер подобный карте Quadro или GRID следующим образом:

# lspci -Dnn | grep VGA
0000:02:00.0 VGA compatible controller [0300]: NVIDIA Corporation GK106GL [Quadro K4000] [10de:11fa] (rev a1)
		

{Прим. пер.: рекомендуем слегка расширенный grep -A 2 -E "(VGA| 3D)". Для установки pciutils воспользуйтесь yum -y install pciutils} Результат поиска выведает что PCI адрес данного устройства установлен в значение 0000:02:00.0, а идентификатором PCI для данного устройства является 10de:11fa

Предотвратите применение необходимого вам устройства GPU от его епстественного использования физической машиной хоста

Чтобы уберечь использование настраиваемого устройства GPU натуральным драйвером физической машины хоста вы можете применить идентификатор PCI с имеющимся драйвером pci-stub. Для этого добавьте в конец GRUB_CMDLINX_LINUX файла настройки, расположенного в /etc/grub2-efi.cfg, следующую дополнительную опцию:

pci-stub.ids=10de:11fa
		

Для добавления дополнительных идентификаторов PCI в pci-stub отделяйте их запятой. {Прим. пер.: также рекомендуем перечислить устройства GPU в чёрном списке:}

ls /etc/modprobe.d/blacklist.conf
echo "blacklist nouveau" >> /etc/modprobe.d/blacklist.conf
echo "blacklist nvidia" >> /etc/modprobe.d/blacklist.conf
echo "blacklist radeon" >> /etc/modprobe.d/blacklist.conf
cat /etc/modprobe.d/blacklist.conf
		

Регенерируйте настройку своего начального загрузчика с помощью grub2-mkconfig чтобы включить установленные опции, исполнив следующую команду:

# grub2-mkconfig -o /etc/grub2.cfg
		

Заметим, что если вы применяете хост на основе UEFI, целью должен быть /etc/grub2-efi.cfg.

Перезагрузите физическую машину ввашего хоста

Чтобы все изменённые опции вступили в действие, перезагрузите физическую машину своего хоста с помощью следующей команды:

# reboot