KVM Guest Agent 점검(Linux)
    • PDF

    KVM Guest Agent 점검(Linux)

    • PDF

    기사 요약

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

    KVM 환경에서 CB2 상품의 스냅샷 서비스를 이용하기 위해서는 KVM Guest Agent가 설치되어야 합니다. 에이전트 설치에 문제가 있거나 서비스가 정상적으로 동작하지 않는 경우, NTK (Ncloud Tool Kit)를 사용하여 점검 및 재설치할 수 있습니다.

    참고

    이 기능은 KVM 환경의 Linux VM에 한하여 제공됩니다. NTK와 관련하여 자세한 내용은 Ncloud Tool Kit (Linux)을 참조해 주십시오.

    Linux NTK 실행

    Linux 서버에서 NTK를 실행하는 방법은 다음과 같습니다.

    1. VM이 호스팅되고 있는 하이퍼바이저가 KVM인지 확인해 주십시오.
       $ dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
       KVM
      
    2. NTK 파일이 위치한 경로로 이동해 주십시오.
      $ cd /usr/local/etc
      
    3. NTK 파일 압축을 해제해 주십시오.
      $ tar zxvf ntk-kvm.tar.gz
      
    4. NTK를 실행해 주십시오.
      $ /usr/local/etc/ntk/ntk
      

    KVM Guest Agent 버전 권고사항

    KVM 환경에서 스토리지 상품의 원활한 사용을 위해서 네이버클라우드에서는 KVM Guest Agent 버전을 6.2.0 이상으로 설치할 것을 권고합니다. KVM Guest Agent 버전 업그레이드가 필요한 OS는 현재 CentOS 7과 Ubuntu 20.04입니다.
    KVM Guest Agent가 설치되지 않고 제공된 일부 OS가 있어서 신규 KVM Guest Agent 설치 에서 확인 부탁드립니다.

    아래와 같이 현재 설치된 KVM Guest Agent 버전을 확인할 수 있습니다.

    • CentOS 7
      # 아래와 같이 아무것도 출력이 되지 않는다면 "신규 KVM Guest Agent 설치"를 참고 부탁드립니다.
      $ rpm -qa | grep qemu-guest-agent
      $
      또는
      $ /usr/bin/qemug-ga -V
      -bash: /usr/bin/qemug-ga: No such file or directory
      
      # 아래와 같이 2.12.0 이 나오면 "KVM Guest Agent 재설치"를 참고 부탁드립니다.
      $ rpm -qa | grep qemu-guest-agent
      qemu-guest-agent-2.12.0-3.el7.x86_64
      또는
      $ /usr/bin/qemu-ga -V
      QEMU Guest Agent 2.12.0
      
      # 아래와 같이 6.2.0 이 나오면 이미 업그레이드된 상태로 재설치가 필요하지 않습니다.
      $ rpm -qa | grep qemu-guest-agent
      qemu-guest-agent-6.2.0-0.el7.x86_64
      또는
      $ /usr/bin/qemu-ga -V
      QEMU Guest Agent 6.2.0
      
    • Ubuntu 20.04
      # 아래와 같이 아무것도 출력이 되지 않는다면 "신규 KVM Guest Agent 설치"를 참고 부탁드립니다.
      $ dpkg -l qemu-guest-agent
      dpkg-query: no packages found matching qemu-guest-agent
      또는
      $ /usr/sbin/qemu-ga -V
      -bash: /usr/sbin/qemu-ga: No such file or directory
      
      
      # 아래와 같이 4.2.0 이 나오면 "KVM Guest Agent 재설치"를 참고 부탁드립니다.
      $ dpkg -l qemu-guest-agent
      ||/ Name             Version           Architecture Description
      +++-================-=================-============-=================================
      ii  qemu-guest-agent 1:4.2-3ubuntu6.30 amd64        Guest-side qemu-system agent
      또는
      $ /usr/sbin/qemu-ga -V
      QEMU Guest Agent 4.2.1
      
      
      # 아래와 같이 6.2.0 이 나오면 이미 업그레이드된 상태로 재설치가 필요하지 않습니다.
      $ dpkg -l qemu-guest-agent
      ||/ Name             Version      Architecture Description
      +++-================-============-============-==================================================
      ii  qemu-guest-agent 6.2-ubuntu20 amd64        Guest-side qemu-system agent v6.2 for Ubuntu 20.04
      또는
      $ /usr/sbin/qemu-ga -V
      QEMU Guest Agent 6.2.0
      

    신규 KVM Guest Agent 설치

    KVM Guest Agent가 VM 내에 존재하지 않는 경우, 새로운 Agent를 설치합니다.

    1. VM에 KVM Guest Agent 설치 여부를 확인해 주십시오.
      설치되어 있지 않은 경우에는 다음 단계를 진행해 주시고, 설치되어 있는 경우에는 KVM Guest Agent 상태 점검 또는 KVM Guest Agent 재설치 가이드를 참조해 주십시오.
      # kvm guest agent 설치된 경우
      $ systemctl list-unit-files | grep "qemu-guest-agent"
      qemu-guest-agent.service                  enabled
      
      # kvm guest agent 설치되지 않은 경우
      $ systemctl list-unit-files | grep "qemu-guest-agent"
      $
      
    2. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
      kvm-guest-agent-ntk-linux01
    3. (K) KVM GUEST AGENT - KVM AGENT INSTALL >> 을 선택해 주십시오.
      kvm-guest-agent-ntk-linux02
    4. Yes를 선택해 주십시오.
      kvm-guest-agent-ntk-linux03
    5. Enter를 클릭해 주십시오.
      • 재설치가 완료됩니다.

    KVM Guest Agent 상태 점검

    KVM Guest Agent 서비스의 상태를 점검합니다.

    1. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
      kvm-guest-agent-ntk-linux01
    2. (K) KVM GUEST AGENT - KVM AGENT INSTALL >> 을 선택해 주십시오.
      kvm-guest-agent-ntk-linux02
    3. (R) RE-INSTALL KVM GUEST AGENT >> 를 선택해 주십시오.
      kvm-guest-agent-ntk-linux04
    4. KVM Guest Agent 서비스가 active 상태인지 확인해 주십시오.
      kvm-guest-agent-ntk-linux05

    KVM Guest Agent 재설치

    기존에 설치된 KVM Guest Agent를 삭제하고 재설치를 진행하는 방법은 다음과 같습니다.

    1. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
      kvm-guest-agent-ntk-linux01
    2. (K) KVM GUEST AGENT - KVM AGENT INSTALL >> 을 선택해 주십시오.
      kvm-guest-agent-ntk-linux02
    3. (R) RE-INSTALL KVM GUEST AGENT >> 를 선택해 주십시오.
      kvm-guest-agent-ntk-linux08
    4. Yes 를 선택해 주십시오.
      kvm-guest-agent-ntk-linux03
    5. 정상적으로 설치가 진행되는 경우, 아래와 같이 재설치 수행 로그가 출력됩니다.
      • 기존에 설치된 Guest Agent 정지
      • 기존에 설지된 Geust Agent 삭제
      • 패키지 정보 업데이트
      • Guest Agent 재설치
        kvm-guest-agent-ntk-linux06
    6. Enter를 클릭해 주십시오.
      • 재설치가 완료됩니다.

    KVM Guest Agent 기동 시 OS 내에 필요한 virtio-serial 장치가 없는 경우

    KVM Guest Agent를 기동할 때 NTK에서 아래와 같은 메시지가 표시되면, OS 내에 필요한 virtio-serial 장치가 존재하지 않아 발생한 문제입니다.
    VM을 재시작할 수 있는 시점에 리부팅이 아닌 정지 후 다시 시작해 주십시오.
    kvm-guest-agent-ntk-linux07


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

    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.