15 使用 virsh 配置虚拟机 #

1. 打开 VM Guest 的 XML 配置。

   tux > sudo virsh edit sles15

2. 更改可引导设备的顺序。

   ...
   <boot dev='cdrom'/>
   <boot dev='hd'/>
   ...

3. 通过查看 VM Guest 的 BIOS 中的引导菜单来检查引导顺序是否已更改。

1. 打开 VM Guest 的 XML 配置：

   tux > sudo virsh edit sles15

2. 在 os 元素中，添加 kernel 元素以及主机上内核文件的路径：

   ...
   <kernel>/root/f8-i386-vmlinuz</kernel>
   ...

3. 添加 initrd 元素以及主机上 initrd 文件的路径：

   ...
   <initrd>/root/f8-i386-initrd</initrd>
   ...

4. 启动 VM 以从新内核引导：

   tux > sudo virsh start sles15

1. 在装载驱动程序之前，请运行 lspci 来确保可正常检测到网卡。下面的示例显示了双端口 Intel 82576NS 网卡的 lspci 输出：

   tux > sudo /sbin/lspci | grep 82576
   01:00.0 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)
   01:00.1 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)
   04:00.0 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)
   04:00.1 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)

   如果未检测到网卡，可能是因为未在 BIOS/EFI 中启用硬件虚拟化支持。要检查是否已启用硬件虚拟化支持，请查看主机 BIOS 中的设置。

2. 运行 lsmod 来检查是否已装载 SR-IOV 驱动程序。在下面的示例中，用于检查是否装载了 Intel 82576NS 网卡的 igb 驱动程序的命令返回了一条结果。这表示已装载该驱动程序。如果该命令未返回任何结果，则表示未装载该驱动程序。

   tux > sudo /sbin/lsmod | egrep "^igb "
   igb                   185649  0

3. 如果已装载驱动程序，请跳过以下步骤。如果尚未装载 SR-IOV 驱动程序，需要先去除非 SR-IOV 驱动程序，然后再装载新驱动程序。使用 rmmod 卸载驱动程序。下面的示例会卸载 Intel 82576NS 网卡的非 SR-IOV 驱动程序：

   tux > sudo /sbin/rmmod igbvf

4. 随后使用 modprobe 命令装载 SR-IOV 驱动程序 — 必须指定 VF 参数 (max_vfs)：

   tux > sudo /sbin/modprobe igb max_vfs=8

1. 通过列出以太网设备确定物理 NIC 的 PCI ID：

   tux > sudo lspci | grep Eth
   06:00.0 Ethernet controller: Emulex Corporation OneConnect NIC (Skyhawk) (rev 10)
   06:00.1 Ethernet controller: Emulex Corporation OneConnect NIC (Skyhawk) (rev 10)

2. 要启用 VF，请向 sriov_numvfs 参数回送需要装载的 VF 数量：

   tux > sudo echo 1 > /sys/bus/pci/devices/0000:06:00.1/sriov_numvfs

3. 校验是否已装载 VF NIC：

   tux > sudo lspci | grep Eth
   06:00.0 Ethernet controller: Emulex Corporation OneConnect NIC (Skyhawk) (rev 10)
   06:00.1 Ethernet controller: Emulex Corporation OneConnect NIC (Skyhawk) (rev 10)
   06:08.0 Ethernet controller: Emulex Corporation OneConnect NIC (Skyhawk) (rev 10)

4. 获取可用 VF 的最大数量：

   tux > sudo lspci -vvv -s 06:00.1 | grep 'Initial VFs'
                          Initial VFs: 32, Total VFs: 32, Number of VFs: 0,
   Function Dependency Link: 01

5. 创建 /etc/systemd/system/before.service 文件，用于在引导时通过 SYSFS 装载 VF：

   [Unit]
   Before=
   [Service]
   Type=oneshot
   RemainAfterExit=true
   ExecStart=/bin/bash -c "echo 1 > /sys/bus/pci/devices/0000:06:00.1/sriov_numvfs"
   # beware, executable is run directly, not through a shell, check the man pages
   # systemd.service and systemd.unit for full syntax
   [Install]
   # target in which to start the service
   WantedBy=multi-user.target
   #WantedBy=graphical.target

6. 在启动 VM 之前，需要创建指向 /etc/init.d/after.local 脚本（用于分离 NIC）的另一个服务文件 (after-local.service)。否则 VM 将无法启动：

   [Unit]
   Description=/etc/init.d/after.local Compatibility
   After=libvirtd.service
   Requires=libvirtd.service
   [Service]
   Type=oneshot
   ExecStart=/etc/init.d/after.local
   RemainAfterExit=true
   
   [Install]
   WantedBy=multi-user.target

7. 将此文件复制到 /etc/systemd/system。

   #! /bin/sh
   # ...
   virsh nodedev-detach pci_0000_06_08_0

   将它另存为 /etc/init.d/after.local。

8. 重引导计算机，然后根据本过程的第一步所述，重新运行 lspci 命令检查是否已装载 SR-IOV 驱动程序。如果已成功装载 SR-IOV 驱动程序，您应该会看到额外的 VF 行：

   01:00.0 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)
   01:00.1 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)
   01:10.0 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   01:10.1 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   01:10.2 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   [...]
   04:00.0 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)
   04:00.1 Ethernet controller: Intel Corporation 82576NS Gigabit Network Connection (rev 01)
   04:10.0 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   04:10.1 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   04:10.2 Ethernet controller: Intel Corporation 82576 Virtual Function (rev 01)
   [...]

下面的过程使用的是示例数据。请务必将其替换为您设置中的相应数据。

1. 使用 virsh nodedev-list 命令获取您要指派的 VF 的 PCI 地址及其对应的 PF。第 15.9.2 节 “装载和配置 SR-IOV 主机驱动程序”中所示的 lspci 输出中的数字值（例如 01:00.0 或 04:00.1）已经过转换：添加了前缀“pci_0000_”并将冒号和句点替换为下划线。因此，lspci 列出的 PCI ID“04:00.0”会被 virsh 列为“pci_0000_04_00_0”。下面的示例列出了 Intel 82576NS 网卡的第二个端口的 PCI ID：

   tux > sudo virsh nodedev-list | grep 0000_04_
   pci_0000_04_00_0
   pci_0000_04_00_1
   pci_0000_04_10_0
   pci_0000_04_10_1
   pci_0000_04_10_2
   pci_0000_04_10_3
   pci_0000_04_10_4
   pci_0000_04_10_5
   pci_0000_04_10_6
   pci_0000_04_10_7
   pci_0000_04_11_0
   pci_0000_04_11_1
   pci_0000_04_11_2
   pci_0000_04_11_3
   pci_0000_04_11_4
   pci_0000_04_11_5

   前两个项表示 PF，其他项表示 VF。

2. 对您要添加的 VF 的 PCI ID 运行以下 virsh nodedev-dumpxml 命令：

   tux > sudo virsh nodedev-dumpxml pci_0000_04_10_0
   <device>
     <name>pci_0000_04_10_0</name>
     <parent>pci_0000_00_02_0</parent>
     <capability type='pci'>
       <domain>0</domain>
       <bus>4</bus>
       <slot>16</slot>
       <function>0</function>
       <product id='0x10ca'>82576 Virtual Function</product>
       <vendor id='0x8086'>Intel Corporation</vendor>
       <capability type='phys_function'>
         <address domain='0x0000' bus='0x04' slot='0x00' function='0x0'/>
       </capability>
     </capability>
   </device>

   下一步需要以下数据：

   • <domain>0</domain>

   • <bus>4</bus>

   • <slot>16</slot>

   • <function>0</function>

3. 创建一个临时 XML 文件（例如 /tmp/vf-interface.xml），其中包含将 VF 网络设备添加到现有 VM Guest 所需的数据。该文件至少需包含如下所示的内容：

   <interface type='hostdev'>1
    <source>
     <address type='pci' domain='0' bus='11' slot='16' function='0'2/>2
    </source>
   </interface>

   1	VF 的 MAC 地址不固定；每次重引导主机后，MAC 地址都会改变。如果以“传统”方式使用 hostdev添加网络设备，每次重引导主机后都需要重新配置 VM Guest 的网络设备，因为 MAC 地址会改变。为了避免此类问题，libvirt 引入了 hostdev 值，该值可以在指派设备之前设置网络特定的数据。
   2	请在此处指定上一步中获取的数据。

4. 如果设备已挂接到主机，则无法将它挂接到 VM Guest。要使该设备可供 Guest 使用，请先将它从主机分离：

   tux > sudo virsh nodedev-detach pci_0000_04_10_0

5. 将 VF 接口添加到现有 VM Guest：

   tux > sudo virsh attach-device GUEST /tmp/vf-interface.xml --OPTION

   需将 GUEST 替换为 VM Guest 的域名、ID 或 UUID。--OPTION 可为下列其中一项：

   --persistent

   此选项始终将设备添加到域的永久性 XML 中。此外，如果域正在运行，则会热插入设备。

   --config

   此选项只影响永久性 XML，即使域正在运行也是如此。设备在下次引导后才会显示在 VM Guest 中。

   --live

   此选项只影响运行中的域。如果域处于非活动状态，则操作将会失败。设备不会永久保留在 XML 中，因此其下次引导后在 VM Guest 中将不可用。

   --current

   此选项影响域的当前状态。如果域处于非活动状态，设备将添加到永久性 XML 中，因此其下次引导后仍可用。如果域处于活动状态，则会热插入设备，但不会将其添加到永久性 XML 中。

6. 要分离 VF 接口，请使用 virsh detach-device 命令，该命令也接受上面所列的选项。

1. 编辑现有 VM Guest 的配置：

   tux > sudo virsh edit sles15

2. 更改分配的 VRAM 大小：

   <video>
   <model type='vga' vram='65535' heads='1'>
   ...
   </model>
   </video>

3. 通过查看虚拟机管理器中的数量来检查 VM 中的 VRAM 量是否已更改。

1. 编辑现有 VM Guest 的配置：

   tux > sudo virsh edit sles15

2. 要启用/禁用 2D/3D 加速，请相应地更改 accel3d 和 accel2d 的值：

   <video>
   <acceleration accel3d='yes' accel2d='no'>
   ...
   </model>
   </video>