KVM Guest Agent 점검(Linux)

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

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

• Linux NTK 실행
• 신규 KVM Guest Agent 설치
• KVM Guest Agent 상태 점검
• KVM Guest Agent 재설치
• KVM Guest Agent 기동 시 OS 내에 필요한 virtio-serial 장치가 없는 경우

Linux NTK 실행

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

1. VM이 호스팅되고 있는 하이퍼바이저가 KVM인지 확인해 주십시오.

   [root@lab-ntk ~]# dmesg | grep "Hypervisor detected" | awk -F': ' '{print $2}'
    KVM
   

2. NTK 파일이 위치한 경로로 이동해 주십시오.

   [root@lab-ntk ~]# cd /usr/local/etc
   

3. NTK 파일 압축을 해제해 주십시오.

   [root@lab-ntk etc]# tar zxvf ntk-kvm.tar.gz
   

4. NTK를 실행해 주십시오.

   [root@lab-ntk etc]# /usr/local/etc/ntk/ntk
   

신규 KVM Guest Agent 설치

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

1. VM에 KVM Guest Agent 설치 여부를 확인해 주십시오.
   설치되어 있지 않은 경우에는 다음 단계를 진행해 주시고, 설치되어 있는 경우에는 KVM Guest Agent 상태 점검 또는 KVM Guest Agent 재설치 가이드를 참조해 주십시오.

   # kvm guest agent 설치된 경우
   [root@lab-ntk ~]# systemctl list-unit-files | grep "qemu-guest-agent"
   qemu-guest-agent.service                  enabled
   
   # kvm guest agent 설치되지 않은 경우
   [root@lab-ntk ~]# systemctl list-unit-files | grep "qemu-guest-agent"
   [root@lab-ntk ~]#
   

2. (E) EXECUTE - << Run System Apps >> 를 선택해 주십시오.
   
3. (K) KVM GUEST AGENT - KVM AGENT INSTALL >> 을 선택해 주십시오.
   
4. Yes를 선택해 주십시오.
   
5. Enter를 클릭해 주십시오.
   • 재설치가 완료됩니다.

KVM Guest Agent 상태 점검

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

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

KVM Guest Agent 재설치

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

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

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

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