--- title: "Virtio Win と KVM Guest Agent の点検(Windows)" slug: "server-ts-kvm-win-vpc" updated: 2026-09-17T09:29:55Z published: 2026-09-17T09:29:55Z canonical: "guide.ncloud-docs.com/server-ts-kvm-win-vpc" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Virtio Win と KVM Guest Agent の点検(Windows) VPC環境で利用できます。 エージェントインストールに問題があるか、サービスが正常に動作しない場合、以下のガイドに従って点検および再インストールを行います。 ## KVM Guest Agentの点検 参考 - KVM環境でスナップショットサービスを利用するためには、KVM Guest Agentをインストールする必要があります。 - この機能は KVM環境の Windows VMに限って提供されます。NTKの詳細は、[Ncloud Tool Kit 点検(Windows)](/docs/ja/server-ts-ntk-win-vpc)をご参照ください。 ### 1. KVM Guest Agentの点検 以下の2つの方法で KVM Guest Agentがインストールされているか確認できます。 - 方法1: プログラムの追加/削除メニューで *QEMU Guest Agent* のインストールを確認 - 方法2: Windows NTKを通じて確認 `C:\windows_ntk\windows_ntk.exe` 実行後、 **VM Tool** タブの **VM Tool Status** を通じて確認 **例)** KVM Guest Agentがインストールされており、サービスが実行中の場合 ``` # Get VM Tool Status KVM Guest Agent is installed [Ok] ``` **例)** KVM Guest Agentがインストールされていないか、正常でない場合 ``` # Get VM Tool Status KVM Guest Agent is not installed [Not Ok] ``` ### 2. KVM Guest Agentの再インストール Windows NTKを通じて KVM Guest Agentを再インストールできます。 1. **VM Tool** タブの **VM Tool Status** を選択して **Diagnosis** を完了したら、**Repair** ボタンをクリックして再インストールを行います。 KVM Guest Agentがインストールされていないか、正常でないと認識されると、KVM Guest Agent再インストールを実行します。 インストールが完了したら、Repair Resultに以下のように文が表示されます。 ``` # Set VM Tool Status KVM Guest Agentが正常にインストールされました。 ``` 1. インストール後に以下のコマンドを通じて **QEMU-GA** 、**QEMU Guest Agent VSS Provider** サービスが作成されたか、**QEMU-GA** サービスが正常に起動しているか確認します。 ``` PS C:\Users\Administrator\Desktop> Get-Service -Name 'QEMU-GA','QEMU Guest Agent VSS Provider' Status Name DisplayName ------ ---- ----------- Stopped QEMU Guest Agen... QEMU Guest Agent VSS Provider Running QEMU-GA QEMU Guest Agent ``` ### 3. KVM Guest Agentの手動インストール KVM Guest Agentの手動インストールをしたい場合や、Windows NTKを通じた再インストールに失敗した場合、以下のように手動でインストールできます。 1. インストールファイルをダウンロードします。 ``` # 最新バージョンの KVM Guest Agentをダウンロード Start-BitsTransfer -Source "http://init.ncloud.com/windows/virtio/qemu-ga-x86_64-latest.msi" -Destination "c:\qemu-ga-x86_64-latest.msi" ``` - 方法1: [fedorapeople.org](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-qemu-ga/)を通じて KVM Guest Agen情報確認およびダウンロード - 方法2: NAVERクラウドプラットフォームで提供する repoを通じて Guest Agentインストールファイルをダウンロード 2. ダウンロードしたファイルを実行してインストールします。 3. インストール後に以下のコマンドを通じて **QEMU-GA** サービスが正常に起動しているか確認します。 ``` PS C:\Users\Administrator\Desktop> Get-Service -Name QEMU-GA Status Name DisplayName ------ ---- ----------- Running QEMU-GA QEMU Guest Agent ``` ## Virtio Win Driverの点検 注意 - Virtio Win Driver削除時にネットワークが認識されませんので、ご注意ください。 - Virtio Win Driver再インストール間にネットワークが切断されることがあります。 - タスク前にバックアップのため、まず [Server Image](/docs/ja/server-serverimage-vpc)または [Snapshot](/docs/ja/server-snapshot-create-vpc)を参照してマイサーバイメージまたはスナップショットを作成します。 ### 1. Virtio Win Driverの点検 以下の2つの方法で Virtio Win Driverがインストールされているか確認できます。 - 方法1: プログラムの追加/削除メニューで *Virtio-win-driver-installer* のインストールを確認 - 方法2: Windows NTKを通じて確認 `C:\windows_ntk\windows_ntk.exe` 実行後、 **VM Toolタブ** の **VM Tool Status** 機能を通じてインストールを確認 **例)** Virtio Win Driver 0.1.240バージョンの結果 ``` # Get VM Tool Status Virtio-win-driver-installer : 0.1.240 is installed [Ok] ``` ### 2. Virtio Win Driverファイルのダウンロード 新規バージョインに Virtio Win Driverをアップグレードした場合、以下の2つの方法でインストールファイルをダウンロードできます。 - 方法1: [fedorapeople.org](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/)を通じて Virtio Win Driver情報確認およびダウンロード - 方法2: NAVERクラウドプラットフォームで提供する repoを通じて Virtio Win Driverインストールファイルをダウンロード ``` # 最新バージョンの Virtio Win Driverをダウンロード Start-BitsTransfer -Source "http://init.ncloud.com/windows/virtio/virtio-win-latest.msi" -Destination "c:\virtio-win-latest.msi" ``` ### 3. Virtio Win Driverファイルの実行 ダウンロードしたファイルを実行してインストールします。 - インストール中にサーバの再起動が必要です。再起動の実行有無を確認するポップアップが表示されたら、サーバの再起動が可能な状況でのみ **Yes** をクリックします。 - 再起動ができない状況の場合は **No** をクリックした後、再起動できるタイミングに再起動を実行して driverインストールを完了します。 - バージョンに応じて再起動ポップアップが表示されない場合があります。インストールが完了した後、再起動まで行うとインストールが正常に完了したことになります。 ### 4. ルーティングルールスクリプトの実行 Virtio Win Driverを再インストールすると、内部ルーティングルールが消える場合があります。内部ルーティングルールを再設定するには、以下の実行ファイルをダウンロードして実行します。 ``` # ルーティングルールスクリプトのダウンロード Start-BitsTransfer -Source "http://init.ncloud.com/windows/virtio/staticRoutekvm.exe" -Destination "c:\staticRoutekvm.exe" ``` CMDで `route print` コマンドを入力して Persistent Routesおよび Active Routesに**169.254.0.0/16** に対するルーティングルールが正常に入っているか確認します。 ``` C:\Users\Administrator> route print =========================================================================== Interface List 22...f2 20 af 08 ee bf ......Red Hat VirtIO Ethernet Adapter #2 26...f2 20 af a5 66 a1 ......Red Hat VirtIO Ethernet Adapter #3 1...........................Software Loopback Interface 1 =========================================================================== IPv4 Route Table =========================================================================== Active Routes: Network Destination Netmask Gateway Interface Metric 0.0.0.0 0.0.0.0 10.0.1.1 10.0.1.8 15 10.0.1.0 255.255.255.0 On-link 10.0.1.8 271 10.0.1.8 255.255.255.255 On-link 10.0.1.8 271 10.0.1.255 255.255.255.255 On-link 10.0.1.8 271 10.0.4.0 255.255.255.0 On-link 10.0.4.9 271 10.0.4.9 255.255.255.255 On-link 10.0.4.9 271 10.0.4.255 255.255.255.255 On-link 10.0.4.9 271 127.0.0.0 255.0.0.0 On-link 127.0.0.1 331 127.0.0.1 255.255.255.255 On-link 127.0.0.1 331 127.255.255.255 255.255.255.255 On-link 127.0.0.1 331 169.254.0.0 255.255.0.0 10.0.1.1 10.0.1.8 271 224.0.0.0 240.0.0.0 On-link 127.0.0.1 331 224.0.0.0 240.0.0.0 On-link 10.0.4.9 271 224.0.0.0 240.0.0.0 On-link 10.0.1.8 271 255.255.255.255 255.255.255.255 On-link 127.0.0.1 331 255.255.255.255 255.255.255.255 On-link 10.0.4.9 271 255.255.255.255 255.255.255.255 On-link 10.0.1.8 271 =========================================================================== Persistent Routes: Network Address Netmask Gateway Address Metric 169.254.0.0 255.255.0.0 10.0.1.1 Default =========================================================================== ```