14.7. 在虚拟机中管理 PCI 设备

1. 获取您要使用的设备的 PCI 地址标识符。例如，如果要使用附加到主机的 NVME 磁盘，以下输出将其显示为设备 0000:65:00.0。

   # lspci -nkD
   
   0000:00:00.0 0600: 8086:a708 (rev 01)
   	Subsystem: 17aa:230e
   	Kernel driver in use: igen6_edac
   	Kernel modules: igen6_edac
   0000:00:02.0 0300: 8086:a7a1 (rev 04)
   	Subsystem: 17aa:230e
   	Kernel driver in use: i915
   	Kernel modules: i915, xe
   0000:00:04.0 1180: 8086:a71d (rev 01)
   	Subsystem: 17aa:230e
   	Kernel driver in use: proc_thermal_pci
   	Kernel modules: processor_thermal_device_pci
   0000:00:05.0 0604: 8086:a74d (rev 01)
   	Subsystem: 17aa:230e
   	Kernel driver in use: pcieport
   0000:00:07.0 0604: 8086:a76e (rev 01)
   	Subsystem: 17aa:230e
   	Kernel driver in use: pcieport
   0000:65:00.0 0108: 144d:a822 (rev 01)
       DeviceName: PCIe SSD in Slot 0 Bay 2
       Subsystem: 1028:1fd9
       Kernel driver in use: nvme
       Kernel modules: nvme
   0000:6a:00.0 0108: 1179:0110 (rev 01)
       DeviceName: PCIe SSD in Slot 11 Bay 2
       Subsystem: 1028:1ffb
       Kernel driver in use: nvme
       Kernel modules: nvme

2. 打开您要向其附加 PCI 设备的虚拟机的 XML 配置。

   # virsh edit vm-name

3. 将以下 <hostdev> 配置添加到 XML 文件的 <devices> 部分。

   将 address 行上的值替换为设备的 PCI 地址。另外，要更改虚拟机中使用的 PCI 地址，您可以在 < address type="pci "> 行中配置不同的地址。

   例如，如果主机上的设备地址为 0000:65:00.0，并且您希望它在客户机中使用 0000:02:00.0，请使用以下配置：

   <hostdev mode="subsystem" type="pci" managed="yes">
     <driver name="vfio"/>
      <source>
       <address domain="0x0000" bus="0x65" slot="0x00" function="0x0"/>
      </source>
      <address type="pci" domain='0x0000' bus='0x02' slot='0x00' function='0x0'/>
   </hostdev>

4. 可选：在 IBM Z 主机上，您可以修改客户端操作系统如何检测 PCI 设备。要做到这一点，将 < zpci> 子元素添加到 < address> 元素。在 <zpci> 行中，您可以调整 uid 和 fid 值，这会修改客户机操作系统中设备的 PCI 地址和功能 ID。

   <hostdev mode="subsystem" type="pci" managed="yes">
     <driver name="vfio"/>
      <source>
       <address domain="0x0000" bus="0x65" slot="0x00" function="0x0"/>
      </source>
      <address type="pci" domain='0x0000' bus='0x02' slot='0x00' function='0x0'>
        <zpci uid="0x0008" fid="0x001807"/>
      </address>
   </hostdev>

   在本例中：

   • uid="0x0008" 将虚拟机中设备的域 PCI 地址设置为 0008:00:00.0。

   • fid="0x001807" 将设备的插槽值设置为 0x001807。因此，虚拟机的文件系统中的设备配置被保存到 /sys/bus/pci/slots/00001087/address 中。

     如果没有指定这些值，libvirt 会自动配置它们。

5. 保存 XML 配置。

6. 如果虚拟机正在运行，请将其关闭。

   # virsh shutdown vm-name

验证

1. 启动虚拟机，并登录到其客户机操作系统。

2. 在客户端操作系统中，确认是否列出了 PCI 设备。

   例如，如果您将客户机设备地址配置为 0000:02:00.0，请使用以下命令：

   # lspci -nkD | grep 0000:02:00.0
   
   0000:02:00.0 8086:9a09 (rev 01)

流程

1. 登录到 RHEL 9 web 控制台。

   详情请参阅 登录到 web 控制台。

2. 在 Virtual Machines 接口中，点击您要给其附加主机设备的虚拟机。

   这会打开一个新页面，其中包含有关所选虚拟机基本信息的 概述，以及访问虚拟机图形界面的 控制台 部分。

3. 滚动到 Host devices。

   主机设备 部分显示有关附加到虚拟机的设备的信息，以及 A添加 或 删除 设备的选项。

   

4. 点击 Add host device。

   此时会出现 Add host device 对话框。

   
5. 选择您要附加到虚拟机的设备。

6. 点 添加

   所选设备被附加到虚拟机。

流程

1. 在附加 PCI 设备的虚拟机的 XML 配置中，使用设备的设置在 < hostdev&gt ; 部分找到 < address domain > 行。

   # virsh dumpxml <VM-name>
   
   [...]
   <hostdev mode='subsystem' type='pci' managed='yes'>
     <source>
       <address domain='0x0000' bus='0x65' slot='0x00' function='0x0'/>
     </source>
     <address type='pci' domain='0x0000' bus='0x02' slot='0x00' function='0x0'/>
   </hostdev>
   [...]

2. 使用 virsh detach-device 命令及 the-- hostdev 选项和设备地址。

   例如，以下命令会永久删除上一步中的设备。

   # virt detach-device <VM-name> --hostdev 0000:65:00.0 --config
   Domain 'VM-name' defined successfully.

   注意

   要从正在运行的虚拟机中删除 PCI 设备，请在上一个命令中添加 - live 参数。

3. 可选：将 PCI 设备重新附加到主机。例如，以下命令重新附加从上一步中虚拟机中删除的设备：

   # virsh nodedev-reattach pci_0000_65_00_0
   Device pci_0000_65_00_0 re-attached

验证

1. 再次显示虚拟机的 XML 配置，检查设备的 < hostdev& gt; 部分是否不再显示。

   # virsh dumpxml <VM-name>

流程

1. 在 Virtual Machines 接口中，点击您要从中删除主机设备的虚拟机。

   这会打开一个新页面，其中包含有关所选虚拟机基本信息的 概述，以及访问虚拟机图形界面的 控制台 部分。

2. 滚动到 Host devices。

   主机设备 部分显示有关附加到虚拟机的设备的信息，以及 A添加 或 删除 设备的选项。

   

3. 点击您要从虚拟机中删除设备旁边的 Remove 按钮。

   此时会出现删除设备确认对话框。

   

4. 点击 Remove。

   该设备从虚拟机中删除。