設定 - KVMのGPUパススルーのソースを表示

== 概要 ==
ここでは、Linuxホスト上にlibvirtd + QEMUで仮想マシンを構築して、グラフィックボードやUSBポートを物理PCと同様に使用できるように設定する。<br>
<br>
Linuxの欠点の1つは、利用できるソフトウェアがそれほど多くないことである。<br>
最近では、多くのソフトウェアがLinuxに移植されたのは事実であるが、まだまだWindows専用に開発されたソフトウェアが多い。<br>
<br>
Linuxでは、これらのWindows専用ソフトウェアを使用するために、以下に示す4つの方法がある。<br>
* Wineを使用する。
*: ただし、Wineは、古いソフトウェアなら機能する場合が多い。
* デュアルブートセットアップを使用して、Windows専用ソフトウェアを使用するたびにWindowsをブートする。
*: ただし、手間が掛かる。
* ホストOS型の仮想化ソフトウェアにWindowsの仮想マシンを構築する。
*: ただし、グラフィック性能が活かせない。
* GPUパススルーを備えたWindowsの仮想マシンを使用する。
*: ハードウェアの前提条件がいくつかある (特定のCPUとGPUでのみ機能する) が、適切なハードウェアがあれば可能である。
<br>
基本的な設定の流れは、次のようになる。<br>
# CPUの仮想化支援機能(Intel VT-xまたはAMD-Vi)を有効にする
# グラフィックボードのパススルー設定
#* IOMMUの有効化
#* Linuxホストのグラフィックボード無効化
# KVM / QEMUのインストール
# ゲストOS作成
#* 仮想マシンのチューニングを行った後に仮想マシンをインストールする。
# グラフィックボードのパススルー
# USBデバイスのパススルー設定を行う。<br>または、SynergyあるいはBarrier (開発停止) を使用する。<br><br>Synergyのインストールは、[[インストール - マウス・キーボード共有ソフトウェア]]のページを参照すること。
<br>
<br>
ここでは、実際に設定を行うPCの環境は、以下の通りである。<br>
<br>
<center>
{| class="wikitable"
|+ ハードウェア構成
! 項目 !! 内容
|-
| CPU || Ryzen 9900X
|-
| M/B || MSI X870 Tomahawk (UEFI/BIOS: 7E51v1A91)
|-
| GPU 1 || Ryzen 9900X iGPU
|-
| GPU 2 || GIGABYTE GeForce GT1030
|-
| OS || SLE (Linuxカーネル 6.12.0)
|}
</center>
<br>
<center>
{| class="wikitable"
|+ ハードウェア構成
! 項目 !! 内容
|-
| CPU || Ryzen 3900X
|-
| M/B || GIGABYTE X570 UD (UEFI/BIOS: F37e)
|-
| GPU 1 || 玄人志向 Radeon RX550 LP
|-
| GPU 2 || GIGABYTE GeForce GT1030
|-
| OS || SLE (Linuxカーネル 5.14.21)
|}
</center>
<br><br>

== 前提条件 ==
# 2枚以上のグラフィックボード(マザーボード内蔵でも可)が必要である
#: 1つはLinuxホストで使用され、もう1つはWindowsを実行している仮想マシン(以降、VMという)で使用される。
#: また、VMにIntel統合GPU(Intel UHD等)を使用することはできない。ATI製またはnVidia製のみ使用できる。
#: ただし、LinuxホストにIntel統合GPUを使用することはできる。
# グラフィックボードがUEFIに対応していること。<br>[https://www.techpowerup.com/vgabios/ こちらのWebサイト]に記載されているグラフィックボードであればよい。
# CPUの機能において、Intel VT-DまたはAMD-Viをサポートするマザーボードが必要である。
#: リストの一部は[https://en.wikipedia.org/wiki/List_of_IOMMU-supporting_hardware このWebサイト]にある。BIOS上で有効にする必要がある。
# PCIのルートポートは、VMで使用するGPUと同じIOMMUグループの一部であってはならない。(詳細は後述)
# VMが使用するプライマリディスプレイの空き入力ポートまたはセカンダリディスプレイの空き入力ポートがあること。
<br><br>

== UEFI/BIOSの設定 ==
まず最初に、UEFI/BIOSの設定画面を表示して、以下に示す設定を行う。<br>
<br>
==== MSI X870 Tomahawk マザーボード ====
===== 7E51v1A91のUEFI/BIOS =====
* AMD-Viの有効化
*: [Overclocking] - [Advanced CPU Configuration] - [AMD CBS] - [SVM Mode]を[Enable]に変更する。
* IOMMUの有効化
*: [Overclocking] - [Advanced CPU Configuration] - [AMD CBS] - [IOMMU]を[Enable]に変更する。
* カーネルDMA保護インジケータ機能の無効化
*: [Overclocking] - [Advanced CPU Configuration] - [AMD CBS] - [Kernel DMA Protection Indicator]を[Disable]に変更する。
*: <br>
*: カーネルDMA保護インジケータ機能は、IOMMUを通じてOSレベルでのDMAリマッピングを事実上可能にする。
*: この設定を有効にする場合、メモリアクセス保護機能が提供される。
*: ただし、全てのデバイスドライバがDMAリマッピングに対応しているわけではないことに注意が必要である。
* Pre-boot DMA保護機能の無効化
*: [Overclocking] - [Advanced CPU Configuration] - [AMD CBS] - [Pre-boot DMA Protection]を[Disable]に変更する。
*: <br>
*: <u>物理的なアクセスを懸念してセキュリティ強化が特に必要でない限り、カーネルDMA保護インジケータ機能 および Pre-boot DMA保護機能の両方を無効にすることを推奨する。</u>
<br>

==== GIGABYTE X570UD マザーボード ====
===== F12以前のUEFI/BIOS =====
* AMD-Viの有効化
*: [M.I.T.] - [高度な周波数設定] - [Advanced CPU Settings] - [SVM Mode]を[Enable]に変更する。
* IOMMUの有効化
*: [チップセット] - [IOMMU]を[Enable]に変更する。
* ACSの有効化
*: [周辺機器] - [AMD CBS] - [ACS Enable]を[Enable]に変更する。
* AER Capの有効化
*: [周辺機器] - [AMD CBS] - [Enable AER Cap]を[Enable]に変更する。
<br>
===== F13以降のUEFI/BIOS =====
* AMD-Viの有効化
*: [M.I.T.] - [高度な周波数設定] - [Advanced CPU Settings] - [SVM Mode]を[Enable]に変更する。
* IOMMUの有効化
*: [チップセット] - [IOMMU]を[Enable]に変更する。
* IOMMUの有効化
*: [周辺機器] - [AMD CBS] - [NBIO Common Options] - [IOMMU]を[Enable]に変更する。
* ACSの有効化
*: [周辺機器] - [AMD CBS] - [NBIO Common Options] - [ACS Enable]を[Enable]に変更する。
* AER Capの有効化
*: [周辺機器] - [AMD CBS] - [NBIO Common Options] - [Enable AER Cap]を[Enable]に変更する。
<br><br>

== GPUパススルーの自動設定 ==
もし、下記のセクションの手動設定が面倒と考える場合、以下の自動設定を行うシェルスクリプトをダウンロードする。<br>
[[ファイル:GPU-PassThrough.zip|フレームなし|中央]]
<br>
まず、gpu-passthrough.shをスーパーユーザ権限で実行する。<br>
これは、必要なソフトウェアをインストールして、GPUパススルーに必要な設定を行った後、initrdを再構築するシェルスクリプトである。<br>
 sudo ./gpu-passthrough.sh
<br>
SUSEを再起動する。<br>
<br>
次に、分離するGPU(VMで使用するGPU)を確認する。<br>
Kernel driver in use:と記載されいている箇所を探す。正常に分離されていれば、<code>vfio-pci</code>と記載される。
 sudo lspci -nnk
<br>
KVMを起動して、[QEMU/KVM]にフォーカスを当てて[編集]メニュー - [接続の詳細]を選択する。<br>
[接続の詳細]画面が起動するので、[仮想ネットワーク]タブを選択して、[Autostart:]項目の[On Boot]チェックボックスにチェックを入力する。<br>
<br>
後は、下記の[ゲストOSの作成]セクションに移動して、VMの作成および設定を行う。<br>
<br>
なお、この手順は以下に示す動画を参考にしている。<br>
<center><embedvideo service="youtube">https://youtu.be/Nu2bHV8mA6c</embedvideo></center><br>
<br><br>

== KVM / QEMUのインストール ==
KVM / QEMUおよび依存関係のライブラリをインストールする。<br>
* SLES / openSUSE
*: <code>sudo zypper install libvirt libvirt-client libvirt-daemon virt-manager virt-install virt-viewer \</code>
*: <code>qemu qemu-kvm qemu-ovmf-x86_64 qemu-tools \</code>
*: <code>biosdevname</code>
*: <br>
* SLED
*: ソースコードからKVMとQEMUをインストールする場合、[[インストール - KVM#ソースコードからインストール]]を参照する。
*: <br>
*: または、以下のパッケージをダウンロードして、~/.profileファイル等に環境変数PATHおよびLD_LIBRARY_PATHを追記する。
*: libvirt : https://software.opensuse.org/package/libvirt
*: libvirt-client : https://software.opensuse.org/package/libvirt-client
*: libvirt-daemon : https://software.opensuse.org/package/libvirt-daemon
*: virt-manager : https://software.opensuse.org/package/virt-manager
*: virt-install : https://software.opensuse.org/package/virt-install
*: virt-viewer : https://software.opensuse.org/package/virt-viewer?search_term=virt-viewer
*: qemu : https://software.opensuse.org/package/qemu
*: qemu-kvm : https://software.opensuse.org/package/qemu-kvm
*: qemu-ovmf-x86_64 : https://software.opensuse.org/package/qemu-ovmf-x86_64
*: qemu-tools : https://software.opensuse.org/package/qemu-tools?search_term=qemu-tools
<br>
[https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso こちらのWebサイト]から、VirtIOドライバをダウンロードする。<br>
<br><br>

== ラップトップPC上のdGPUを通過させるための手順 ==
この手順は、ACPIの呼び出しを使用してdGPUファームウェアを読み込まないラップトップPCにのみ適用される。<br>
dGPUファームウェアを読み込むためにACPIの呼び出しを使用するラップトップPCについては、u/jscinoz'sのoptimus-vfio-docsを参照すること。<br>
<br>
現状、ACPIの呼び出しでdGPUがファームウェアを読み込むかどうかを確認する方法は不明である。<br>
<br>
最近の多くのOptimusなラップトップPCはMUXレス方式を採用しているが、<br>
HP/Thinkpad/Dellモバイルワークステーション、Clevo P650、Alienwareの一部等はMUXed方式を採用している。<br>
<br>
Optimusソリューションが登場する前の時代には、グラフィックスカードを切り替えるために再起動が必要で、1度に1つしか使用できない古いMUXed方式があったが、<br>
最新のMUXed方式では、OptimusとdGPUのみを切り替えることができ、Optimus使用時にはディスプレイ出力ポートをdGPUに直接接続することもできる。(一部のラップトップPCにのみ適用)<br>
<br>
MUXレス方式でCode 43(エラーコード)に遭遇したPCは、(ゲストOSでdGPUを見ることができ、NVIDIAドライバも問題なくインストールできるにもかかわらず)<br>
[https://www.reddit.com/r/VFIO/comments/6q7bf5/short%20report%20wip%20got%20the%20nvidia%20gpu%20to/ ACPIの呼び出しがdGPUファームウェアの読み込みに失敗したため]である。<br>
<br>
これは、NVIDIAドライバがvfio-pciを通して提供されたROMを使用する代わりに、UEFIからdGPUのROMを読み込もうとしているからである。<br>
<br>
このような問題が発生した場合は、[https://github.com/jscinoz/optimus-vfio-docs u/jscinozのoptimus-vfio-docs]を参照すること。<br>
<br>
MUXレスの成功報告があるラップトップPCを以下に示す。<br>
* MSI GS60-040XFR
* MSI GS60 2PC
* ASUS G751JM
<br>
[[ファイル:KVM GPU Passthrough Laptop 1.jpg|フレームなし|中央]]
<br>
この手順で可能になる事柄を以下に示す。<br>
* Bumblebeeを使用することにより、オンデマンドでNVIDIA dGPUの電源オン / オフすることが可能である。
* ホストPCにNVIDIA dGPUが不要の場合は、ゲストOSにNVIDIA dGPUを渡すことができる。
* ゲストOSのシャットダウン時にdGPUを戻すことができる。
* dGPUのバインド / アンバインドプロセス中に再起動する必要はない。
* 外部ディスプレイは必須ではない。（ハードウェアとVMが実行しているWindowsのバージョンに依存する）
* また、外部ディスプレイを直接ゲストOSに接続することができる。
<br>
使用しているNVIDIAグラフィックスカード (dGPU) がMUXedまたはMUXlessかどうかを確認する。<br>
BIOS/UEFIオプションにおいて、<u>integrated graphics</u> / <u>PCI graphics</u>が選択できる場合、MUXedである。<br>
選択できない場合はMUXレスである。<br>
<br>
MUXedの場合は、https://gist.github.com/Misairu-G/616f7b2756c488148b7309addc940b28 を参照すること。<br>
MUXレスの場合、https://github.com/jscinoz/optimus-vfio-docs を参照すること。<br>
<br><br>

== IOMMUの有効化 ==
Intel VT-xとAMD-Viは、一般的にIOMMUと呼ばれる。<br>
IOMMUを有効にするには、<u>/etc/default/grub</u> ファイル (ブートローダファイル) にある <code>GRUB_CMDLINE_LINUX_DEFAULT</code> キーに以下に示す設定を追記する。<br>
<br>
<code>iommu=pt</code> とは、カーネルにDMA変換をメモリにバイパスするように指示するものである。<br>
これにより、パフォーマンスが向上する場合がある。<br>
<br>
 # Intel CPU
 intel_iommu=on iommu=pt 
 
 # AMD CPU
 amd_iommu=on iommu=pt
<br>
grubを再構築するために、以下に示すコマンドを実行する。<br>
<br>
 sudo grub2-mkconfig -o /boot/grub2/grub.cfg
<br>
Linuxを再起動する。<br>
再起動後、IOMMUが有効になっているか確認するため、以下に示すコマンドを実行する。<br>
<br>
 # Intel CPU
 sudo dmesg | grep -e DMAR -e IOMMU
 
 # AMD CPU
 cat /proc/cmdline
 sudo dmesg | grep -iE 'AMD-Vi|IOMMU'
<br>
有効化されている場合は、以下のようなメッセージが出力される。<br>
 # Intel CPU
 DMAR: IOMMU enabled
 ・
 ・
 ・
 
 # AMD CPU
 [    1.643621] pci 0000:00:00.2: AMD-Vi: IOMMU performance counters supported
 [    1.645069] pci 0000:00:00.2: AMD-Vi: Found IOMMU cap 0x40
 [    1.645069] pci 0000:00:00.2: AMD-Vi: Extended features (0x58f77ef22294ade):
 [    1.645071] AMD-Vi: Interrupt remapping enabled
 [    1.645072] AMD-Vi: Virtual APIC enabled
 [    1.645072] AMD-Vi: X2APIC enabled
 [    1.645153] AMD-Vi: Lazy IO/TLB flushing enabled
 [    2.486602] AMD-Vi: AMD IOMMUv2 driver by Joerg Roedel <jroedel@suse.de>
<br>
次に、IOMMUグループが有効であることを確認する。<br>
以下のシェルスクリプトを作成して実行する。(ここでは、シェルスクリプトのファイル名をlsIOMMU.shとする)<br>
 <syntaxhighlight lang="sh">
 #!/bin/bash
 
 shopt -s nullglob
 for d in /sys/kernel/iommu_groups/*/devices/*; do
    n=${d#*/iommu_groups/*}; n=${n%%/*}
    printf 'IOMMU Group %s ' "$n"
    lspci -nns "${d##*/}"
 done;
 </syntaxhighlight>
<br>
 # 実行
 chmod u+x lsIOMMU.sh
 sudo ./lsIOMMU.sh
<br>
出力結果は下図のようになる。この図から、2つのことが分かる。<br>
VMで使用するデバイスがどのIOMMUグループであるか(下図の場合は、グループ11)およびそのベンダー/モデルID(下図の場合は、1002：683fおよび1002：aab0)である。<br>
この出力結果は、IOMMUグループ内で(関連付けられているオーディオデバイスを無視して)単独のデバイスに対してのみ機能する。<br>
[[ファイル:GPU PassThrough 1.jpg|フレームなし|中央]]
<br><br>

== 複数のGPUの分離 ==
2つ以上のGPUを分離する必要がある。<br>
これは、異なるメーカーのGPUが2つある場合(ここでは、VMで使用するGPUをブラックリストに登録するだけ)は非常に簡単であるが、<br>
両方のGPUが同じベンダーのものである場合は少し複雑になる。<br>
また、両方のGPUが同じモデルの場合、さらに複雑になる。<br>
GPUが同じベンダーのものであったとしても、両方のGPUが完全に同じモデルでない限り、この設定に従うことができる。<br>
また、グラフィックカードのHDMIオーディオデバイスもパススルーすること。<br>
<br>
<span style="color: #A00000><u>'''ただし、この設定では、2つの全く同一のGPUでは機能しないので注意すること。(Radeon RX550が2枚など)'''</u></span><br>
<br>
<u>'''2つのグラフィックボードがそれぞれ異なる場合(nVidia製とATI製)'''</u><br>
/lib/modprobe.d/50-blacklist.confファイル、または、/etc/modprobe.d/50-blacklist.confファイルを編集して、以下の内容を追記する。<br>
 # SUSE 15.4以降の場合
 sudo vi /lib/modprobe.d/50-blacklist.conf
 
 # SUSE 15.3以前の場合
 sudo vi /etc/modprobe.d/50-blacklist.conf
<br>
 # LinuxホストにATI製グラフィックボード、VMにnVidia製グラフィックボードを使用する場合
 blacklist nouveau
 blacklist nvidia
 
 # LinuxホストにnVidia製グラフィックボード、VMにATI製グラフィックボードを使用する場合
 blacklist amdgpu
 blacklist radeon
<br>
<u>'''2つのグラフィックボードが同じ場合(両方ともnVidia製または両方ともATI製)'''</u><br>
まず、/lib/modprobe.d/gpu-passthrough.confファイル、または、/etc/modprobe.d/gpu-passthrough.confファイルを作成して、以下のように編集する。<br>
ここで、<VMで使用するGPUのベンダー>と<VMで使用するGPUのモデルID>は、上記セクションで実行したlsIOMMU.shの出力結果に記載されている。<br>
 # SUSE 15.4以降の場合
 sudo vi /lib/modprobe.d/gpu-passthrough.conf
 
 # SUSE 15.3以前の場合
 sudo vi /etc/modprobe.d/gpu-passthrough.conf
<br>
 # /lib/modprobe.d/gpu-passthrough.confファイル または /etc/modprobe.d/gpu-passthrough.confファイル
 
 options vfio-pci ids=<VMで使用するGPUのベンダー>,<VMで使用するGPUのモデルID>
<br>
例えば、上記セクションの結果から、以下のように記述する。<br>
また、<code>options vfio-pci disable_vga=1</code>は、ホストPCがLinuxカーネル 4.1以降、かつ、ゲストOSがUEFIの場合のみ有効である。<br>
VGAアービトレーションがホストデバイスに干渉するのを防ぐのに役立つ。<br>
 # /lib/modprobe.d/gpu-passthrough.confファイル
 # または
 # /etc/modprobe.d/gpu-passthrough.confファイル
 
 options vfio-pci ids=10de:1d01,10de:0fb8
 options vfio-pci disable_vga=1
<br>
また、Windows10 1803以降をインストールする場合は、以下の設定も追記する。<br>
しかし、Linuxカーネル 5.9.1以降はこのオプションが問題を引き起こすという報告がある。<br>
個人的には、<code>kvm.ignore_msrs=1</code>オプションを付加して、問題が発生する場合は当オプションを削除する方法を推奨する。<br>
 # SUSE 15.4以降の場合
 sudo vi /lib/modprobe.d/gpu-passthrough.conf
 
 # SUSE 15.3以前の場合
 sudo vi /etc/modprobe.d/gpu-passthrough.conf
<br>
 # /lib/modprobe.d/gpu-passthrough.confファイル または /etc/modprobe.d/gpu-passthrough.confファイル
 
 options kvm ignore_msrs=1
<br>
自動ロードするモジュールのリストにドライバを追加するため、/etc/modules-load.d/vfio-pci.confファイルを作成して、以下の内容を記述する。<br>
 sudo vi /etc/modules-load.d/vfio-pci.conf
<br>
 # /etc/modules-load.d/vfio-pci.confファイル
 
 # Intel CPUの場合
 pci_stub
 vfio
 vfio_iommu_type1
 vfio_pci
 kvm
 kvm_intel
 
 # AMD CPUの場合
 pci_stub
 vfio
 vfio_iommu_type1
 vfio_pci
 kvm
 kvm_amd
<br>
次に、<u>/etc/default/grub</u> ファイルを開く。<br>
vfio-pciをパススルーするGPUにバインドするため、<code>GRUB_CMDLINE_LINUX_DEFAULT</code> に <code>rd.driver.pre=vfio-pci</code> を追記する。<br>
<br>
 # /etc/default/grubファイル
 
 GRUB_CMDLINE_LINUX_DEFAULT="〜 rd.driver.pre=vfio-pci"
<br>
grubを再構築するために、以下に示すコマンドを実行する。<br>
<br>
 sudo grub2-mkconfig -o /boot/grub2/grub.cfg
<br><br>

== vfio-pciドライバの先読み設定 ==
vfio-pciドライバの先読み設定を行う。<br>
<br>
RHELでは、<u>/etc/sysconfig/kernel</u> ファイルを作成して設定する。<br>
Ubuntuでは、<u>/etc/dracut.conf.d/gpu-passthrough.conf</u> ファイルを作成して設定する。<br>
SUSEでは、どちらでもvfio-pciドライバの先読み設定を行うことができる。<br>
<br>
<u>※注意</u><br>
<u>SUSE Linux Enterprise 15 SP2 / openSUSE Leap 15.2以降、vfio-pciが <code>ids=</code> パラメータをサポートし、pci-stubと同一の役割 (起動時のデバイス予約) を直接担えるようになった。</u><br>
<u>/etc/modprobe.d/vfio.confファイルに <code>options vfio-pci ids=<vendor>:<device></code> を指定すれば、pci-stubを経由する必要はない。</u><br>
<br>
 sudo vi /etc/dracut.conf.d/gpu-passthrough.conf
<br>
 <syntaxhighlight lang="make">
 # /etc/dracut.conf.d/gpu-passthrough.confファイル
 
 # SUSE Linux Enterprise 16 / openSUSE Leap 16 : Linuxカーネル 6.2以降では、vfio_virqfdが削除された
 ## Intel CPUの場合
 add_drivers+=" vfio vfio_iommu_type1 vfio_pci kvm kvm_intel "
 
 ## AMD CPUの場合
 add_drivers+=" vfio vfio_iommu_type1 vfio_pci kvm kvm_amd "
 
 # SUSE Linux Enterprise 15 SP2〜SP7 / openSUSE Leap 15.2〜15.6
 ## Intel CPUの場合
 add_drivers+=" vfio vfio_iommu_type1 vfio_pci vfio_virqfd kvm kvm_intel "
 
 ## AMD CPUの場合
 add_drivers+=" vfio vfio_iommu_type1 vfio_pci vfio_virqfd kvm kvm_amd "
 
 # SUSE Linux Enterprise 15 SP1以前 / openSUSE Leap 15.1以前
 ## Intel CPUの場合
 add_drivers+=" pci_stub vfio vfio_iommu_type1 vfio_pci vfio_virqfd kvm kvm_intel "
 
 ## AMD CPUの場合
 add_drivers+=" pci_stub vfio vfio_iommu_type1 vfio_pci vfio_virqfd kvm kvm_amd "
 </syntaxhighlight>
<br>
上記の設定を有効化するため、initrdを再構築する。<br>
 sudo dracut -f /boot/initrd $(uname -r)
<br>
initrdの再構築の完了後、Linuxホストを再起動する。<br>
設定ミスで失敗すると、Linuxホストが起動できなくなる可能性があるので注意すること。<br>
<br><br>

== GPUが分離されていることを確認 ==
GPUが分離されているか確認する。<br>
以下のコマンドを実行して、使用中のカーネルドライバーを探す。<br>
 sudo lspci -nnv
<br>
分離するGPU(VMで使用するGPU)を確認するには、Kernel driver in use:と記載されいている箇所を探す。
正常に分離されていれば、vfio-pciと記載される。
 03:00.0 VGA compatible controller [0300]: NVIDIA Corporation GP108 [GeForce GT 1030] [10de:1d01] (rev a1)
        Subsystem: Gigabyte Technology Co., Ltd Device [1458:375d]
        Kernel driver in use: vfio-pci
        Kernel modules: nouveau
 03:00.1 Audio device [0403]: NVIDIA Corporation GP108 High Definition Audio Controller [10de:0fb8] (rev a1)
        Subsystem: Gigabyte Technology Co., Ltd Device [1458:375d]
        Kernel driver in use: vfio-pci
        Kernel modules: snd_hda_intel
<br><br>

== QEMUのアクセス権限の付与 ==
別のHDD / SSDに仮想マシンを配置する場合、初期設定ではアクセス権限エラーになる。<br>
そこで、/etc/libvirt/qemu.confファイルに以下の設定を追記する。<br>
 # /etc/libvirt/qemu.confファイル
 ・
 ・
 ・
 user = "root"
 group = "root"
<br>
また、別のHDD / SSDに仮想マシンを配置する時は、配置先のディレクトリで以下のコマンドを実行する。<br>
以下では、<仮想マシン名>.qcow2ファイルを最大100[GB]の領域で仮想マシンを作成している。<br>
 qemu-img create -f qcow2 <仮想マシン名>.qcow2 100G
<br><br>

== X11の設定 ==
上記の設定の状態では、PC起動時においてパススルーしたGPUを先に読み込むため、ホストOSの画面が表示されない。<br>
ホストOS向けのGPUを先に読む込む必要があるため、/etc/X11/xorg.conf.installファイルに以下の設定を追記する。<br>
 sudo vi /etc/X11/xorg.conf.install
<br>
 # /etc/X11/xorg.conf.installファイル
 
 # ...略
 
 # 以下の設定を追記
 Section "Device"
   Identifier "amdgpu"
   Driver  "amdgpu"
 EndSection
 
 # 以下の設定を追記
 Section "Screen"
   Identifier "amdgpu"
   Device "amdgpu"
 EndSection
 
 # Screen  "amdgpu"を追記
 Section "ServerLayout"
   # ...略
   Screen  "amdgpu"  # 追加
 EndSection
<br><br>

== ゲストOSの作成 ==
あらかじめ、[https://www.microsoft.com/en-us/software-download/windows10ISO Microsoftの公式Webサイト]で、Windows10のisoファイルをダウンロードする。<br>
併せて、[https://github.com/virtio-win/virtio-win-pkg-scripts/blob/master/README.md virtio-winのGithub]または[https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/ Fedoraの公式Webサイト]にアクセスして、virtio-win-<バージョン>.isoファイルもダウンロードする。<br>
<br>
==== Windows 10 / 11 / Linuxの場合 ====
# まず、<u>'''SUSE 15.1'''</u>を使用している場合は、<code>/etc/libvirt/qemu.conf</code>ファイルを開いて、nvramセクションを以下のように編集する。
#: <code>nvram = ["/usr/share/qemu/ovmf-x86_64.bin:/usr/share/qemu/ovmf-x86_64-code.bin"]</code>
# libvirtデーモンを再起動する。
#: <code>sudo systemctl restart libvirtd</code>
#: <br>
#: 必要であれば、以下のように、libvirtdを自動起動するように設定する。
#: <code>sudo systemctl enable libvirtd</code>
#: <br>
# Virtual Machine Managerを起動して、新しいVMを作成する。<br>[Architecture Option]画面では、[Local Install Media]と[x86_64]を選択する。
# [Use ISO Imege]項目を選択して、Windows10のISOファイルを選択する。
# VMに割り当てるメモリ容量とCPUのコア数を選択する。
# VMのディスクイメージを作成する。(既に定義されている場合は選択する。また、ディスク全体でも構わない。パスをそこに配置して、ホストにマウントされていないことを確認する)
# VMに名前を付けて、[Customize configuration before install]チェックボックスにチェックが入力されていることを確認して、[Finish]ボタンを押下する。
# VM構成画面(以降、メイン画面という)に移動する。<br>メイン画面左の[Overview]を選択して、[Chipset:]プルダウンおよび[Firmware:]プルダウンを以下の値に設定する。
#: <br>
#: ホストOSがSUSE 15.1の場合
#: [Chipset:] : i440FX
#: [Firmware:] : BIOS または UEFI
#: <br>
#: ホストOSがSUSE 15.2以降かつゲストOSがWindows XPの場合
#: [Chipset:] : i440FX
#: [Firmware:] : BIOS または UEFI
#: <br>
#: ホストOSがSUSE 15.2以降かつゲストOSがWindows 7の場合
#: [Chipset:] : Q35
#: [Firmware:]は、以下のいずれかを選択する。
#: [Firmware:] : UEFI X86_64: ovmf-x86_64-smm-code.bin
#: [Firmware:] : UEFI X86_64: ovmf-x86_64-code.bin
#: [Firmware:] : UEFI X86_64: ovmf-x86_64-4m-code.bin
#: <br>
#: ホストOSがSUSE 15.2以降かつ上記以外のゲストOSの場合
#: [Chipset:] : Q35
#: [Firmware:]は、以下のいずれかを選択する。
#: [Firmware:] : UEFI X86_64: ovmf-x86_64-smm-ms-code.bin
#: [Firmware:] : UEFI X86_64: ovmf-x86_64-opensuse-code.bin
#: <br>
# メイン画面左の[CPUs]で、[Configuration]項目の[Model: ]プルダウンから、[host-passthrough]を選択する。(プルダウンに存在しない場合は、<code>host-passthrough</code>と入力する)
# メイン画面左下の[Add Hardware]ボタンを押下すると、[Add New Virtual Hardware]画面が表示される。<br>この画面左の[Controller]を選択して、[Type: ]項目にSCSI、[Model: ]項目にVirtIO SCSIと入力する。<br>(パフォーマンスを向上させるために、タイプを必ずVirtIO SCSIに変更する)
# メイン画面左の[SCSI Disk 1]を選択して、[Advanced Options]項目の[Disk bus]項目にSCSIを選択する。
# [Add New Virtual Hardware]画面左の[Storage]を選択して、[管理]ボタンを押下して、<br>"KVM / QEMUのインストール"セクションでダウンロードしたvirtio-win-<バージョン名>.isoファイルを選択する。<br>[デバイスの種類]項目には、[CD-ROMデバイス]を選択する。
# [Add New Virtual Hardware]画面左の[PCI Host Device]を選択して、分離されたGPUとサウンドカード(ここでは、PCIデバイス02：00.0とPCIデバイス02：00.1)を追加する。
# [Add New Virtual Hardware]画面左の[USB Host Device]を選択して、キーボードとマウスを追加する。
# <u>Windows 10 / 11の場合、[Add New Virtual Hardware]画面左の[TPM]を選択して、</u><br><u>[種類]プルダウンから[Emulated]、[モデル]プルダウンから[TIS]、[バージョン]プルダウンから[2.0]を選択して、追加する。</u>
# 同様に、不要なデバイス(タブレット、ディスプレイスパイス、シリアル、コンソール、チャンネルスパイス等)を全て削除する。<br><u>RHELやSLE等の場合は、Synergy / Barrierの動作に支障があるため、ビデオQXLを有効にして、ディスプレイSpiceおよびビデオは削除しない。</u><br><br>ディスプレイにサウンド出力がない場合またはVGA経由で接続する場合は、サウンドカードが必要である。<br>1000円程度の安価なUSBサウンドカードを購入してPCに取り付けた場合、キーボードとマウスを追加した際と同様にして追加する。
# VMに割り当てたばかりのグラフィックボードをディスプレイに接続し、[Begin Installation]ボタンを押下する。<br>全て正しく設定されていれば、そのディスプレイにVMが起動していることがわかる。
# Windows10をインストール画面の手順に従ってインストールする。<br>インストール完了後、Windows10のデバイスマネージャーを起動して、マウントされているvirtio-win-<バージョン名>.isoファイルから各種ドライバをインストールする。
<br>

==== Windows 7の場合 ====
# Virtual Machine Managerを起動して、新しいVMを作成する。<br>[Architecture Option]画面では、[Local Install Media]と[x86_64]を選択する。
# [Use ISO Imege]項目を選択して、Windows 7のISOファイルを選択する。
# VMに割り当てるメモリ容量とCPUのコア数を選択する。<br><u>この時、CPUの割り当てを<code>1</code>にする。</u>
# VMのディスクイメージを作成する。(既に定義されている場合は選択する。また、ディスク全体でも構わない。パスをそこに配置して、ホストにマウントされていないことを確認する)
# VMに名前を付けて、[Customize configuration before install]チェックボックスにチェックが入力されていることを確認して、[Finish]ボタンを押下する。
# VM構成画面(以降、メイン画面という)に移動する。<br>メイン画面左の[Overview]を選択して、[Chipset:]プルダウンおよび[Firmware:]プルダウンを以下の値に設定する。
#: <br>
#: ホストOSがSUSE 15.1の場合
#: [Chipset:] : i440FX
#: [Firmware:] : UEFI
#: <br>
#: ホストOSがSUSE 15.2以降かつゲストOSがWindows 7の場合
#: [Chipset:] : Q35
#: [Firmware:]は、以下のいずれかを選択する。
#: [Firmware:] : UEFI X86_64: ovmf-x86_64-smm-ms-code.bin
#: [Firmware:] : UEFI X86_64: ovmf-x86_64-smm-code.bin
#: <br>
# メイン画面左の[CPUs]で、[Configuration]項目の[Model: ]プルダウンから、[host-passthrough]を選択する。(プルダウンに存在しない場合は、<code>host-passthrough</code>と入力する)
# メイン画面左の[NIC 〜]で、[デバイスのモデル]プルダウンから[ハイパーバイザーのデフォルト]を選択する。
# [Add New Virtual Hardware]画面左の[Storage]を選択して、[管理]ボタンを押下して、<br>"KVM / QEMUのインストール"セクションでダウンロードしたvirtio-win-<バージョン名>.isoファイルを選択する。<br>[デバイスの種類]項目には、[CD-ROMデバイス]を選択する。
# [Add New Virtual Hardware]画面左の[USB Host Device]を選択して、キーボードとマウスを追加する。
# <u>分離されたGPUとサウンドカード(下図では、PCIデバイス03：00.0とPCIデバイス03：00.1)は追加しないことに注意する。</u>
#: ここまでの設定を行うことにより、下図のようになる。
#: [[ファイル:KVM GPU Passthrough for Windows7 1.png|フレームなし|中央]]
# [Begin Installation]ボタンを押下して、ゲストOSを起動する。
# UEFIシェル(仮想マシンのブート設定画面)を起動して、[Device Manager] - [Secure Boot Configuration] - [Attempt Secure Boot]チェックボックスのチェックを外して、セキュアブートを無効にする。
# <u>設定を保存した後、すぐに仮想マシンをシャットダウンする。</u><br><u>※まだ、Windows 7はインストールしないことに注意する。</u>
# 仮想マシンの設定ファイル(XML拡張子)を、以下に示すように編集する。
#: <code>sudo virsh edit <仮想マシン名></code>
#: <br>
#: # 最初の行を変更する
#: <code><domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'></code>
#: または
#: <code><domain xmlns:qemu="http://libvirt.org/schemas/domain/qemu/1.0" type="kvm"></code>
#: <br>
#: # ファイルの最下行にある<code></devices></code>と<code></domain></code>の間に追記する
#: # (<code>host=03:00.0</code>の箇所は、必要に応じてユーザの環境に合わせること)
#: <br>
#: <code><qemu:commandline></code>
#: <code>  <qemu:arg value='-device'/></code>
#: <code>  <qemu:arg value='vfio-pci,host=03:00.0,id=hostpci0.0,bus=pcie.0,addr=0x10.0,multifunction=on'/></code>
#: <code>  <qemu:arg value='-device'/></code>
#: <code>  <qemu:arg value='vfio-pci,host=03:00.1,id=hostpci0.1,bus=pcie.0,addr=0x10.1'/></code>
#: <code>  <qemu:arg value='-cpu'/></code>
#: <code>  <qemu:arg value='host,kvm=off,hv_vendor_id=null'/></code>
#: <code>  <qemu:arg value='-machine'/></code>
#: <code>  <qemu:arg value='q35,kernel_irqchip=on'/></code>
#: <code></qemu:commandline></code>
#: <br>
# 次に、libvirtdおよびQEMUの設定ファイル(/etc/libvirt/qemu.confファイル)の最下行に、以下に示す設定を追記する。
#: <code>sudo vi /etc/libvirt/qemu.conf</code>
#: <br>
#: <code>cgroup_device_acl = [</code>
#: <code>  "/dev/null", "/dev/full", "/dev/zero",</code>
#: <code>  "/dev/random", "/dev/urandom",</code>
#: <code>  "/dev/ptmx", "/dev/kvm",</code>
#: <code>  "/dev/vfio/20", "/dev/vfio/vfio"</code>  <u># /dev/vfio/20ファイルは、使用している環境により、数値の部分が異なる場合があることに注意する</u>
#: <code> ]</code>
#: <br>
# libvirtdデーモンを再起動する。
#: <code>sudo systemctl restart libvirtd</code>
#: <br>
# VMに割り当てるGPUをディスプレイに接続し、仮想マシンを起動する。
# UEFIシェル(仮想マシンのブート設定画面)のブートセレクションからWindows 7インストーラがあるストレージを選択して、Windows 7をインストールする。<br>インストール完了後、Windows 7のデバイスマネージャーを起動して、マウントされているvirtio-win-<バージョン名>.isoファイルから各種ドライバをインストールする。
# Windowsアップデートを行う。<br><u>Windowsアップデート行う前に、下記の<span style="color:#AA0000">※注意2</span>を参照して、いくつかのパッチをインストールする必要があることに注意する。</u><br>
# NVidiaのGPUドライバをインストールする。<br>NVidiaのGPUドライバは、[https://www.nvidia.co.jp/Download/index.aspx?lang=jp 公式Webサイト]からダウンロードすること。
# 仮想マシンをシャットダウンして、 [仮想CPU 割り当て]項目から、VMに割り当てるCPUのコア数を設定する。<br><u>ただし、[トポロジー] - [CPUトポロジーの手動設定]は設定しないこと。(UEFIシェル画面でハングするため)</u>
# 不要であれば、使用しないデバイス(タブレット、ディスプレイスパイス、コンソール、チャンネルスパイス、ビデオQXL等)を全て削除する。
<br>
<u>※注意 1</u><br>
<u>仮想マシンを実行する時、以下に示すようなエラーが出力される場合がある。</u><br>
 audio: Could not init spice' audio driver
<br>
<u>この問題を解決するには、Virt-Managerを起動して、画面左ペインにある[概要]から[XML]タブを選択して、オーディオの種類をspice以外のものに変更する必要がある。</u><br>
<syntaxhighlight lang="xml">
 # 編集前
 <audio id='1' type='spice'/>
 
 # 編集後
 <audio id='1' type='none'/>
 </syntaxhighlight>
<br>
<u>※注意 2</u><br>
<u>2023/03現在、Windows 7を新規インストールした場合は、Windowsアップデートができない。</u><br>
<u>そのため、Microsoftの公式Webサイトから、いくつかのWindows 7の更新プログラムを直接ダウンロードおよびインストールする必要がある。</u><br>
以下のURLでは、Windows 7 x64向けであることに注意する。<br>
<br>
* Windowsアップデートが動作しない場合
*: Windows 7 用更新プログラム (KB3138612)をインストールする。
*: https://www.microsoft.com/ja-jp/download/details.aspx?id=51208
*: または
*: https://www.catalog.update.microsoft.com/Search.aspx?q=KB3138612
*: <br>
* Windows7の更新プログラムのインストールがいくつか失敗するものがある場合
*: 2019-03 x64ベースシステム用Windows 7 サービススタック更新プログラム (KB4490628)をインストールして、サービススタックを更新する。
*: https://www.catalog.update.microsoft.com/search.aspx?q=kb4490628
<br>
必要であれば、以下に示す更新プログラムもインストールする。<br>
* windows6.1-kb2533552-x64_0ba5ac38d4e1c9588a1e53ad390d23c1e4ecd04d.msu
*: https://www.catalog.update.microsoft.com/Search.aspx?q=kb2533552
* windows6.1-kb3020369-x64_5393066469758e619f21731fc31ff2d109595445.msu
*: https://www.catalog.update.microsoft.com/Search.aspx?q=kb3020369
* windows6.1-kb3125574-v4-x64_2dafb1d203c8964239af3048b5dd4b1264cd93b9.msu
*: https://www.catalog.update.microsoft.com/Search.aspx?q=kb3125574
* windows6.1-kb976932-x64_74865ef2562006e51d7f9333b4a8d45b7a749dab.exe<br><u>※ SP1をインストールしていない場合のみ</u>
*: https://www.catalog.update.microsoft.com/Search.aspx?q=kb976932
<br>

==== Windows XPの場合 ====
# Virtual Machine Managerを起動して、新しいVMを作成する。<br>[Architecture Option]画面では、[Local Install Media]と[x86_64]を選択する。
# [Use ISO Imege]項目を選択して、Windows XPのISOファイルを選択する。
# VMに割り当てるメモリ容量とCPUのコア数を選択する。<br><u>この時、CPUの割り当てを<code>2</code>にする。</u>
# VMのディスクイメージを作成する。(既に定義されている場合は選択する。また、ディスク全体でも構わない。パスをそこに配置して、ホストにマウントされていないことを確認する)
# VMに名前を付けて、[Customize configuration before install]チェックボックスにチェックが入力されていることを確認して、[Finish]ボタンを押下する。
# VM構成画面(以降、メイン画面という)に移動する。<br>メイン画面左の[Overview]を選択して、[Chipset:]プルダウンおよび[Firmware:]プルダウンを以下の値に設定する。
#: <br>
#: [Chipset:] : i440FX
#: [Firmware:] : BIOS
#: <br>
# メイン画面左の[CPUs]で、[Configuration]項目の[Model: ]プルダウンから、[host-passthrough]を選択する。(プルダウンに存在しない場合は、<code>host-passthrough</code>と入力する)
# メイン画面左の[NIC 〜]で、[デバイスのモデル]プルダウンから[ハイパーバイザーのデフォルト]を選択する。
# [Add New Virtual Hardware]画面左の[Storage]を選択して、[管理]ボタンを押下して、<br>"KVM / QEMUのインストール"セクションでダウンロードしたvirtio-win-<バージョン名>.isoファイルを選択する。<br>[デバイスの種類]項目には、[CD-ROMデバイス]を選択する。
# [Add New Virtual Hardware]画面左の[PCI Host Device]を選択して、分離されたGPUとサウンドカード(ここでは、PCIデバイス02：00.0とPCIデバイス02：00.1)を追加する。
# [Add New Virtual Hardware]画面左の[USB Host Device]を選択して、キーボードとマウスを追加する。
# VMに割り当てたばかりのグラフィックボードをディスプレイに接続し、[Begin Installation]ボタンを押下する。<br>全て正しく設定されていれば、そのディスプレイにVMが起動していることがわかる。
# Windows XPをインストール画面の手順に従ってインストールする。<br>インストール完了後、Windows XPのデバイスマネージャーを起動して、マウントされているvirtio-win-<バージョン名>.isoファイルから各種ドライバをインストールする。
<br><br>

== 仮想マシンの設定 ==
==== ゲストOSがopenSUSEの場合 ====
ゲストOSがopenSUSEの場合、/etc/default/grubファイルの<code>GRUB_CMDLINE_LINUX_DEFAULT</code>項目に、<code>pci=noaer</code>オプションを追記する。<br>
 GRUB_CMDLINE_LINUX_DEFAULT="... pci=noaer"
<br>
==== AMD CPUのパフォーマンスの改善 ====
以前、AMD CPUでは、Nested Page Tables(NPT)を無効化することでKVMのGPU性能を引き上げることができた。<br>
これは、バグが原因で、トレードオフとしてCPUの性能が落ちて、がたつきが発生することがあった。<br>
<br>
Linuxカーネル 4.9以降からこの問題を解決するカーネルパッチがマージされている。<br>
LinuxカーネルまたはLinux-LTSカーネルを使用している場合、パッチは既に適用されている。<br>
<br>
<u>※注意</u><br>
<u>QEMU 3.1以降、TOPOEXTフラグは標準で無効化されており、</u><br>
<u>AMD CPUでハイパースレッディングを使用するには、以下のように、手動で有効にする必要がある。</u><br>
<u>cache passthroughの設定は、実際のCPUキャッシュ情報を仮想マシンに渡す。</u><br>
 <syntaxhighlight lang="xml">
 <!-- ゲストOSがWindows 10 / 11またはSUSEの場合 -->
 <cpu mode="host-passthrough" check="none">
   <topology sockets="1" cores="4" threads="2"/>
   <cache mode="passthrough"/>
   <feature policy="require" name="topoext"/>
 </cpu>
 
 <!-- ゲストOSがWindows 7の場合 -->
 <cpu mode="host-passthrough" check="none">
   <topology sockets="1" cores="4" threads="2"/>
   <cache mode="passthrough"/>
   <feature policy='disable' name='hypervisor'/>
 </cpu>
 
 <!-- ゲストOSがWindows XPの場合 -->
 <cpu mode="host-passthrough" check='none'>
   <topology sockets='1' cores='2' threads='2'/>
   <feature policy='require' name='topoext'/>  <!-- ←この設定は不要の可能性あり -->
 </cpu>
 </syntaxhighlight>
<br>
更にパフォーマンスを向上させるため、<code><features></code>タグ内に<code><hyperv></code>タグとそのエレメントを設定する。<br>
 <syntaxhighlight lang="xml">
 <!-- ゲストOSがWindows 10 / 11の場合 -->
 <hyperv>
   <relaxed state="on"/>
   <vapic state="on"/>
   <spinlocks state="on" retries="8191"/>
   <vendor_id state="on" value="0123456789ab"/>
   <vpindex state="on"/>
   <synic state="on"/>
   <stimer state="on"/>
   <frequencies state="on"/>
 </hyperv>
 
 <!-- ゲストOSがopenSUSEの場合 -->
 <hyperv>
   <relaxed state='on'/>
   <vapic state='on'/>
   <spinlocks state='on' retries='8191'/>
   <vendor_id state='on' value='0123456789ab'/>
 </hyperv>
 
 <!-- ゲストOSがWindows 7の場合 -->
 <hyperv>
   <relaxed state='on'/>
   <vapic state='on'/>
   <spinlocks state='on' retries='8191'/>
   <vendor_id state='on' value='0123456789ab'/>
 </hyperv>
 
 <!-- ゲストOSがWindows XPの場合 -->
 <hyperv>
   <relaxed state='on'/>
   <vapic state='on'/>
   <spinlocks state='on' retries='8191'/>
   <vendor_id state='on' value='none'/>
 </hyperv>
 </syntaxhighlight>
<br>

==== GPUがNVIDIA Geforceの場合 (error code 43) ====
仮想マシンのデバイスマネージャでグラフィックボードを確認すると、"エラー43：ドライバーの読み込みに失敗しました"と表示されて、正常に機能しない場合がある。<br>
この問題は、NVidia GeForceシリーズのみ起こり(QuadroやTeslaにはこの問題は無い)、ユーザが仮想マシンでそれらを使用しようとすると、機能を意図的に無効化する。<br>
理由としては、仮想マシンでグラフィックカードを実行できるようになると、自社の製品の売上に悪影響を与える可能性があるからである。<br>
<br>
GeforceのGPUパススルーを正常に動作させるには、ハイパーバイザがその存在を隠すことで出来る。<br>
具体的な手順は以下の通りである。<br>
<br>
===== 手動での設定 =====
まず、KVMを開始する。<br>
 sudo systemctl start libvirtd
<br>
GPUパススルーを行う仮想マシンのxmlファイルを編集する。<br>
 sudo EDITOR=nano virsh edit <仮想マシン名>
<br>
<code><hyperv></code>タグ内に<code>vendor_id</code>タグを記述する。<br>
この時、<code>value</code>属性はどのような値でもよい。<br>
<span style="color:#C00000"><u>ただし、vendor_idタグの設定は、Quadro 2000以降のQuadroカードでは不要である。</u></span><br>
 <syntaxhighlight lang="xml">
 <features>
 
   ...略
 
   <hyperv>
 
     ...略
 
     <vendor_id state="on" value="123456789ab"/>
   </hyperv>
 
   ...略
 
 </features>
 </syntaxhighlight>
<br>
次に、状態を非表示にするようにKVMに指示するため、<code><hyperv></code>タグ外の直下に、<code>kvm</code>タグと<code>hidden</code>タグを記述する。<br>
<span style="color:#C00000"><u>ただし、hiddenタグの設定も、Quadro 2000以降のQuadroカードでは不要である。</u></span><br>
 <syntaxhighlight lang="xml">
 <features>
 
   ...略
 
   <hyperv>
 
     ...略

   </hyperv>
 
   ...略
 
   <kvm>
     <hidden state='on'/>
   </kvm>
 </features>
 </syntaxhighlight>
<br>
QEMU 4.0以降で仮想マシンにQ35チップセットを使用する場合、<code>features</code>タグ内に<code>ioapic</code>タグを記述する。<br>
 <syntaxhighlight lang="xml">
 <features>
 
 ...略
 
   <ioapic driver="kvm"/>
 </features>
 </syntaxhighlight>
<br>
最後に、KVMを再起動する。
 sudo systemctl restart libvirtd
<br>
===== 自動での設定 =====
GitHubにあるvirsh-patcherパッケージは、簡単に上記の方法を行うことができる。<br>
 git clone https://github.com/PassthroughPOST/virsh-patcher virsh-patcher
<br>
以下のコマンドを実行して修正を適用する。<br>
 sudo virshpatcher --error43 --vendor-id 123456789ab <仮想マシン名>
<br><br>

== Synergy または DeskFlow のインストール ==
ゲストOSのインストールが完了した後、Synergy (有償ソフトウェア)] または DeskFow、InputLeapをインストールすることを推奨する。<br>
これらは、物理的なKVM (Keyboard-Video-Mouse) スイッチなしで、複数のPCで同じキーボードとマウスを使用できる。<br>
<br>
SynergyおよびDeskFlowの概要およびインストール手順を知りたい場合は、[[インストール - マウス・キーボード共有ソフトウェア]]のページを参照すること。<br>
<br><br>

== エラー時の対処方法 ==
==== ネットワーク ====
VM起動時に下記のエラーが出力されて、VMが起動できないことがある。<br>
 ERROR    Requested operation is not valid: network 'default' is not active
<br>
まず、以下のコマンドを実行する。<br>
この時、以下のメッセージが出力された場合は、<code>sudo virsh net-start default</code>を実行する。<br>
今後、このネットワークを自動起動するには、<code>sudo virsh net-autostart --network default</code>を実行する。<br>
 # 実行
 sudo virsh net-list --all
 
 # 出力
 名前      状態       自動起動      永続
 ------------------------------------------------
 default   停止状態   いいえ (no)   はい (yes)
<br>
また、以下のようにネットワークが表示されない場合がある。<br>
 Name                 State      Autostart     Persistent
 ----------------------------------------------------------
 
<br>
その時は、/run/libvirt/network/default.xmlファイルを作成して、以下に示す内容を記述する。(デフォルトネットワークを作成する)<br>
<br>
 <syntaxhighlight lang="xml">
 <!-- /run/libvirt/network/default.xmlファイル -->
 
 <networkstatus>
    <class_id bitmap='0-2'/>
    <floor sum='0'/>
    <network>
       <name>default</name>
       <uuid>e8a9f86b-1c3a-4fa5-ab03-1fb563b12b84</uuid>
       <forward mode='nat'>
          <nat>
             <port start='1024' end='65535'/>
          </nat>
       </forward>
       <bridge name='virbr0' stp='on' delay='0'/>
       <mac address='52:54:00:a3:0d:b0'/>
       <ip address='192.168.122.1' netmask='255.255.255.0'>
          <dhcp>
             <range start='192.168.122.2' end='192.168.122.254'/>
          </dhcp>
       </ip>
    </network>
 </networkstatus>
 </syntaxhighlight>
<br>
次に、そのネットワークをKVMホストに永続的に追加するには、以下のコマンドを実行する。<br>
 sudo virsh net-define --file default.xml
<br>

==== ファイアーウォール ====
VM起動時に下記のエラーが出力されて、VMが起動できないことがある。<br>
 error: Failed to start network default
 error: internal error: Failed to initialize a valid firewall backend
<br>
この時、ファイアーウォールサービスをインストールする。<br>
 sudo zypper install firewalld
<br>
サービスを有効にして、ネットワークを再び機能させるために、次のコマンドを実行する。<br>
 sudo systemctl enable --now firewalld
 sudo systemctl restart libvirtd
<br>
==== DNSマスカレード ====
VM起動時に下記のエラーが出力されて、VMが起動できないことがある。<br>
 error: Failed to start network default
 error: Cannot check dnsmasq binary /usr/sbin/dnsmasq: No such file or directory
<br>
この時、DNSマスカレードをインストールする。<br>
 sudo zypper install dnsmasq
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]