Check Virtio Win and KVM Guest Agent (Windows)

release/20250320
- release/20250320
- release/20250116
English

Check Virtio Win and KVM Guest Agent (Windows)

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in VPC

If you have problems installing the agent or the service is not working properly, follow this guide to check and reinstall.

Check KVM Guest Agent

Note

To use the snapshot service in KVM environment, KVM Guest Agent must be installed.
This feature is only available for Windows VMs in a KVM environment. For more information on NTK, see Checking the Ncloud Tool Kit (Windows).

1. Check KVM Guest Agent

You can verify the KVM Guest Agent installation through these two methods.

Method 1: check QEMU Guest Agent installation in Add/Remove Programs menu
Method 2: Check via Windows NTK
Run C:\windows_ntk\windows_ntk.exe and VM Tool Status in the VM Tool tab

Example: When KVM Guest Agent is installed and service is running

# Get VM Tool Status
KVM Guest Agent is installed [Ok]

Example: When KVM Guest Agent is not installed or is abnormal

# Get VM Tool Status
KVM Guest Agent is not installed [Not Ok]

2. Reinstall KVM Guest Agent

You can reinstall the KVM Guest Agent via Windows NTK.

If you have run Diagnosis in VM Tool Status of VM Tool tab, click Repair to proceed with reinstallation.
If KVM Guest Agent is not installed or recognized as abnormal, reinstallation proceeds.
When installation is complete, the following message appears in Repair Result.
```
# Set VM Tool Status
KVM Guest Agent has been installed successfully
```

After installation, verify that the QEMU-GA service is running properly using the commands below.

PS C:\Users\Administrator\Desktop> Get-Service -Name QEMU-GA 

Status   Name               DisplayName                           
------   ----               -----------                           
Running  QEMU-GA            QEMU Guest Agent

3. Manual installation of KVM Guest Agent

If you want to manually install KVM Guest Agent or if reinstallation through Windows NTK fails, you can install manually as follows.

Download the installation file.
- Method 1: check and download KVM Guest Agent information through fedorapeople.org
- Method 2: download Guest Agent installation file through repo provided by NAVER Cloud Platform
```
# Download the latest version of 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"
```
Run the downloaded file to proceed with installation.

After installation, verify that the QEMU-GA service is running properly using the commands below.

PS C:\Users\Administrator\Desktop> Get-Service -Name QEMU-GA 

Status   Name               DisplayName                           
------   ----               -----------                           
Running  QEMU-GA            QEMU Guest Agent

Check Virtio Win Driver

Caution

When removing the Virtio Win Driver, be aware that the network is not recognized.
Network may be disconnected during Virtio Win Driver reinstallation.
Before proceeding, create My server image or snapshot for backup. For more information, see Server Image or Snapshot.

1. Check Virtio Win Driver

You can verify the Virtio Win Driver installation through these two methods.

Method 1: check Virtio-win-driver-installer installation in Add/Remove Programs menu
Method 2: Check via Windows NTK
Run C:\windows_ntk\windows_ntk.exe and VM Tool Status feature in the VM Tool tab

Example: Virtio Win Driver version 0.1.240 result

# Get VM Tool Status
Virtio-win-driver-installer : 0.1.240 is installed [Ok]

2. Download Virtio Win Driver files

To upgrade to a new version of Virtio Win Driver, you can download installation files through these two methods.

Method 1: check and download Virtio Win Driver information through fedorapeople.org
Method 2: download the Virtio Win Driver installation file through a repo on NAVER Cloud Platform

# Download the latest version of Virtio Win Driver
Start-BitsTransfer -Source "http://init.ncloud.com/windows/virtio/virtio-win-latest.msi" -Destination "c:\virtio-win-latest.msi"

3. Run Virtio Win Driver file

Run the downloaded file to proceed with installation.

Server reboot is required during installation. When the popup window appears for confirmation, click Yes only if you can reboot the server.
If reboot is not possible, click No and complete the driver installation by rebooting when possible.
Reboot popup may not appear depending on the version. Installation is complete only after rebooting.

4. Run routing rule script

Internal routing rules may disappear when reinstalling Virtio Win Driver. To set the inner routing rule again, download and run the following execution files.

# Download routing rule script
Start-BitsTransfer -Source "http://init.ncloud.com/windows/virtio/staticRoutekvm.exe" -Destination "c:\staticRoutekvm.exe"

Enter the route print command in CMD to verify that the routing rule for 169.254.0.0/16 is properly included in Persistent Routes and Active Routes.

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
===========================================================================

Was this article helpful?

What's Next

Server Status Check

Table of contents

Check KVM Guest Agent
Check Virtio Win Driver