11.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 デバイスを検出する方法を変更できます。これを行うには、<address> 要素に <zpci> サブ要素を追加します。<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 8 Web コンソールにログインします。

   詳細は、Web コンソールへのログイン を参照してください。

2. Virtual Machines インターフェイスで、ホストデバイスを接続する仮想マシンをクリックします。

   新しいページが開き、選択した仮想マシンに関する基本情報を含む Overview セクションと、仮想マシンのグラフィカルインターフェイスにアクセスするための Console セクションが表示されます。

3. Host devices までスクロールします。

   Host devices セクションには、仮想マシンに接続されているデバイスに関する情報と、デバイスを 追加 または 削除 するためのオプションが表示されます。

   

4. ホストデバイスの追加 をクリックします。

   ホストデバイスの追加 ダイアログが表示されます。

   
5. VM に接続するデバイスを選択します。

6. 追加 をクリックします。

   選択したデバイスが仮想マシンに接続されます。

手順

1. PCI デバイスが割り当てられている仮想マシンの XML 設定で、デバイスの設定がある <hostdev> セクションの <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. --hostdev オプションとデバイスアドレスを指定した virsh detach-device コマンドを使用します。

   たとえば、次のコマンドは、前のステップで見つかったデバイスを永続的に削除します。

   # 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> セクションが表示されなくなっていることを確認します。

   # virsh dumpxml <VM-name>

手順

1. Virtual Machines インターフェイスで、ホストデバイスを削除する仮想マシンをクリックします。

   新しいページが開き、選択した仮想マシンに関する基本情報を含む Overview セクションと、仮想マシンのグラフィカルインターフェイスにアクセスするための Console セクションが表示されます。

2. Host devices までスクロールします。

   Host devices セクションには、仮想マシンに接続されているデバイスに関する情報と、デバイスを 追加 または 削除 するためのオプションが表示されます。

   

3. VM から削除するデバイスの横にある 削除 ボタンをクリックします。

   デバイスの削除確認ダイアログが表示されます。

   

4. 削除 をクリックします。

   デバイスが VM から削除されます。