Virtio Win と KVM Guest Agent の点検(Windows)

VPC環境で利用できます。

エージェントインストールに問題があるか、サービスが正常に動作しない場合、以下のガイドに従って点検および再インストールを行います。

KVM Guest Agentの点検

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が正常にインストールされました。

2. インストール後に以下のコマンドを通じて QEMU-GA サービスが正常に起動しているか確認します。

   PS C:\Users\Administrator\Desktop> Get-Service -Name QEMU-GA 
   
   Status   Name               DisplayName                           
   ------   ----               -----------                           
   Running  QEMU-GA            QEMU Guest Agent  
   

3. KVM Guest Agentの手動インストール

KVM Guest Agentの手動インストールをしたい場合や、Windows NTKを通じた再インストールに失敗した場合、以下のように手動でインストールできます。

1. インストールファイルをダウンロードします。

   • 方法1: fedorapeople.orgを通じて KVM Guest Agen情報確認およびダウンロード
   • 方法2: NAVERクラウドプラットフォームで提供する repoを通じて Guest Agentインストールファイルをダウンロード

   # 最新バージョンの 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"
   

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の点検

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を通じて 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
===========================================================================