第16章 仮想マシンでの GPU デバイスの管理

手順

1. ドライバーが GPU にバインドしないようにします。

   1. GPU の接続先である PCI バスアドレスを特定します。

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

   2. ホストのグラフィックドライバーが GPU を使用しないようにします。これには、pci-stub ドライバーで GPU の PCI ID を使用します。

      たとえば、次のコマンドは、ドライバーが10de: 11fa バスに接続されている GPU にバインドしないようにします。

      # grubby --args="pci-stub.ids=10de:11fa" --update-kernel DEFAULT

   3. ホストを再起動します。

2. オプション: サポートの制限により、オーディオなどの特定の GPU 機能を仮想マシンにパススルーできない場合は、IOMMU グループ内のエンドポイントのドライバーバインディングを変更すると、必要な GPU 機能のみをパススルーできます。

   1. GPU 設定を XML に変換し、ホストドライバーに接続しないようにするエンドポイントの PCI アドレスを書き留めておきます。

      これを行うには、アドレスに pci_ 接頭辞を追加し、区切り文字をアンダースコアに変換することにより、GPU の PCI バスアドレスを libvirt 互換形式に変換します。

      たとえば、次のコマンドは、0000:02:00.0 バスアドレスに接続されている GPU の XML 設定を表示します。

      # virsh nodedev-dumpxml pci_0000_02_00_0

      <device>
       <name>pci_0000_02_00_0</name>
       <path>/sys/devices/pci0000:00/0000:00:03.0/0000:02:00.0</path>
       <parent>pci_0000_00_03_0</parent>
       <driver>
        <name>pci-stub</name>
       </driver>
       <capability type='pci'>
        <domain>0</domain>
        <bus>2</bus>
        <slot>0</slot>
        <function>0</function>
        <product id='0x11fa'>GK106GL [Quadro K4000]</product>
        <vendor id='0x10de'>NVIDIA Corporation</vendor>
        <iommuGroup number='13'>
         <address domain='0x0000' bus='0x02' slot='0x00' function='0x0'/>
         <address domain='0x0000' bus='0x02' slot='0x00' function='0x1'/>
        </iommuGroup>
        <pci-express>
         <link validity='cap' port='0' speed='8' width='16'/>
         <link validity='sta' speed='2.5' width='16'/>
        </pci-express>
       </capability>
      </device>

   2. エンドポイントがホストドライバーに接続されないようにします。

      この例では、GPU を仮想マシンに割り当て、オーディオ機能である <address domain='0x0000' bus='0x02' slot='0x00' function='0x1'/> に対応するエンドポイントがホストオーディオドライバーに接続されないようにし、代わりにエンドポイントを VFIO-PCI に接続します。

      # driverctl set-override 0000:02:00.1 vfio-pci

3. GPU の仮想マシンへの接続

   1. PCI バスアドレスを使用して GPU 用の XML 設定ファイルを作成します。

      たとえば、GPU のバスアドレスからパラメーターを使用して、次の XML ファイル GPU-Assign.xml を作成できます。

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

   2. ホストシステムにファイルを保存します。

   3. ファイルを仮想マシンの XML 設定とマージします。

      たとえば、次のコマンドは、GPU XML ファイルの GPU-Assign.xml を、System1 仮想マシンの XML 設定ファイルにマージします。

      # virsh attach-device System1 --file /home/GPU-Assign.xml --persistent
      Device attached successfully.

      注記

      GPU は、セカンダリーグラフィックスデバイスとして仮想マシンに接続されています。GPU をプライマリーグラフィックスデバイスとして割り当てることには対応していません。Red Hat では、仮想マシンの XML 設定で、エミュレートしているプライマリーグラフィックスデバイスを削除することは推奨しません。