--- title: "Virtio Win 및 KVM Guest Agent 점검(Windows)" slug: "server-ts-kvm-win-vpc" updated: 2026-09-17T09:07:32Z published: 2026-09-17T09:07:32Z 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/server-ts-ntk-win-vpc)를 참조해 주십시오. ### 1. KVM Guest Agent 점검 아래 두 가지 방법을 통해 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**, **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 Agent 정보 확인 및 다운로드 - 방법 2: 네이버 클라우드 플랫폼에서 제공하는 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/server-serverimage-vpc) 혹은 [Snapshot](/docs/server-snapshot-create-vpc) 을 참조하여 내 서버 이미지 또는 스냅샷을 생성해 주십시오. ### 1. Virtio Win Driver 점검 아래 두 가지 방법을 통해 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를 신규 버전으로 업그레이드 하고 싶다면, 아래 두 가지 방법을 통해 설치 파일을 다운로드할 수 있습니다. - 방법 1: [fedorapeople.org](https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/)를 통해 Virtio Win Driver 정보 확인 및 다운로드 - 방법 2: 네이버 클라우드 플랫폼에서 제공하는 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 =========================================================================== ```