Proxmox VE : Qemu Guest Agent 사용하기

QEMU Guest Agent는 Proxmox에서 가상 머신(VM)을 더 효율적으로 관리하고 더 나은 사용자 경험을 제공하기 위해 설치하는 중요한 도구입니다.

1. QEMU Guest Agent 설치가 필요한 이유
2. QEMU Guest Agent 설치 방법(on Ubuntu)

1. QEMU Guest Agent 설치가 필요한 이유

QEMU Guest Agent는 호스트(Proxmox)와 게스트(VM) 운영 체제 간의 통신을 활성화합니다. 이를 통해 다음과 같은 기능을 사용할 수 있습니다.

• 정상적인 종료 및 재시작:
  Proxmox 웹 인터페이스에서 VM을 Shutdown하거나 Reboot 명령을 사용하면, 게스트 에이전트가 설치된 VM은 OS에 정상적인 종료 또는 재시작 명령을 보냅니다. 이는 파일 시스템 손상을 방지하고, 마치 물리적인 컴퓨터의 전원 버튼을 누르는 대신 ‘시작’ 메뉴에서 종료를 누르는 것과 같습니다. 에이전트가 없으면, Shutdown 명령은 단순히 전원을 차단하는 것과 같아 데이터 손실 위험이 있습니다.
• IP 주소 정보 표시:
  게스트 에이전트가 설치되면 Proxmox 웹 인터페이스의 “VM 요약 페이지”에 해당 VM의 IP 주소가 표시됩니다. 이는 네트워크 관리에 매우 유용합니다. 아래는 QEMU Guest Agent를 설치하기 전의 “VM 요약 페이지”입니다. IP정보가 없습니다.
  
• 백업 안정성 향상:
  게스트 에이전트가 실행 중일 때 Snapshot이나 Backup을 수행하면, 에이전트가 게스트 OS의 파일 시스템을 일시적으로 정지시켜 일관성 있는 백업을 생성할 수 있습니다. 이는 특히 데이터베이스 서버와 같이 동적으로 데이터가 변경되는 VM에 중요합니다.

2. QEMU Guest Agent 설치 방법(on Ubuntu)

1. VM의 터미널에 접속하여 qemu-guest-agent를 설치합니다.

   archer@kubemanager:~$ sudo apt update
   archer@kubemanager:~$ sudo apt install qemu-guest-agent -y
   (생략)
   archer@kubemanager:~$ systemctl status qemu-guest-agent
   ○ qemu-guest-agent.service - QEMU Guest Agent
        Loaded: loaded (/usr/lib/systemd/system/qemu-guest-agent.service; static)
        Active: inactive (dead)
   

2. VM 웹 관리화면 > Options > QEMU Guest Agent를 더블 클릭하여 QEMU Guest Agent 사용을 활성화합니다.
   
3. VM을 재시작하면 “VM 요약 페이지”에 해당 VM의 IP 주소가 표시되며, qemu-guest-agent 서비스도 active (running)됩니다.
   

   archer@kubemanager:~$ systemctl status qemu-guest-agent
   ● qemu-guest-agent.service - QEMU Guest Agent
        Loaded: loaded (/usr/lib/systemd/system/qemu-guest-agent.service; static)
        Active: active (running) since Fri 2025-09-19 15:10:09 KST; 2min 39s ago
      Main PID: 697 (qemu-ga)
         Tasks: 2 (limit: 9435)
        Memory: 1.6M (peak: 1.9M)
           CPU: 184ms
        CGroup: /system.slice/qemu-guest-agent.service
                └─697 /usr/sbin/qemu-ga
   
   Sep 19 15:11:00 kubemanager qemu-ga[697]: info: guest-ping called