KVM Guest Agent 점검(Linux)

Prev Next

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

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

참고

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

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

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

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
    Bash
  • 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
    Bash

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"
$
    Bash
  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 서비스의 상태를 점검합니다.

  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를 삭제하고 재설치를 진행하는 방법은 다음과 같습니다.

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

아니요, 동일한 Agent입니다. 해당 Agent는 NAVER Cloud Platform에서 자체적으로 개발한 것이 아니라, OS 벤더에서 빌드하여 OS 패키지로 제공하는 것입니다. NAVER Cloud Platform에서는 해당 Agent의 기능을 활용하여 스토리지의 일부 상품에서 사용하고 있습니다. 현재는 고객 편의를 위해서 KVM 환경의 BaseOS 이미지에 포함되어서 제공하고 있습니다.

OS 자체 기능에는 문제가 없지만, NAVER Cloud Platform에서 제공하는 일부 스토리지 상품과 연동되어 사용됩니다. 원본 서버와 내 서버 이미지/스냅샷 간의 시점 일치를 위해 KVM(QEMU) Guest Agent가 필요하며, 해당 Agent가 실행되지 않으면 내 서버 이미지 생성 버튼이 비활성화됩니다.

  • VM 실행 상태
    KVM(QEMU) Guest Agent가 실행되지 않으면 원본 서버와 내 서버 이미지/스냅샷 간의 시점 일치를 보장할 수 없습니다. 따라서, 원활한 운영을 위해 KVM(QEMU) Guest Agent의 설치 및 활성화를 권고드립니다.

  • VM 정지 상태
    VM이 정지된 상태에서는 KVM(QEMU) Guest Agent의 설치 여부와 관계 없이 내 서버 이미지 및 스토리지 스냅샷을 생성할 수 있습니다.

NAVER Cloud Platform에서는 KVM(QEMU) Guest Agent와 관련된 세부적인 기술 지원을 제공하지 않습니다.
KVM(QEMU) Guest Agent는 가상화 환경 내에서 운영체제와 하이퍼바이저 간의 통신을 돕는 도구로, 이와 관련된 문제 해결은 OS 제공 업체에서 지원을 받아야 합니다. NAVER Cloud Platform에서는 가상 머신의 인프라 및 기본적인 운영 환경에 대한 지원을 제공하고 있습니다. KVM(QEMU) Guest Agent의 구체적인 설정이나 문제 해결에 대해서는 사용 중인 OS 제공 업체(CentOS, Rocky Linux, Ubuntu 등)의 공식 문서나 지원 팀에 문의해 주시기 바랍니다.