1. まずは VM ゲスト が停止していることを確認します:

   > sudo virsh list --inactive
   Id    名前                           状態
   ----------------------------------------------------
   -     sles15                         シャットオフ

2. 既存の VM ゲスト に対する設定を編集します:

   > sudo virsh edit sles15

3. CPU の割当数を変更して保存します:

   <vcpu placement='static'>2</vcpu>

4. VM ゲスト を起動し直します:

   > sudo virsh start sles15

5. VM に対して割り当てられている CPU 数が変更されていることを確認します:

   > sudo virsh vcpuinfo sled15
   VCPU:           0
   CPU:            N/A
   State:          N/A
   CPU time        N/A
   CPU Affinity:   yy
   
   VCPU:           1
   CPU:            N/A
   State:          N/A
   CPU time        N/A
   CPU Affinity:   yy

1. まずは現時点での CPU 数を確認します:

   > sudo virsh vcpucount sles15 | grep live
   maximum      live           4
   current      live           2

2. CPU 数の現在値 (使用可能な CPU 数) を 4 に変更します:

   > sudo virsh setvcpus sles15 --count 4 --live

3. 最後に vcpu 数が 4 になっていることを確認します:

   > sudo virsh vcpucount sles15 | grep live
   maximum      live           4
   current      live           4

1. VM ゲスト の XML 設定ファイルを開きます。

   > sudo virsh edit sles15

2. デバイスの順序を入れ替えます。

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

3. VM ゲスト の BIOS 設定内の起動メニューを確認して、起動順序が変更されていることを確認します。

1. VM ゲスト の XML 設定を開きます:

   > sudo virsh edit sles15

2. os タグ内に kernel タグを追加し、ホスト側でのカーネルファイルのパスを指定します:

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

3. 同様に initrd タグを追加し、ホスト内での initrd ファイルのパスを指定します:

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

4. あとは VM を起動すると、新しいカーネルでの起動が行われます:

   > sudo virsh start sles15

1. ドライバを読み込む前に、まずは lspci を実行して、カードが正しく検出されていることを確認します。下記の例では、 lspci がデュアルポートの Intel 82576NS ネットワークカードを検出しています:

   > 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 ドライバが読み込まれているかどうかを確認します。下記の例では igb ドライバ (Intel 82576NS ネットワークカード向けのドライバです) が読み込まれているかどうかの確認になります。下記のように表示されれば、ドライバが既に読み込まれていることになります。何も出力を返さない場合は、ドライバが読み込まれていないことになります。

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

3. ドライバが既に読み込まれている場合は、この手順を飛ばしてください。 SR-IOV ドライバが読み込まれていない場合は、あらかじめ SR-IOV 非対応のドライバの読み込みを解除する必要があります。読み込みを解除するには、 rmmod コマンドをお使いください。下記の例では、 Intel 82576NS ネットワークカード向けの SR-IOV 非対応ドライバの読み込みを解除しています:

   > sudo /sbin/rmmod igbvf

4. あとは modprobe を利用して、 SR-IOV 対応のドライバを読み込みます。このとき、 VF パラメータ ( max_vfs ) を必ず指定してください:

   > sudo /sbin/modprobe igb max_vfs=8

1. イーサネットデバイスの一覧を表示して、物理 NIC の PCI ID を確認します:

   > 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 数を書き込みます:

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

3. VF NIC が読み込まれたことを確認します:

   > 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 の最大数を知りたい場合は、下記のようなコマンドを入力して実行します:

   > 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"
   # 注意: 実行ファイルはシェル経由ではなく、直接実行されます。詳しい書式については、
   # systemd.service と systemd.unit のマニュアルページをお読みください
   [Install]
   # このサービスを開始するターゲットの指定
   WantedBy=multi-user.target
   #WantedBy=graphical.target

6. また VM を起動する前に、もう 1 つのサービスファイル ( after-local.service ) を作成し、 NIC の切り離しを行うスクリプト /etc/init.d/after.local を実行するように設定します。これを行わないと、 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 と対応する PF の PCI アドレスを取得します。 lspci の出力は 14.9.2項 「SR-IOV ホストドライバの読み込みと設定」 のようになります (たとえば 01:00.0 や 04:00.1 など) 。このアドレス情報のコロン (:) やドット (.) をアンダースコア (_) に変換し、冒頭に "pci_0000_" を付けたものが virsh で使用するアドレスとなります。たとえば lspci コマンドで "04:00.0" と出力された場合、 virsh のアドレスは "pci_0000_04_00_0" になります。下記の例では、 Intel 82576NS デュアルポートイーサネットカードでの PCI ID を取得しています:

   > 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

   最初の 2 つの項目が PF を、残りの項目が VF を表しています。

2. あとは virsh nodedev-dumpxml を実行して、追加したい VF の PCI ID を取得します:

   > 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) を作成して、既存の VM ゲスト に VF ネットワークデバイスを追加するのに必要なデータを記述していきます。このファイルを最も短く作成すると、下記のようになります:

   <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 で 「従来の方法を利用して」 ネットワークデバイスを追加すると、ホスト側の再起動が発生するたびに MAC アドレスが変わってしまうため、 VM ゲスト 側のネットワークデバイスを再設定する必要が生じてしまいます。このような問題を回避するため、 libvirt では hostdev という値が提供されるようになり、これによってデバイスの割り当て 前 にネットワーク固有のデータを設定できるようになっています。
   2	以前の手順で取得したデータを指定します。

4. デバイスが既にホスト側に割り当てられてしまっている場合、 VM ゲスト に対して割り当てることができなくなります。ゲストに対して割り当てたい場合は、下記のようにしてホスト側から切り離しを行ってください:

   > sudo virsh nodedev-detach pci_0000_04_10_0

5. あとは既存の VM ゲスト に VF インターフェイスを追加します:

   > sudo virsh attach-device 仮想マシン名 /tmp/vf-interface.xml --オプション

   仮想マシン名 の箇所には VM ゲスト の名前のほか、 ID や UUID を指定することもできます。また、 --オプション の部分には下記を指定することができます:

   --persistent

   仮想マシンの XML 設定ファイルに対してデバイスを追加します。これに加えて、仮想マシンが動作中である場合、ホットプラグで接続することもできます。

   --config

   仮想マシンの XML 設定ファイルに対してデバイスを追加します。仮想マシンが動作中の場合、ホットプラグは行われず、次回の再起動以降に現れるようになります。

   --live

   仮想マシンの動作中の状態にのみ適用します。仮想マシンが動作中ではない場合、この操作は失敗します。 XML ファイル内には保存されませんので、 VM ゲスト の再起動を行うとデバイスが消えてしまいます。

   --current

   仮想マシンの現在の状態に反映させます。仮想マシンが動作中ではない場合、デバイスを XML 設定ファイル内に追加し、次回の起動時に現れるようになります。仮想マシンが動作中である場合、デバイスはホットプラグで追加されますが、 XML 設定ファイルには追加されないようになります。

6. VF インターフェイスを切り離すには、 virsh detach-device コマンドを使用します。オプション類は上記と同じです。

1. 既存の VM ゲスト に対する設定を編集します:

   > sudo virsh edit sles15

2. VRAM に割り当てるサイズを変更するには、下記のように設定します:

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

3. あとは仮想マシンマネージャを開いて、仮想マシン側に割り当てられた VRAM のサイズを確認してください。

1. 既存の VM ゲスト に対する設定を編集します:

   > sudo virsh edit sles15

2. 2D/3D アクセラレーション機能を有効化／無効化するには、それぞれ accel3d もしくは accel2d の設定を変更します:

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

1. まずはホスト側で vfio_ap と vfio_mdev のカーネルモジュールが読み込まれていることを確認します:

   > lsmod | grep vfio_

   どちらか 1 つでも読み込まれていない場合は、下記のようにして手作業で読み込みを行います:

   > sudo modprobe vfio_mdev

2. ホスト内で新しい MDEV デバイスを作成し、それが追加されていることを確認します:

   uuid=$(uuidgen)
   $ echo ${uuid} | sudo tee /sys/devices/vfio_ap/matrix/mdev_supported_types/vfio_ap-passthrough/create
   dmesg | tail
   [...]
   [272197.818811] iommu: Adding device 24f952b3-03d1-4df2-9967-0d5f7d63d5f2 to group 0
   [272197.818815] vfio_mdev 24f952b3-03d1-4df2-9967-0d5f7d63d5f2: MDEV: group_id = 0

3. 次に KVM ゲストに占有させるホスト側の論理パーティション内のデバイスを識別します:

   > ls -l /sys/bus/ap/devices/
   [...]
   lrwxrwxrwx 1 root root 0 Nov 23 03:29 00.0016 -> ../../../devices/ap/card00/00.0016/
   lrwxrwxrwx 1 root root 0 Nov 23 03:29 card00 -> ../../../devices/ap/card00/

   上記の例では、カードとキューがそれぞれ 0 と 16 になっていることがわかります。 Hardware Management Console (HMC) の設定とあわせるため、 16 進数表記 16 を 10 進数表記 22 に変換してください。

4. 対称のアダプタを zcrypt から使用されないようにマスクします:

   > lszcrypt
   CARD.DOMAIN TYPE MODE STATUS REQUEST_CNT
   -------------------------------------------------
   00 CEX5C CCA-Coproc online 5
   00.0016 CEX5C CCA-Coproc online 5

   アダプタをマスクします:

   > cat /sys/bus/ap/apmask
   0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
   echo -0x0 | sudo tee /sys/bus/ap/apmask
   0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff

   ドメインをマスクします:

   > cat /sys/bus/ap/aqmask
   0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
   echo -0x0 | sudo tee /sys/bus/ap/aqmask
   0xfffffdffffffffffffffffffffffffffffffffffffffffffffffffffffffffff

5. アダプタ 0, ドメイン 16 (10 進数で 22) を vfio-ap に割り当てます:

   > sudo echo +0x0 > /sys/devices/vfio_ap/matrix/${uuid}/assign_adapter
   > echo +0x16 | sudo tee /sys/devices/vfio_ap/matrix/${uuid}/assign_domain
   > echo +0x16 | sudo tee /sys/devices/vfio_ap/matrix/${uuid}/assign_control_domain

6. 設定した matrix を確認します:

   > cat /sys/devices/vfio_ap/matrix/${uuid}/matrix
   00.0016

7. あとは新しい VM を作成 (詳しくは 第9章 「ゲストのインストール」 をお読みください) して準備が完了するまで待つか、既存の VM に設定を行います。いずれの場合にしても、 VM はシャットダウンしておく必要があります。

8. MDEV デバイスを使用するよう設定を変更します:

   > sudo virsh edit VM_NAME
   [...]
   <hostdev mode='subsystem' type='mdev' model='vfio-ap'>
    <source>
     <address uuid='24f952b3-03d1-4df2-9967-0d5f7d63d5f2'/>
    </source>
   </hostdev>
   [...]

9. あとは仮想マシンを再起動します:

   > sudo virsh reboot VM_名

10. ゲストにログインして、アダプタが存在していることを確認します:

    > lszcrypt
    CARD.DOMAIN TYPE MODE STATUS REQUEST_CNT
    -------------------------------------------------
    00 CEX5C CCA-Coproc online 1
    00.0016 CEX5C CCA-Coproc online 1