Virtio Win 및 KVM Guest Agent 점검(Windows)

Prev Next

VPC 환경에서 이용 가능합니다.

에이전트 설치에 문제가 있거나 서비스가 정상적으로 동작하지 않는 경우, 아래 가이드에 따라 점검 및 재설치를 진행해 주십시오.
참고
  • KVM 환경에서 CB2 상품의 스냅샷 서비스를 이용하기 위해서는 KVM Guest Agent가 설치되어야 합니다.
  • 이 기능은 KVM 환경의 Windows VM에 한하여 제공됩니다. NTK와 관련하여 자세한 내용은 Ncloud Tool Kit 점검(Windows)을 참조해 주십시오.

아래 두 가지 방법을 통해 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]
Plain text

<예시> KVM Guest Agent가 설치되어 있지 않거나 비정상인 경우

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

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가 정상적으로 설치되었습니다
    Plain text
  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
    PowerShell

KVM Guest Agent 수동 설치를 원하시거나 Windows NTK를 통한 재설치가 실패하였다면, 아래와 같이 수동으로 설치할 수 있습니다.

  1. 설치 파일을 다운로드해 주십시오.
    • 방법 1: fedorapeople.org를 통해 KVM Guest Agent 정보 확인 및 다운로드
    • 방법 2: 네이버 클라우드 플랫폼에서 제공하는 repo를 통해 Guest Agent 설치 파일 다운로드
    # 최신 버전의 KVM Guest Agent 다운로드
Start-BitsTransfer -Source "http://init.gov-ncloud.com/windows/virtio/qemu-ga-x86_64-latest.msi" -Destination "c:\qemu-ga-x86_64-latest.msi"
    PowerShell
  2. 다운로드한 파일을 실행하여 설치를 진행해주십시오.
  3. 설치 후 아래 명령어를 통해 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
    PowerShell
주의
  • Virtio Win Driver 제거시 네트워크가 인식되지 않으므로, 주의해 주십시오.
  • Virtio Win Driver 재설치간 네트워크가 단절될 수 있습니다.
  • 작업 전 백업을 위해 먼저 Server Image 혹은 Snapshot 을 참조하여 내 서버 이미지 또는 스냅샷을 생성해 주십시오.

아래 두 가지 방법을 통해 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]
Plain text

Virtio Win Driver를 신규 버전으로 업그레이드 하고 싶다면, 아래 두 가지 방법을 통해 설치 파일을 다운로드할 수 있습니다.

  • 방법 1: fedorapeople.org를 통해 Virtio Win Driver 정보 확인 및 다운로드
  • 방법 2: 네이버 클라우드 플랫폼에서 제공하는 repo를 통해 Virtio Win Driver 설치 파일 다운로드
# 최신 버전의 Virtio Win Driver 다운로드
Start-BitsTransfer -Source "http://init.gov-ncloud.com/windows/virtio/virtio-win-latest.msi" -Destination "c:\virtio-win-latest.msi"
PowerShell

다운로드한 파일을 실행하여 설치를 진행해 주십시오.

  • 설치 중 서버 리부팅이 필요합니다. 리부팅 진행 여부를 확인하는 팝업 창이 나타나면, 서버 리부팅이 가능한 상황에서만 Yes를 클릭해 주십시오.
  • 리부팅이 불가능한 상황이라면 No를 클릭 후, 리부팅이 가능한 시점에 리부팅을 수행하여 driver 설치를 완료해 주십시오.
  • 버전에 따라 리부팅 팝업이 발생하지 않을 수 있습니다. 설치가 완료된 후 리부팅까지 진행해야 설치가 정상적으로 완료됩니다.

Virtio Win Driver를 재설치 하면 내부 라우팅룰이 사라지는 경우가 있습니다. 내부 라우팅룰을 다시 설정하려면 다음의 실행 파일을 다운로드 후 실행해 주십시오.

# 라우팅룰 스크립트 다운로드
Start-BitsTransfer -Source "http://init.gov-ncloud.com/windows/virtio/staticRoutekvm.exe" -Destination "c:\staticRoutekvm.exe"
PowerShell

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