Virtio Win 및 KVM Guest Agent 점검(Windows)
    • PDF

    Virtio Win 및 KVM Guest Agent 점검(Windows)

    • PDF

    기사 요약

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

    에이전트 설치에 문제가 있거나 서비스가 정상적으로 동작하지 않는 경우, 아래 가이드에 따라 점검 및 재설치를 진행해 주십시오.
    주의
    • Virtio Win Driver 제거시 네트워크가 인식되지 않으므로, 주의해 주십시오.
    • Virtio Win Driver 재설치간 네트워크가 단절될 수 있습니다.
    • 작업 전 백업을 위해 먼저 Server Image 혹은 Snapshot 을 참조하여 내 서버 이미지 또는 스냅샷을 생성해 주십시오.

    Virtio Win Driver 점검

    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를 통해 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"
    

    3. Virtio Win Driver 파일 실행

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

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

    4. 라우팅룰 스크립트 실행

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

    # 라우팅룰 스크립트 다운로드
    Start-BitsTransfer -Source "http://init.gov-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
    ===========================================================================
    

    KVM Guest Agent 점검

    참고
    • KVM 환경에서 CB2 상품의 스냅샷 서비스를 이용하기 위해서는 KVM Guest Agent가 설치되어야 합니다.
    • 이 기능은 KVM 환경의 Windows VM에 한하여 제공됩니다. NTK와 관련하여 자세한 내용은 Ncloud Tool Kit 점검(Windows)를 참조해 주십시오.

    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 서비스가 정상 구동중인지 확인해 주십시오.
      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 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"
      
    2. 다운로드한 파일을 실행하여 설치를 진행해주십시오.
      • 설치 중 리부팅은 필요하지 않습니다.
    3. 설치 후 아래 명령어를 통해 QEMU-GA 서비스가 정상 구동중인지 확인해주십시오.
      PS C:\Users\Administrator\Desktop> Get-Service -Name QEMU-GA 
      
      Status   Name               DisplayName                           
      ------   ----               -----------                           
      Running  QEMU-GA            QEMU Guest Agent  

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.