14.10. 仮想マシンの SCSI パススルーの設定

手順

1. 仮想マシンの XML 設定を開きます。

   # virsh edit <vm_name>

2. <devices> セクションに、VirtIO-SCSI コントローラーの行を追加します (まだない場合)。

   <controller type='scsi' model='virtio-scsi' index='0'/>

3. マルチパスデバイスの場合、ホスト上のマルチパスデバイスマッパーを特定します。

   # multipath -l

   mpatha (36001438005deb1d00000000000000001) dm-0 NETAPP   ,LUN
   size=100G features='0' hwhandler='0' wp=rw
   `-+- policy='service-time 0' prio=50 status=active
     `- 2:0:0:1 sdb 8:16  active ready running
     `- 3:0:0:1 sdc 8:32  active ready running

   マルチパスデバイス名 (例: mpatha) をメモしておきます。デバイスパスは /dev/mapper/<name> です。たとえば、/dev/mapper/mpatha です。ls /dev/mapper/ コマンドを使用して、マルチパスデバイスのノードをリスト表示することもできます。

4. ホスト上の SCSI ディスクデバイスを定義する XML ファイルを作成して開きます。以下に例を示します。

   # vim scsi-passthrough-device.xml

5. XML ファイルに SCSI デバイスの設定を追加します。

   • マルチパスデバイスの場合:

     <disk type='block' device='lun'>
             <driver name='qemu' type='raw'/>
             <source dev='/dev/mapper/mpatha'/>
             <target dev='sdb' bus='scsi'/>
             <alias name='ua-scsi-mpath0'/>
             <address type='drive' controller='0' bus='0' target='0' unit='1'/>
     </disk>

     この例では、マルチパスデバイスは単一の disk 要素として定義されています。

     • <source dev='/dev/mapper/mpatha'/> は、ホスト上のデバイスマッパーマルチパスデバイスを指定します。
     • ホストのマルチパスレイヤーがすでにパスを集約しているため、仮想マシンは 1 つのブロックデバイスを受け取り、パスのフェイルオーバーはホスト側で処理されます。

   • ローカルディスクをパススルーする場合:

     <disk type='block' device='lun'>
             <driver name='qemu' type='raw'/>
             <source dev='/dev/sdb'/>
             <target dev='sdc' bus='scsi'/>
             <alias name='ua-scsi-lun0'/>
             <address type='drive' controller='0' bus='0' target='0' unit='0'/>
     </disk>

     この例では、SCSI ディスクデバイスが以下のパラメーターで定義されています。

     • type='block': デバイスがブロックデバイスであることを指定します。
     • device='lun': これが SCSI 論理ユニット番号 (LUN) デバイスのパススルーであることを示しています。
     • <driver name='qemu' type='raw'/>: 直接デバイスにアクセスするための raw 形式の QEMU ドライバーを指定します。
     • <source dev='/dev/sdb'/>: ホストブロックデバイスのパスを指定します。デバイスノード (例: /dev/sdb) を直接使用することも、再起動後の永続性を高めるために /dev/disk/by-path/ エントリーを使用することもできます。
     • <target dev='sdc' bus='scsi'/>: 仮想マシン内でデバイスがどのように表示されるかを指定します。このデバイスは SCSI バス上で sdc として表示されます。
     • alias: これは、libvirt コマンドでデバイスを接続解除するときなど、目的のデバイスを指定するのに使用できるオプションのユーザー定義エイリアスです。libvirt のユーザー定義エイリアスは、すべて "ua-" というプレフィックスで始まる必要があります。
     • <address type='drive' controller='0' bus='0' target='0' unit='0'/>: 仮想マシン内でデバイスがどのように表示されるかを指定します。controller 属性は、仮想マシン内の SCSI コントローラーを参照します。このコントローラーは、デバイスを接続する前に存在している必要があります。

6. XML ファイルを使用して、定義済みの SCSI ディスクデバイスを仮想マシンに接続します。たとえば、scsi-passthrough-device.xml で定義されたデバイスを、実行中の <vm_name> 仮想マシンに永続的に接続するには、以下を実行します。

   # virsh attach-device <vm_name> scsi-passthrough-device.xml --live --config

   --live オプションは、実行中の仮想マシンにのみデバイスを接続します。再起動後に永続性は維持されません。--config オプションは、設定の変更を永続化します。--live オプションを指定せずに、デバイスをシャットダウンした仮想マシンに接続することもできます。

7. オプション: SCSI ディスクを仮想マシンに接続する必要がなくなった場合は、virsh detach-device コマンドを使用してディスクを接続解除できます。

   1. シャットダウンした仮想マシンから SCSI ディスクデバイスを接続解除する場合:

      # virsh detach-device <vm_name> scsi-passthrough-device.xml --config

   2. 実行中の仮想マシンから SCSI ディスクデバイスを接続解除する場合:

      # virsh detach-device <vm_name> scsi-passthrough-device.xml --live --config

      警告

      実行中の仮想マシンから SCSI デバイスを接続解除すると、そのデバイスが使用中の場合、データの損失や破損が発生する可能性があります。デバイスを接続解除する前に、ゲストオペレーティングシステム上のどのアプリケーションからもデバイスにアクセスされていないことを確認してください。